[nRF52840][usbd_hid_composite] How does Windows transmit CAPS LOCK state to the device without output endpoint?

Question

Hello, I am a new bee in using nRF52840. I have looked into the given example in SDK called usbd_hid_composite ( infocenter.nordicsemi.com/index.jsp . It worked well in my computer. I can use the four buttons and see the LEDs turning on and off when I press CAPS LOCK. I noticed in the codes two input endpoint are set to transmit the button states, but I did not see any output endpoint from Windows to transmit CAPS LOCK state. Then how does the board know the CAPS LOCK state and reflect it with LEDs? 
 Also, I want to change the original code later. The default keyboard output letter is "g" when the button 4 is pressed. I want to have a output endpoint from PC and then I can change the letter from the PC side. Is this realizable? Does anyone know how to do that? 
 Thank you for your support in advance. 
 
 Kind regards, 
 Louis

Dmitry · Accepted Answer

Hi Louis, 
 HID specification says: "The Interrupt Out pipe is optional. If a device declares an Interrupt Out endpoint then Output reports are transmitted by the host to the device through the Interrupt Out endpoint. If no Interrupt Out endpoint is declared then Output reports are transmitted to a device through the Control endpoint, using Set_Report(Output) requests". 
 You can see that transfer is going through NRF_DRV_USBD_EPOUT0 in app_usbd_hid_kbd.c. 
 Haojz said: Also, I want to change the original code later. The default keyboard output letter is "g" when the button 4 is pressed. I want to have a output endpoint from PC and then I can change the letter from the PC side. Is this realizable? Does anyone know how to do that? 
 I think the right way would be to implement a feature report, but this requires changing SDK code (there's no handling for feature reports). A quick and dirty way is to write a report handler (case APP_USBD_HID_USER_EVT_OUT_REPORT_READY) that will parse 5 bits of LEDs as a command for your application. From Windows side, call HidD_SetOutputReport.

Dmitry · Answer

Someway like this: 
 const void * app_usbd_hid_kbd_out_report_get(app_usbd_hid_kbd_t const * p_kbd,
size_t * p_size);

size_t size;
uint8_t *report = (uint8_t *) app_usbd_hid_kbd_out_report_get(&m_app_hid_kbd, &size);
uint8_t LED= report[1];
if (LED == 0x5) letter = APP_USBD_HID_KBD_H; 
 To change letter, search for CONFIG_KBD_LETTER and replace it with a global variable holding your letter. Note that keyboard codes are not ASCII codes (look at app_usbd_hid_kbd.h)

[nRF52840][usbd_hid_composite] How does Windows transmit CAPS LOCK state to the device without output endpoint?

Top Replies