HID Mouse Application

This example requires one of the following SoftDevices: S112, S132, S140

Important: Before you run this example, make sure to program the SoftDevice.

All provided HID examples conform with USB HID usage tables, http://www.usb.org/developers/hidpage.

The HID Mouse Application is an example that implements the HID over GATT profile for mouse using the hardware delivered in the nRF5 Development Kit.

The application includes the three mandatory services needed for the HID over GATT profile:

• Human Interface Device Service
• Device Information Service
• Battery Service

Note

This application is not power optimized!

The application will stop advertising and go to system-off mode after 3 minutes and 30 seconds(if no advertising with whitelist was done) or after 4 minutes (if advertising with whitelist was done).

Push Button 1 to restart advertising.

Setup

You can find the source code and the project file of the example in the following folder: <InstallFolder>\examples\ble_peripheral\ble_app_hids_mouse

Button assignments - in addition to those defined in BSP BLE Button Assignments:

• During Connection:
  • Button 1: Move mouse pointer 5 pixels to the left
  • Button 2: Move mouse pointer 5 pixels upward
  • Button 3: Move mouse pointer 5 pixels to the right
  • Button 4: Move mouse pointer 5 pixels downward

Testing

The HID Mouse Application should be connected to a Microsoft Windows 8 computer with a Bluetooth radio. When connected, the application will act as a mouse, enabling the user to move the computer's mouse pointer using four push buttons on the board:

1. Compile and program the application. Observe that the BSP_INDICATE_ADVERTISING state is indicated.
2. On the Windows 8 computer, search for Bluetooth devices, and connect to the device named 'Nordic_Mouse'. Observe that the BSP_INDICATE_CONNECTED state is indicated.
3. Push Button 1 on the board. Observe that the mouse pointer on the Windows 8 computer moves to the left.
4. Push Button 2. Observe that the mouse pointer on the Windows 8 computer moves up.
5. Push Button 3. Observe that the mouse pointer on the Windows 8 computer moves to the right.
6. Push Button 4. Observe that the mouse pointer on the Windows 8 computer moves down.
7. Disconnect the computer from the device by removing the device from the computer's devices list. Observe that for the first period, the BSP_INDICATE_ADVERTISING_DIRECTED state is indicated, then it switches to BSP_INDICATE_ADVERTISING_WHITELIST, then to BSP_INDICATE_ADVERTISING, then to BSP_INDICATE_ADVERTISING_SLOW, and then all off.
8. Reset the device while pressing Button 2 to erase bond info. Repeat step 2, and check if the device can control the mouse pointer on the computer.
9. Disconnect the device from Windows 8, thereby removing the bond info from the computer. Start a search for Bluetooth devices and observe that while the device is advertising with Whitelist, Windows 8 is not able to discover the device.
10. The device should be discoverable again after it switches to advertising mode.

You can also test the application with nRF Connect by performing the following steps:

1. Compile and program the application. Observe that the BSP_INDICATE_ADVERTISING state is indicated.
2. Connect to the device from nRF Connect (the device is advertising as 'Nordic_Mouse'), then bond to the device. To bond, click the settings button for the device in nRF Connect, select "Pair", check "Perform Bonding", and click "Pair". Wait until the bond is established before you continue. Observe that the BSP_INDICATE_CONNECTED state is indicated.
3. Observe that the services are shown in the connected device and that you can start receiving values for the Battery Level Service by clicking the 'Play' button. Battery Level notifications are being received every two seconds.
4. Click the 'Play' button for all HID Report characteristics.
5. Push Button 1 on the board. Observe that a notification on one of the HID Report characteristics is received, containing the value 'FB0F00'. The format used for mouse reports is the following byte array: [Buttons, X-translation, Y-translation].
6. Push Button 2. Observe that a notification on the same HID Report characteristic is received, containing the value '00B0FF'.
7. Push Button 3. Observe that a notification on the same HID Report characteristic is received, containing the value '050000'.
8. Push Button 4. Observe that a notification on the same HID Report characteristic is received, containing the value '005000'.
9. Disconnect the device in nRF Connect. Observe that no new notifications are received, and the device is advertising with whitelist.
10. As bond information is preserved by nRF Connect, it should be possible to immediately reconnect to the device by clicking the Connect button again. Observe that Battery Level notifications are being received every two seconds.