Changing ble_app_hids_mouse for trackpad application

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Tue, 22 Nov 2022 17:04:46 GMT

Hi Edvin. Luckily, I found a old nRF51 example sending volume up/down

https://github.com/Rallare/nrf51_ble_app_hids_kbd_consumercontrol/blob/eb9253685fe097f9b0c88212bb51c5e5ff3f7e08/main.c#L220

consumer_control_send(CONSUMER_CTRL_VOL_UP)

consumer_control_send(RELEASE_KEY) // not pressed

where the ENUM (consumer_control_t) was following the usage order from the report_map_data[]:

0x09, 0xCD, // Usage (Play/Pause) = CONSUMER_CTRL_PLAY 0x01

0x0A, 0x83, 0x01, // Usage (AL Consumer Control Configuration) = CONSUMER_CTRL_ALCCC 0x02

0x09, 0xB5, // Usage (Scan Next Track) = CONSUMER_CTRL_SCAN_NEXT_TRACK 0x04

0x09, 0xB6, // Usage (Scan Previous Track) = CONSUMER_CTRL_SCAN_PREV_TRACK 0x08

0x09, 0xEA, // Usage (Volume Down) = CONSUMER_CTRL_VOL_DW 0x10

0x09, 0xE9, // Usage (Volume Up) = CONSUMER_CTRL_VOL_UP 0x20

0x0A, 0x25, 0x02, // Usage (AC Forward) = CONSUMER_CTRL_AC_FORWARD 0x40

0x0A, 0x24, 0x02, // Usage (AC Back) = CONSUMER_CTRL_AC_BACK 0x80

Now I understood so let's close this ticket. Thanks for the help!

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Tue, 22 Nov 2022 13:03:20 GMT

What I tried to say is that these are more generic USB questions than Nordic related questions.

Perhaps you want to have a look at the Zephyr sample found in NCS\zephyr\samples\subsys\usb\hid-cnc

Look in the main.c file, in the function ascii_to_hid, and you will see the enum from NCS\zephyr\include\zephyr\usb\class\hid.h.

This is an enum (that should have been used in our samples as well). It doesn't cover volume control, but you can look in usb_audio.h.

Perhaps something like this is what you are looking for:

https://usb.org/sites/default/files/hut1_3_0.pdf

Scroll down to page 91, and search for "volume".

Best regards,

Edvin

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Tue, 22 Nov 2022 11:00:15 GMT

Thank you Edvin. Then back to my last original question

I want to check how to send a volume key in the mouse example.

Is it

uint8_t media_buffer[INPUT_REP_MEDIA_PLAYER_LEN] = {0xEA} // from rep_map_data[] Volume Down ?

ble_hids_inp_rep_send(&m_hids, INPUT_REP_MPLAYER_INDEX, INPUT_REP_MEDIA_PLAYER_LEN,

media_buffer, m_conn_handle) ?

I wasn't sure what value should I send for Volume Down.

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Tue, 22 Nov 2022 10:06:10 GMT

[quote user="MatthewKYEO"]Is a double touch something similar to a mouse double click where the HID rep_map_data[] has to change?[/quote]

I would think. This is probably something you would want to reach out to USB to know for sure. But a double click is just two single clicks from the nRF's point of view, if I remember correctly.

Unfortunately, from a USB HID point of view, we deliver the framework, but as you see, the samples are unfortunately a bit limited, and so is the documentation.

So I think you should look elsewhere for how the report maps work, and then use what we provide to send the reports.

Best regards,

Edvin

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Mon, 21 Nov 2022 16:33:06 GMT

Hi Edvin. Yes, the SPI driver handles:

x y coordinates - touchpad_get_touch_coordinate()

read single touch / click - touchpad_get_event_state(), I need to implement double touch on my own

gesture (zoom in/out, two finger touch for mouse right click) - touchpad_get_gesture_type()

Is a double touch something similar to a mouse double click where the HID rep_map_data[] has to change?

Thanks for your help

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Mon, 21 Nov 2022 11:48:54 GMT

So what do you see when you apply the SPI driver? I assume it will be able to provide you with x and y coordinates, but is it supposed to handle double touch? How about clicks? Does it handle that at all, or is that something that you need to implement on your own?

BR,

Edvin

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Fri, 18 Nov 2022 17:34:16 GMT

Thank you Edvin. Then back to my original questions,

I want to check how to send a volume key in the mouse example.

Is it

uint8_t media_buffer[INPUT_REP_MEDIA_PLAYER_LEN] = {0xEA} // from rep_map_data[] Volume Down ?

ble_hids_inp_rep_send(&m_hids, INPUT_REP_MPLAYER_INDEX, INPUT_REP_MEDIA_PLAYER_LEN,

media_buffer, m_conn_handle) ?

I wasn't sure what value should I send for Volume Down.

Back to your Microchip touchpad driver part,

https://github.com/MikroElektronika/mikrosdk_click_v2/blob/master/clicks/touchpad/lib/src/touchpad.c

just like this code, the drivers I found were SPI drivers.

The input on the touchpad was sent to a microcontroller using SPI.

In that case, I can simply use that SPI data to map the mouse data (x_delta and y_delta) and

send it using

ble_hids_inp_rep_send(INPUT_REP_MOVEMENT_INDEX, INPUT_REP_MOVEMENT_LEN)

right?

Or do I still need to modify the rep_map_data[] in this case?

Thank you so much for your help!

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Fri, 18 Nov 2022 13:07:15 GMT

Oh, sorry. Yes. Well, this sample only shows moving the mouse. So each packet consists of a move in x,y directions. Mouses only send changes in position, and not speed, so there is no need to send a message saying it is no longer moving. If you do mouse clicking (left mouse button and right mouse button, for instance), then you need to send a new message with the button no longer being pressed. If not, it will think that the mouse button is being held down forever.

I don't remember the values for mouse button clicks, but you can use bt_hids_inp_rep_send, with rep_index = INPUT_REP_BUTTONS_INDEX (= 0)

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Fri, 18 Nov 2022 12:23:52 GMT

Thank you Edvin. Then do you mean the mouse example is not sending 0 (not pressed)?

Shouldn't there be a code for sending 0 in the mouse example?

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Fri, 18 Nov 2022 11:35:39 GMT

Hello,

In the ble_app_hids_keyboard sample, you can see how they do it. They use the function hid_kbd_state_key_clear() to set the internal state of the key to 0 (not pressed), and then it actually sends the keyboard state using key_report_con_send() -> bt_hids_in_rep_send().

BR,

Edvin

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Thu, 17 Nov 2022 12:37:26 GMT

Hi Edvin. Yes, I think that's what it meant by 0 mask as you have discribed.

I can't find the code doing this 0 masking from the ble_app_hids_mouse (SDK v17) example.

May I ask for your help how to send that "no keys are pressed" HID message?

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Thu, 17 Nov 2022 12:20:04 GMT

Hello,

I am not sure what the customer from the phrase meant by 0 mask. Perhaps it is a HID message saying that no keys are pressed. If you don't do it, it will look like the user is holding the last keypress forever.

BR,
Edvin

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Thu, 17 Nov 2022 02:48:20 GMT

Sorry I accidentally pressed VERIFY ANSWER. Here's the Nordic Devzone Thread 8 years ago

RE: HID keyboard example - What does the buffer do and why it needs to be dequeued?

There's a phrase

"After that I send 0 mask at BLE_EVT_TX_COMPLETE event and I did not call buffer_dequeue."

May I ask what this is about?

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Mon, 14 Nov 2022 12:37:57 GMT

[quote user="MatthewKYEO"]Is it true that DIS - PnP characteristic is mandatory for wireless trackpad/mouse/keyboard applications?[/quote]

I believe it is, yes. But please verify with USB.

[quote user="MatthewKYEO"]I read that I have to send a "mask" value to stop increasing or decreasing the volume so I need your help how to do this properly.[/quote]

Where did you read that?

BR,
Edvin

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Thu, 10 Nov 2022 15:27:36 GMT

Thank you Edvin. While I search for the drivers, can you answer my original questions please?

Is it true that DIS - PnP characteristic is mandatory for wireless trackpad/mouse/keyboard applications?

Lastly, I want to check how to send a volume key. Is it ble_hids_inp_rep_send(INPUT_REP_MPLAYER_INDEX, INPUT_REP_MEDIA_PLAYER_LEN)

when I use the same report map?

I read that I have to send a "mask" value to stop increasing or decreasing the volume so I need your help how to do this properly.

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Thu, 10 Nov 2022 13:46:43 GMT

That is a good question.

Strictly speaking, you shouldn't use any of them. You should use your own Vendor ID:

https://www.usb.org/getting-vendor-id

In the mean time, you can use either of them. The USB report map would originate from Microchip, while the USB protocol stack would be Nordic's / Zephyrs.

BR,
Edvin

RE: Changing ble_app_hids_mouse for trackpad application

Matthew K — Thu, 10 Nov 2022 11:15:38 GMT

Thank you for replying Edvin. I think the USB HID spec is the document that describes how report maps are built.

Let me search for the Microchip driver.

Come to think of it, if I use Microchip’s USB HID report map for this BLE trackpad application, do I have to use Microchip’s vendor ID for the DIS PnP characteristic?

RE: Changing ble_app_hids_mouse for trackpad application

Edvin — Wed, 09 Nov 2022 13:41:24 GMT

Hello,

This sounds like a solution that would require a driver from Microchip. I think you should reach out to them to ask what usb report maps they intended to be used with the trackpad that you are using.

If they don't have anything to share, this is a more generic USB question than a Nordic Specific. Trust me, if I knew exactly how you needed to set up this report map, I would tell you, but I think you need to look at how report maps are built up and how they are used.

Best regards,

Edvin