5.4.13. PS2Mouse component

The PS2Mouse component implements the PS/2 register interface of a PS/2 style mouse. The mouse movement and button press data must be provided from another component such as the Visualisation component.

Figure 5.34 shows a view of the component in System Canvas.

Figure 5.34. PS2Mouse component in System Canvas

PS2Mouse component in System Canvas

This component is written in LISA+.

Ports

Table 5.52 provides a brief description of the ports in the PS2Mouse component. See the RealView Emulation Baseboard User Guide (Lead Free).

Table 5.52. PS2Mouse ports

NamePort protocolTypeDescription
mouseMouseStatus[a]SlaveReceives keyboard input from, for example, the Visualisation component.
clk_inClockSignalSlaveDrives the PS/2 clocking rate, typically 1MHz.
ps2PS2DataMasterConnection to the PS/2 controller, for example the PL050_KMI.

[a] The MouseStatus protocol is documented in Visualisation Library.


MouseStatus

The PS2Mouse component has one additional protocol.

The MouseStatus protocol is used to pass mouse movement and button events to another component such as the PS2Mouse component. Events are only sent when the visualization window is in focus.

The protocol behaviors are:

mouseMove(int dx, int dy) : void

This is sent when the host mouse is moved. Mouse movement events are always relative.

mouseButton(uint8_t button, bool down) : void

This is sent when a button on the host mouse is pressed or released.

button indicates which button has been pressed or released and is typically 0,1 or 2 but can be anything up to 7 depending on the OS and attached mouse.

down is true if a button is pressed and false if released.

Parameters

The PS2Mouse component has no parameters.

Registers

The PS2Mouse component has no registers.

Debug features

The PS2Mouse component has no debug features.

Verification and testing

The PS2Mouse component has been tested as part of the VE example system using VE test suites and by booting operating systems.

Performance

The PS2Mouse component is not expected to significantly affect the performance of a PV system. However if it is connected to the Visualisation component, then the performance of the component is dependent on that of the visualization.

Library dependencies

The PS2Mouse component has no dependencies on external libraries.

Copyright © 2008-2013 ARM. All rights reserved.ARM DUI 0423O
Non-ConfidentialID060613