![]() |
USB Component
Version 5.0
MDK-Professional Middleware for USB Device and Host
|
The following table is an overview of the changes to the API functions of the USB Component compared to RL-USB, the Real-Time Library provided with MDK Version 4. The MDK-ARM Version 5 USB Component requires CMSIS-RTOS functionality. Events are no longer called by interrupt service routines which makes the timing of the overall system more predictable.
The API functions along with the differences are shown in the order:
RL-USB
: MDK-ARM Version 4 with links to the RL-ARM online manual.USB Component
: MDK-ARM Version 5.Description of the difference.
Differences of the USB Device API functions.
rtl.h // definitions for all RL-ARM middleware components rl_usb.h // definitions for USB Component
MDK Middleware Component now uses a header file for each of the components.
void usbd_init (void) usbStatus USBD_Initialize (int8_t device)
Parameter device represents index of USB Device controller.
did not exist usbStatus USBD_Uninitialize (int8_t device)
In RL-USB it was impossible to stop an USB Device.
void usbd_connect (BOOL con) usbStatus USBD_Connect (int8_t device)
Parameter con is removed and complementary function USBD_Disconnect is introduced. Parameter device represents index of USB Device controller.
did not exist usbStatus USBD_Disconnect (int8_t device)
RL-USB used usbd_connect with con=0. Parameter device represents index of USB Device controller.
void usbd_reset_core (void) removed
Use instead the de-initalization function USBD_Uninitialize.
BOOL usbd_configured (void) bool USBD_Configured (int8_t device)
Parameter device represents index of USB Device controller.
void usbd_hid_init (void) void USBD_HIDn_Initialize (void)
did not exist void USBD_HIDn_Uninitialize (void)
In RL-USB it was impossible to stop an USB Device.
BOOL usbd_hid_get_report_trigger ( U8 rid, U8 *buf, int len) usbStatus USBD_HID_GetReportTrigger (int8_t instance, uint8_t rid, const uint8_t *buf, int32_t len)
int usbd_hid_get_report (U8 rtype, U8 rid, U8 *buf, U8 req) int32_t USBD_HIDn_GetReport (uint8_t rtype, uint8_t req, uint8_t rid, uint8_t *buf)
void usbd_hid_set_report (U8 rtype, U8 rid, U8 *buf, int len, U8 req) BOOL USBD_HIDn_SetReport (uint8_t rtype, uint8_t req, uint8_t rid, const uint8_t *buf, int32_t len)
U8 usbd_hid_get_protocol (void)
removed
void usbd_hid_set_protocol (U8 protocol)
removed
void usbd_msc_init (void) void USBD_MSCn_Initialize (void)
did not exist void USBD_MSCn_Uninitialize (void)
void usbd_msc_read_sect (U32 block, U8 *buf, U32 num_of_blocks) bool USBD_MSCn_Read (uint32_t lba, uint16_t cnt, uint8_t *buf)
void usbd_msc_write_sect (U32 block, U8 *buf, U32 num_of_blocks) bool USBD_MSCn_Write (uint32_t lba, uint16_t cnt, const uint8_t *buf)
void usbd_msc_start_stop (BOOL start)
removed
void usbd_adc_init (void) void USBD_ADCn_Initialize (void)
did not exist void USBD_ADCn_Uninitialize (void)
int32_t USBD_CDC_ACM_Initialize (void) void USBD_CDC_ACM_Initialize (void)
int32_t USBD_CDC_ACM_Uninitialize (void) void USBD_CDC_ACM_Uninitialize (void)
int32_t USBD_CDC_ACM_Reset (void) void USBD_CDC_ACM_Reset (void)
int32_t USBD_CDC_ACM_PortSetLineCoding (CDC_LINE_CODING *line_coding) bool USBD_CDCn_ACM_SetLineCoding (CDC_LINE_CODING *line_coding)
int32_t USBD_CDC_ACM_PortGetLineCoding (CDC_LINE_CODING *line_coding) bool USBD_CDCn_ACM_GetLineCoding (CDC_LINE_CODING *line_coding)
int32_t USBD_CDC_ACM_PortSetControlLineState (uint16_t ctrl_bmp) bool USBD_CDCn_ACM_SetControlLineState (uint16_t state)
int32_t USBD_CDC_ACM_GetChar (void) int USBD_CDC_ACM_GetChar (int8_t instance)
int32_t USBD_CDC_ACM_PutChar ( const uint8_t ch) int USBD_CDC_ACM_PutChar (int8_t instance, int ch)
int32_t USBD_CDC_ACM_DataRead ( uint8_t *buf, int32_t len) int32_t USBD_CDC_ACM_ReadData (int8_t instance, uint8_t *buf, int32_t len)
int32_t USBD_CDC_ACM_DataSend ( const uint8_t *buf, int32_t len) int32_t USBD_CDC_ACM_WriteData (int8_t instance, const uint8_t *buf, int32_t len)
int32_t USBD_CDC_ACM_DataAvailable (void) int32_t USBD_CDC_ACM_DataAvailable (int8_t instance)
int32_t USBD_CDC_ACM_Notify ( uint16_t stat) usbStatus USBD_CDC_ACM_Notify (int8_t instance, uint16_t state)
did not exist void USBD_CDC_ACM_DataReceived (int8_t instance, int32_t len)
Differences of the USB Host API functions.
BOOL usbh_mem_init (U8 ctrl, U32 *ptr_pool, U32 pool_sz) removed
The memory is initialized with USBH_Initialize.
BOOL usbh_mem_alloc (U8 ctrl, U8 **ptr, U32 sz) removed
Allocate a piece of memory from the memory pool.
BOOL usbh_mem_free (U8 ctrl, U8 *ptr) removed
Release a piece of memory back to the memory pool.
BOOL usbh_init (U8 ctrl) usbStatus USBH_Initialize (uint8_t ctrl)
The function initializes the functionality of an USB Host Controller and starts CMSIS-RTOS threads that handle the USB events. The functions usbh_mem_init
, usbh_init_all
, usbh_engine
and usbh_engine_all
are no longer necessary.
BOOL usbh_init_all (void) removed
Replaced by USBH_Initialize.
BOOL usbh_uninit (U8 ctrl) usbStatus USBH_Uninitialize (uint8_t ctrl)
Identical functionality.
did not exist usbStatus USBH_GetStatus (uint8_t ctrl, uint8_t recipient, uint8_t index, uint8_t *ptr_stat_dat)
Get connection and operation status of the device.
BOOL usbh_uninit_all (void) removed
Replaced by USBH_Initialize.
BOOL usbh_engine (U8 ctrl) removed
USB events are now schedule with CMSIS-RTOS threads. Threads are started with USBH_Initialize.
BOOL usbh_engine_all (void) removed
USB events are now schedule with CMSIS-RTOS threads. Threads are started with USBH_Initialize.
U32 usbh_get_last_error (U8 ctrl) removed
There is no error codes retrieval. Instead refer to usbStatus for a function returning of error codes.
U8 usbh_get_error_string (U32 err) removed
There is no string decoding for error codes. Instead refer to usbStatus for a verbal description of error codes.
BOOL usbh_msc_status (U8 ctrl, U8 dev_idx) usbStatus USBH_MSC_GetDeviceStatus (int8_t instance)
Every device has an unique instance number that is the only argument for the new version of the routine.
BOOL usbh_msc_read (U8 ctrl, U8 dev_idx, U32 blk_adr, U8 *ptr_data, U16 blk_num) bool USBH_MSC_Read (uint32_t lba, uint16_t cnt, uint8_t *buf)
Every device has an unique instance number, so that the number of the USB Host controller is not required any more.
BOOL usbh_msc_write (U8 ctrl, U8 dev_idx, U32 blk_adr, U8 *ptr_data, U16 blk_num) bool USBH_MSC_Write (uint32_t lba, uint16_t cnt, const uint8_t *buf)
Every device has an unique instance number, so that the number of the USB Host controller is not required any more.
BOOL usbh_msc_read_config (U8 ctrl, U8 dev_idx, U32 *tot_blk_num, U32 *blk_sz) removed
U32 usbh_msc_get_last_error (U8 ctrl, U8 dev_idx) removed
BOOL usbh_hid_status (U8 ctrl, U8 dev_idx) usbStatus USBH_HID_GetDeviceStatus (int8_t instance)
int usbh_hid_data_in (U8 ctrl, U8 dev_idx, U8 *ptr_data) int32_t USBH_HID_Read (int8_t instance, uint8_t *buf, int32_t len)
int usbh_hid_data_out (U8 ctrl, U8 dev_idx, U8 *ptr_data, U16 data_len) int32_t USBH_HID_Write (int8_t instance, const uint8_t *buf, int32_t len)
U32 usbh_hid_get_last_error (U8 ctrl, U8 dev_idx) removed
void usbh_hid_parse_report_desc (U8 ctrl, U8 dev_idx, U8 *ptrHIDReportDesc) removed
void usbh_hid_data_in_callback (U8 ctrl, U8 dev_idx, U8 *ptr_data, U16 data_len) removed
int usbh_hid_kbd_getkey (U8 ctrl, U8 dev_idx) int USBH_HID_GetKeyboardKey (int8_t instance)
BOOL usbh_hid_mouse_getdata (U8 ctrl, U8 dev_idx, U8 *btn, S8 *x, S8 *y, S8 *wheel) usbStatus USBH_HID_GetMouseState ( int8_t instance, usbHID_MouseState *state)
did not exist usbStatus USBH_SendSetup (uint8_t ctrl, uint8_t *ptr_data)
did not exist usbStatus USBH_SendData (uint8_t ctrl, uint8_t *ptr_data, uint32_t data_len)
did not exist usbStatus USBH_ReceiveData (uint8_t ctrl, uint8_t *ptr_data, uint32_t data_len)
did not exist usbStatus USBH_GetStatus (uint8_t ctrl, uint8_t recipient, uint8_t index, uint8_t *ptr_stat_dat)
did not exist usbStatus USBH_ClearFeature (uint8_t ctrl, uint8_t recipient, uint8_t index, uint8_t feature_selector)
did not exist usbStatus USBH_SetFeature (uint8_t ctrl, uint8_t recipient, uint8_t index, uint8_t feature_selector)
did not exist usbStatus USBH_SetAddress (uint8_t ctrl, uint8_t device_address)
did not exist usbStatus USBH_GetDescriptor (uint8_t ctrl, uint8_t recipient, uint8_t descriptor_type, uint8_t descriptor_index, uint8_t language_id, uint8_t *descriptor_data, uint16_t descriptor_length)
did not exist usbStatus USBH_SetDescriptor (uint8_t ctrl, uint8_t recipient, uint8_t descriptor_type, uint8_t descriptor_index, uint8_t language_id, uint8_t *descriptor_data, uint16_t descriptor_length)
did not exist usbStatus USBH_GetConfiguration (uint8_t ctrl, uint8_t *ptr_configuration)
did not exist usbStatus USBH_SetConfiguration (uint8_t ctrl, uint8_t configuration)
did not exist usbStatus USBH_GetInterface (uint8_t ctrl, uint8_t idx, uint8_t *ptr_alternate)
did not exist usbStatus USBH_SetInterface (uint8_t ctrl, uint8_t index, uint8_t alternate)
did not exist usbStatus USBH_SyncFrame (uint8_t ctrl, uint8_t index, uint8_t *ptr_frame_number)
did not exist void USBH_HID_DataReceived (uint8_t instance, uint16_t len)