For both RealView Debugger and Model Debugger, the CLCD window
is displayed when the RTSM starts. The window title is Real-Time
System Model CLCD.
This window represents the contents of the simulated color LCD framebuffer. It automatically resizes to match the horizontal and vertical resolution set in the CLCD peripheral registers. For more information on the CLCD model components and other peripherals, see the Fast Model Portfolio Reference Manual.
Figure A.6 shows the EB RTSM CLCD window immediately after being started. This is the default state.
The top section of the CLCD window displays the following status information:
- USERSW
Eight white boxes show the state of the EB User DIP switches:
These represent switch S6 on the EB hardware, USERSW[8:1], that is mapped to bits [7:0] of the SYS_SW register at address
0x10000004.The switches are in the off position by default. Click in the area above or below a white box to change its state.
- BOOTSW
Eight white boxes showing the state of the EB Boot DIP switches.
These represent switch S8 on the EB hardware, BOOTSEL[8:1], that is mapped to bits [15:8] of the SYS_SW register at address
0x100000004.The switches are in the off position by default.
Note
ARM recommends you configure the Boot DIP switches using the
boot_switchmodel parameter rather than by using the CLCD interface.Changing Boot DIP switch positions while the model is running can result in unpredictable behavior.
- S6LED
Eight colored boxes indicate the state of the EB User LEDs.
These represent LEDs D[21:14] on the EB hardware, that are mapped to bits [7:0] of the SYS_LED register at address
0x10000008. The boxes correspond to the red/yellow/green LEDs on the EB hardware.- Total Instr
A counter showing the total number of instructions executed.
Because the system model models provide a programmer’s view of the system, the CLCD displays total instructions rather than total core cycles. Timing might differ substantially from the hardware because:
the bus fabric is simplified
memory latencies are minimized
cycle approximate core and peripheral models are used.
In general bus transaction timing is consistent with the hardware, but timing of operations within the model is not accurate.
- Total Time
A counter showing the total elapsed time, in seconds.
This is wall clock time, not simulated time.
- Rate Limit
A feature that disables or enables fast simulation.
Because the system model is highly optimized, your code might run faster than it would on real hardware. This might cause timing issues.
If Rate Limit is enabled, the default, simulation time is restricted so that it more closely matches real time.
Click on the square button to disable or enable Rate Limit. The text changes from ON to OFF and the colored box becomes darker when Rate Limit is disabled. Figure A.6 shows the CLCD with Rate Limit disabled.
Note
You can control whether Rate Limit is enabled by using the
rate_limit-enableparameter when instantiating the model.
If you click on the Total Instr or Total Time items in the CLCD, the display changes to show two different items as shown in Figure A.7. You can click on the items again to toggle between the original and alternative displays.
- Instr/sec
Shows the number of instructions executed per second of wall clock time.
- Perf Index
The ratio of real time to simulation time. The larger the ratio, the faster the simulation runs. If you enable the Rate Limit feature, the Perf Index approaches unity.
You can reset the simulation counters by resetting the model.
If the CLCD window has focus:
keyboard input is translated to PS/2 keyboard data.
mouse activity over the window is translated into PS/2 relative mouse motion data. This is then streamed to the KMI peripheral model FIFOs.
Note
The simulator only sends relative mouse motion events to the model. As a result, the host mouse pointer does not necessarily align with the target OS mouse pointer.
On Windows, you can hide the host mouse pointer by pressing the left Ctrl+Windows keys. Press the keys again to redisplay the host mouse pointer. Only the Left Ctrl key is operational and the Ctrl key on the right of the keyboard does not have the same effect.
If you do not have a Windows key, or
prefer to use a different key, use the trap_key configuration
option. Refer to the CADI parameter documentation for details in
the Fast Model Portfolio Reference Manual.
PDF version