USB CCID class with nordic nRF52840

[Mohammad]

I am developing USB CCID driver class for nordic nRF52840. I used USB CDC-ACM class as reference and tried to implement for USB CCID. I have developed the device descriptor for it.

USB CCID class has 1 interface and 3 endpoints(1 for interrupt, 1 for bulk IN and 1 for bulk OUT). Now the windows is detecting as Microsoft Usbccid smart card reader(WUDF)

In modify the app_usbd_ccid_internal.h, i need to know modification to be done in 

1. class instance data (app_usbd_ccid_inst_t)

2. CCID class specific request handled via control endpoint (app_usbd_ccid_req_t)

3.  ccid context (app_usbd_ccid_ctx_t)

I have attached my app_usbd_ccid_internal.h file with tis for refrence.

app_usbd_ccid_internal.h

[Håkon Alseth]

Hi,

 

This is a windows feature, that you cannot fix in firmware.

See a similar issue here, just for the USBD_CDC_ACM: https://devzone.nordicsemi.com/f/nordic-q-a/52438/usb-cdc-uart-is-recognized-as-teensy-com-port

If you have another driver, you can manually update the driver, as described in the above link.

 

Kind regards,

Håkon

[Mohammad]

Hi Håkon,

This is not the answer for the issue i described above.

Pls check above issue i have described. 

[Håkon Alseth]

Hi,

 

I am sorry if I have misunderstood. From your text, I read that the windows driver enumeration (more specifically; the driver name) is the issue. Is that not the case? If not, can you please describe more in detail?

Kind regards,

Håkon

[Mohammad]

Hi Håkon,

I am developing USB CCID driver class which not exist in nRF52 SDK. 

Nordic guy (kenneth) refer me to use USB CDC-ACM class as reference for developing USB CCID class driver.

https://devzone.nordicsemi.com/f/nordic-q-a/38402/need-support-for-usb-ccid-using-nrf52840

I have modified all the USB CDC class files in order to detect as USB CCID. Files are,
1. app_usbd_ccid_types.h
2. app_usbd_ccid_internals.h
3. app_usbd_ccid_desc.h
4. app_usbd_ccid.h
5. app_usbd_ccid.c

I have successfully written the Interface and class descriptor for CCID and I have tested it. Now the windows shows correctly Microsoft usbccid smart card reader(WUDF).

Now I need to modify further more in order to finish the USB CCID class driver. So i need to know parameter details of

1. usb class instant data (app_usbd_class_inst_t) (Here class will be cdc or audio or msc or HID, in my case it is ccid, app_usbd_ccid_inst_t).

2. class context( app_usbd_class_ctx_t,  Here class will be cdc or audio or msc or HID, in my case it is ccid, app_usbd_ccid_ctx_t).

3. class specific request handled via control endpoint ( app_usbd_class_req_t,  Here class will be cdc or audio or msc or HID, in my case it is ccid, app_usbd_ccid_req_t).

I have attached my app_usbd_ccid_internal.h file for your refrence.(above)

[Håkon Alseth]

Hi,

Mohammad said:

Now I need to modify further more in order to finish the USB CCID class driver. So i need to know parameter details of

1. usb class instant data (app_usbd_class_inst_t) (Here class will be cdc or audio or msc or HID, in my case it is ccid, app_usbd_ccid_inst_t).

2. class context( app_usbd_class_ctx_t,  Here class will be cdc or audio or msc or HID, in my case it is ccid, app_usbd_ccid_ctx_t).

3. class specific request handled via control endpoint ( app_usbd_class_req_t,  Here class will be cdc or audio or msc or HID, in my case it is ccid, app_usbd_ccid_req_t).

Unfortunately, we do not have a document/guide specifically on how to create a own usb class.

The parameters you're asking for is defined in the USB CCID class itself, which you can find here: https://www.usb.org/sites/default/files/DWG_Smart-Card_CCID_Rev110.pdf.

To implement these into the USBD framework, I would recommend looking at the already present classes, and the documentation for USBD:

https://infocenter.nordicsemi.com/topic/sdk_nrf5_v16.0.0/lib_usbd.html?cp=6_1_3_60

 

Kind regards,

Håkon

[Mohammad]

Hi,

Thanks for your response.

Can you let me know how to receive the data from the specific endpoint.

[Håkon Alseth]

Hi,

 

When using app_usbd, see the event handler, in case of the cdc, cdc_acm_event_handler, case "APP_USBD_EVT_DRV_EPTRANSFER".

Kind regards,

Håkon

[Mohammad]

Hi,

Thanks for your response.

Can you specify your answer more clearly where i can refer in the cdc code for receive the data from endpoint.

For example, to send the data in endpoint(EP0), i use the following code,

ret_code_t ret;
nrf_drv_usbd_transfer_t transfer =
{
   .p_data = {.tx = p_data},
   .size = size
};
ret = nrf_drv_usbd_ep_transfer(NRF_DRV_USBD_EPIN0, &transfer);

As per your above statement, once the NRF_DRV_USBD_EVT_EPTRANSFER event is generated, it calls cdc_acm_endpoint_ev where the type of endpoint is check.

If it is bulkout endpoint, cdc_acm_rx_block_finished is called once the NRF_USBD_EP_OK is OK.

But i need to know how to copy the data from the endpoint.

[Håkon Alseth]

Hi,

  

Mohammad said:

ret = nrf_drv_usbd_ep_transfer(NRF_DRV_USBD_EPIN0, &transfer);

In that function, you check if it is IN or OUT direction, based on the EP.

In the case of the cdc_acm, it uses the app_usbd_ep_handled_transfer(), which schedules a callback just prior to when the transfer is to occur, as per the header documentation in nrfx_usbd.h:

/**
 * @brief Start sending data over the endpoint using the transfer handler function.
 *
 * This function initializes an endpoint transmission.
 * Just before data is transmitted, the transfer handler
 * is called and it prepares a data chunk.
 *
 * @param[in] ep        Endpoint number.
 *                      For an IN endpoint, sending is initiated.
 *                      For an OUT endpoint, receiving is initiated.
 * @param[in] p_handler Transfer handler - feeder for IN direction and consumer for
 *                      OUT direction.
 *
 * @retval NRFX_SUCCESS             Transfer queued or started.
 * @retval NRFX_ERROR_BUSY          Selected endpoint is pending.
 * @retval NRFX_ERROR_INVALID_ADDR  Unexpected transfer on EPIN0 or EPOUT0.
 */
nrfx_err_t nrfx_usbd_ep_handled_transfer(nrfx_usbd_ep_t ep,
                                         nrfx_usbd_handler_desc_t const * p_handler);

You can also fetch this using app_usbd_ep_transfer() (for both directions, filtered on the input EP).

  

Mohammad said:

If it is bulkout endpoint, cdc_acm_rx_block_finished is called once the NRF_USBD_EP_OK is OK.

But i need to know how to copy the data from the endpoint.

  That specific function has CDC specific buffering logic, which makes it complicated wrt. where the USB data is read. It's essentially the call to "app_usbd_ep_handled_transfer" that handles it. The rest is buffer logic.

 

Kind regards,

Håkon

[Mohammad]

Hi,

Thanks for your reply.

Now i can send and receive the data through the endpoints.

I have tested the following CCID message functions working good

PC_TO_RDR_GETSLOTSTATUS
PC_TO_RDR_ICCPOWERON
PC_TO_RDR_ICCPOWEROFF

RDR_to_PC_DataBlock
RDR_to_PC_SlotStatus
RDR_to_PC_NotifySlotChange

But i have problem that the program stucks in infinte loop at this part

while (app_usbd_event_queue_process())
{
/* Nothing to do */
}

Help me to solve this issue.

Ouput:

<info> app: USBD CCID example started.
<info> usbd_ccid: ccid_event_handler = 11
<info> app: USB power detected
<info> usbd_ccid: ccid_event_handler = 8
<info> app: USB ready
<info> usbd_ccid: ccid_event_handler = 10
<info> usbd_ccid: ccid_event_handler = 15
<info> usbd_ccid: ccid_event_handler = 13
<info> usbd_ccid: ccid_event_handler = 2
<info> usbd_ccid: ccid_event_handler = 3
<info> usbd_ccid: ccid_event_handler = 15
<info> usbd_ccid: ccid_event_handler = 1
<info> usbd_ccid: ccid_event_handler = 1
<info> usbd_ccid: ccid_event_handler = 15
<info> usbd_ccid: ccid_event_handler = 5
<info> usbd_ccid: setup_event_handler
<info> usbd_ccid: setup_req_std_in
<info> usbd_ccid: NRF_ERROR_NOT_SUPPORTED
<info> usbd_ccid: ccid_event_handler = 15
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: NRF_USBD_EP_WAITING
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 65 and bseq = 1
<info> usbd_ccid: PC_TO_RDR_GETSLOTSTATUS
<info> usbd_ccid: OK = 0
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 81 and bseq = 1
<info> usbd_ccid: OK = 1
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x82
<info> usbd_ccid: EPIN_DATA: 82 done
<info> usbd_ccid: RDR_to_PC_NotifySlotChange = 50, 03
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x81
<info> usbd_ccid: EPIN_CON: notify
<info> usbd_ccid: EPIN_CON: 81 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 63 and bseq = 2
<info> usbd_ccid: PC_TO_RDR_ICCPOWEROFF
<info> usbd_ccid: OK = 0
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x82
<info> usbd_ccid: EPIN_DATA: 82 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 62 and bseq = 3
<info> usbd_ccid: PC_TO_RDR_ICCPOWERON
<info> usbd_ccid: OK = 0
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x82
<info> usbd_ccid: EPIN_DATA: 82 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 63 and bseq = 4
<info> usbd_ccid: PC_TO_RDR_ICCPOWEROFF
<info> usbd_ccid: OK = 0
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x82
<info> usbd_ccid: EPIN_DATA: 82 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 62 and bseq = 5
<info> usbd_ccid: PC_TO_RDR_ICCPOWERON
<info> usbd_ccid: OK = 0
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x82
<info> usbd_ccid: EPIN_DATA: 82 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 63 and bseq = 6
<info> usbd_ccid: PC_TO_RDR_ICCPOWEROFF
<info> usbd_ccid: OK = 0
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x82
<info> usbd_ccid: EPIN_DATA: 82 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x2
<info> usbd_ccid: Length of the data received = 10
<info> usbd_ccid: CCID Message type = 62 and bseq = 7
<info> usbd_ccid: PC_TO_RDR_ICCPOWERON
<info> usbd_ccid: OK = 0
<info> usbd_ccid: EPOUT_DATA: 02 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 6
<info> usbd_ccid: ccid_endpoint_ev
<info> usbd_ccid: Current EP address = 0x82
<info> usbd_ccid: EPIN_DATA: 82 done
<info> usbd_ccid: ------------------------
<info> usbd_ccid: ccid_event_handler = 5
<info> usbd_ccid: setup_event_handler
<info> usbd_ccid: setup_req_std_in
<info> usbd_ccid: NRF_ERROR_NOT_SUPPORTED
<info> usbd_ccid: ccid_event_handler = 5
<info> usbd_ccid: setup_event_handler
<info> usbd_ccid: setup_req_std_in
<info> usbd_ccid: NRF_ERROR_NOT_SUPPORTED
<info> usbd_ccid: ccid_event_handler = 5
<info> usbd_ccid: setup_event_handler
<info> usbd_ccid: setup_req_std_in
<info> usbd_ccid: NRF_ERROR_NOT_SUPPORTED

[Håkon Alseth]

Hi,

 

Mohammad said:

<info> usbd_ccid: ccid_event_handler = 5
<info> usbd_ccid: setup_event_handler
<info> usbd_ccid: setup_req_std_in
<info> usbd_ccid: NRF_ERROR_NOT_SUPPORTED

 What is '5' in this case? Is that the p_event->app_evt.type? If yes, then that is the setup APP_USBD_EVT_DRV_SETUP, which should handle class specific requests. I do not have extensive knowledge about CCID, unfortunately, so I cannot state what should be implemented for this specific USB class.

 

Mohammad said:

But i have problem that the program stucks in infinte loop at this part

while (app_usbd_event_queue_process())
{
/* Nothing to do */
}

 Is it stuck inside there, or just not processing any events? It sounds like there's some CCID specific events that are not implemented?

 

Kind regards,

Håkon

[Mohammad]

Hi,

Yes, it is  p_event->app_evt.type.

NRF_LOG_INFO("ccid_event_handler = %d", p_event->app_evt.type);

 Is it stuck inside there, or just not processing any events? It sounds like there's some CCID specific events that are not implemented?

Yes, it processes the events.