/* This test is designed to test the simple dpump host/device class operation. */ #include #include "tx_api.h" #include "ux_api.h" #include "ux_system.h" #include "ux_utility.h" #include "ux_device_class_cdc_acm.h" #include "ux_host_class_cdc_acm.h" #include "ux_device_stack.h" #include "ux_host_stack.h" #include "ux_test_hcd_sim_host.h" #include "ux_test_utility_sim.h" /* Define USBX demo constants. */ #define UX_DEMO_STACK_SIZE 4096 #define UX_DEMO_BUFFER_SIZE 2048 #define UX_DEMO_RUN 1 #define UX_DEMO_MEMORY_SIZE (64*1024) #define LSB(x) (x & 0x00ff) #define MSB(x) ((x & 0xff00) >> 8) /* CDC IAD 8 bytes */ #define CDC_IAD_DESC(comm_ifc) \ /* Interface association descriptor. 8 bytes. */\ 0x08, 0x0b, (comm_ifc), 0x02, 0x02, 0x02, 0x00, 0x00, #define CDC_IAD_DESC_LEN 8 /* CDC Communication interface descriptors 9+5+4+5+5+7=35 bytes */ #define CDC_COMM_IFC_DESC_ALL(comm_ifc, data_ifc, interrupt_epa) \ /* Communication Class Interface Descriptor. 9 bytes. */\ 0x09, 0x04, (comm_ifc), 0x00, 0x01, 0x02, 0x02, 0x01, 0x00,\ /* Header Functional Descriptor 5 bytes */\ 0x05, 0x24, 0x00, 0x10, 0x01,\ /* ACM Functional Descriptor 4 bytes */\ 0x04, 0x24, 0x02, 0x0f,\ /* Union Functional Descriptor 5 bytes */\ 0x05, 0x24, 0x06,\ (comm_ifc), /* Master interface */\ (data_ifc), /* Slave interface */\ /* Call Management Functional Descriptor 5 bytes */\ 0x05, 0x24, 0x01, 0x03,\ (data_ifc), /* Data interface */\ /* Endpoint 0x83 descriptor 7 bytes */\ 0x07, 0x05, (interrupt_epa),\ 0x03,\ 0x08, 0x00,\ 0xFF, #define CDC_COMM_IFC_DESC_ALL_LEN 35 /* CDC Data interface descriptors 9+7+7=23 bytes */ #define CDC_DATA_IFC_DESC_ALL(ifc, bulk_in_epa, bulk_out_epa) \ /* Data Class Interface Descriptor Requirement 9 bytes */\ 0x09, 0x04, (ifc),\ 0x00, /* bAlternateSetting */\ 0x02, /* bNumEndpoints */\ 0x0A, 0x00, 0x00,\ 0x00,\ /* Endpoint bulk IN descriptor 7 bytes */\ 0x07, 0x05, (bulk_in_epa),\ 0x02,\ 0x40, 0x00,\ 0x00,\ /* Endpoint bulk OUT descriptor 7 bytes */\ 0x07, 0x05, (bulk_out_epa),\ 0x02,\ 0x40, 0x00,\ 0x00, #define CDC_DATA_IFC_DESC_ALL_LEN 23 /* Configuration descriptor 9 bytes */ #define CFG_DESC(wTotalLength, bNumInterfaces, bConfigurationValue)\ /* Configuration 1 descriptor 9 bytes */\ 0x09, 0x02, LSB(wTotalLength), MSB(wTotalLength),\ (bNumInterfaces), (bConfigurationValue), 0x00,\ 0x40, 0x00, #define CFG_DESC_LEN 9 /* Define the counters used in the demo application... */ static ULONG test_error_cases = UX_FALSE; static ULONG test_error_counter; static ULONG thread_0_counter; static ULONG thread_1_counter; static ULONG error_counter; /* Define USBX demo global variables. */ static UX_HOST_CLASS *class_driver; static UX_HOST_CLASS_CDC_ACM *cdc_acm_host_control; static UX_HOST_CLASS_CDC_ACM *cdc_acm_host_data; static UX_SLAVE_CLASS_CDC_ACM *cdc_acm_slave; static UX_SLAVE_CLASS_CDC_ACM_PARAMETER cdc_acm_parameter; static UCHAR detect_insertion; static UCHAR detect_extraction; static UCHAR device_framework_full_speed[] = { /* Device descriptor 18 bytes 0x02 bDeviceClass: CDC class code 0x00 bDeviceSubclass: CDC class sub code 0x00 bDeviceProtocol: CDC Device protocol idVendor & idProduct - http://www.linux-usb.org/usb.ids */ 0x12, 0x01, 0x10, 0x01, 0xEF, 0x02, 0x01, 0x08, 0x84, 0x84, 0x00, 0x00, 0x00, 0x01, 0x01, 0x02, 03, 0x03, /* Configuration 1 descriptor 9 bytes */ 0x09, 0x02, 0x4b, 0x00, 0x02, 0x01, 0x00, 0x40, 0x00, /* Interface association descriptor. 8 bytes. */ 0x08, 0x0b, 0x00, 0x02, 0x02, 0x02, 0x00, 0x00, /* Communication Class Interface Descriptor Requirement. 9 bytes. */ 0x09, 0x04, 0x00, 0x00, 0x01, 0x02, 0x02, 0x01, 0x00, /* Header Functional Descriptor 5 bytes */ 0x05, 0x24, 0x00, 0x10, 0x01, /* ACM Functional Descriptor 4 bytes */ 0x04, 0x24, 0x02, 0x0f, /* Union Functional Descriptor 5 bytes */ 0x05, 0x24, 0x06, 0x00, /* Master interface */ 0x01, /* Slave interface */ /* Call Management Functional Descriptor 5 bytes */ 0x05, 0x24, 0x01, 0x03, 0x01, /* Data interface */ /* Endpoint 0x83 descriptor 7 bytes */ 0x07, 0x05, 0x83, 0x03, 0x08, 0x00, 0xFF, /* Data Class Interface Descriptor Requirement 9 bytes */ 0x09, 0x04, 0x01, 0x00, 0x02, 0x0A, 0x00, 0x00, 0x00, /* Endpoint 0x02 descriptor 7 bytes */ 0x07, 0x05, 0x02, /* @ 93 - 14 + 2 = 81 */ 0x02, 0x40, 0x00, 0x00, /* Endpoint 0x81 descriptor 7 bytes */ 0x07, 0x05, 0x81, /* @ 93 - 7 + 2 = 88 */ 0x02, 0x40, 0x00, 0x00, /* Configuration 2: CDC */ CFG_DESC(CFG_DESC_LEN+(CDC_IAD_DESC_LEN+CDC_COMM_IFC_DESC_ALL_LEN+CDC_DATA_IFC_DESC_ALL_LEN), 2, 2) CDC_IAD_DESC(0) CDC_COMM_IFC_DESC_ALL(0, 1, 0x83) CDC_DATA_IFC_DESC_ALL(1, 0x81, 0x02) /* Configuration 3: CDC */ CFG_DESC(CFG_DESC_LEN+(CDC_IAD_DESC_LEN+CDC_COMM_IFC_DESC_ALL_LEN+CDC_DATA_IFC_DESC_ALL_LEN), 3, 2) CDC_IAD_DESC(0) CDC_COMM_IFC_DESC_ALL(0, 1, 0x83) CDC_DATA_IFC_DESC_ALL(1, 0x81, 0x02) }; #define DEVICE_FRAMEWORK_LENGTH_FULL_SPEED sizeof(device_framework_full_speed) static UCHAR device_framework_high_speed[] = { /* Device descriptor 0x02 bDeviceClass: CDC class code 0x00 bDeviceSubclass: CDC class sub code 0x00 bDeviceProtocol: CDC Device protocol idVendor & idProduct - http://www.linux-usb.org/usb.ids */ 0x12, 0x01, 0x00, 0x02, 0xEF, 0x02, 0x01, 0x40, 0x84, 0x84, 0x00, 0x00, 0x00, 0x01, 0x01, 0x02, 03, 0x01, /* Device qualifier descriptor */ 0x0a, 0x06, 0x00, 0x02, 0x02, 0x00, 0x00, 0x40, 0x01, 0x00, /* Configuration 1 descriptor */ 0x09, 0x02, 0x4b, 0x00, 0x02, 0x01, 0x00, 0x40, 0x00, /* Interface association descriptor. */ 0x08, 0x0b, 0x00, 0x02, 0x02, 0x02, 0x00, 0x00, /* Communication Class Interface Descriptor Requirement */ 0x09, 0x04, 0x00, 0x00, 0x01, 0x02, 0x02, 0x01, 0x00, /* Header Functional Descriptor */ 0x05, 0x24, 0x00, 0x10, 0x01, /* ACM Functional Descriptor */ 0x04, 0x24, 0x02, 0x0f, /* Union Functional Descriptor */ 0x05, 0x24, 0x06, 0x00, 0x01, /* Call Management Functional Descriptor */ 0x05, 0x24, 0x01, 0x00, 0x01, /* Endpoint 0x83 descriptor */ 0x07, 0x05, 0x83, 0x03, 0x08, 0x00, 0xFF, /* Data Class Interface Descriptor Requirement */ 0x09, 0x04, 0x01, 0x00, 0x02, 0x0A, 0x00, 0x00, 0x00, /* Endpoint 0x02 descriptor */ 0x07, 0x05, 0x02, /* @ 103 - 14 + 2 = 91 */ 0x02, 0x40, 0x00, 0x00, /* Endpoint 0x81 descriptor */ 0x07, 0x05, 0x81, /* @ 103 - 7 + 2 = 98 */ 0x02, 0x40, 0x00, 0x00, /* Configuration 2: CDC */ CFG_DESC(CFG_DESC_LEN+(CDC_IAD_DESC_LEN+CDC_COMM_IFC_DESC_ALL_LEN+CDC_DATA_IFC_DESC_ALL_LEN), 2, 2) CDC_IAD_DESC(0) CDC_COMM_IFC_DESC_ALL(0, 1, 0x83) CDC_DATA_IFC_DESC_ALL(1, 0x81, 0x02) /* Configuration 3: CDC */ CFG_DESC(CFG_DESC_LEN+(CDC_IAD_DESC_LEN+CDC_COMM_IFC_DESC_ALL_LEN+CDC_DATA_IFC_DESC_ALL_LEN), 3, 2) CDC_IAD_DESC(0) CDC_COMM_IFC_DESC_ALL(0, 1, 0x83) CDC_DATA_IFC_DESC_ALL(1, 0x81, 0x02) }; #define DEVICE_FRAMEWORK_LENGTH_HIGH_SPEED sizeof(device_framework_high_speed) /* String Device Framework : Byte 0 and 1 : Word containing the language ID : 0x0904 for US Byte 2 : Byte containing the index of the descriptor Byte 3 : Byte containing the length of the descriptor string */ static UCHAR string_framework[] = { /* Manufacturer string descriptor : Index 1 */ 0x09, 0x04, 0x01, 0x0c, 0x45, 0x78, 0x70, 0x72,0x65, 0x73, 0x20, 0x4c, 0x6f, 0x67, 0x69, 0x63, /* Product string descriptor : Index 2 */ 0x09, 0x04, 0x02, 0x0c, 0x44, 0x61, 0x74, 0x61, 0x50, 0x75, 0x6d, 0x70, 0x44, 0x65, 0x6d, 0x6f, /* Serial Number string descriptor : Index 3 */ 0x09, 0x04, 0x03, 0x04, 0x30, 0x30, 0x30, 0x31 }; #define STRING_FRAMEWORK_LENGTH sizeof(string_framework) /* Multiple languages are supported on the device, to add a language besides English, the unicode language code must be appended to the language_id_framework array and the length adjusted accordingly. */ static UCHAR language_id_framework[] = { /* English. */ 0x09, 0x04 }; #define LANGUAGE_ID_FRAMEWORK_LENGTH sizeof(language_id_framework) /* Define prototypes for external Host Controller's (HCDs), classes and clients. */ static VOID test_cdc_instance_activate(VOID *cdc_instance); static VOID test_cdc_instance_deactivate(VOID *cdc_instance); static UINT test_host_change_function(ULONG event, UX_HOST_CLASS *cls, VOID *inst); UINT ux_hcd_sim_initialize(UX_HCD *hcd); static TX_THREAD tx_test_thread_host_simulation; static TX_THREAD tx_test_thread_slave_simulation; static void tx_test_thread_host_simulation_entry(ULONG); static void tx_test_thread_slave_simulation_entry(ULONG); /* Define the ISR dispatch. */ extern VOID (*test_isr_dispatch)(void); /* Prototype for test control return. */ void test_control_return(UINT status); /* Define the ISR dispatch routine. */ static void test_isr(void) { /* For further expansion of interrupt-level testing. */ } static VOID error_callback(UINT system_level, UINT system_context, UINT error_code) { test_error_counter ++; /* Failed test. */ if (!test_error_cases) { printf("Error on line %d, system_level: %d, system_context: %d, error code: %d\n", __LINE__, system_level, system_context, error_code); test_control_return(1); } } /* Define what the initial system looks like. */ #ifdef CTEST void test_application_define(void *first_unused_memory) #else void usbx_ux_host_stack_new_configuration_create_test_application_define(void *first_unused_memory) #endif { UINT status; CHAR *stack_pointer; CHAR *memory_pointer; /* Initialize the free memory pointer. */ stack_pointer = (CHAR *) first_unused_memory; memory_pointer = stack_pointer + (UX_DEMO_STACK_SIZE * 2); /* Initialize USBX Memory. */ status = ux_system_initialize(memory_pointer, UX_DEMO_MEMORY_SIZE, UX_NULL, 0); /* Check for error. */ if (status != UX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #1\n"); test_control_return(1); } /* Register the error callback. */ _ux_utility_error_callback_register(error_callback); /* The code below is required for installing the host portion of USBX. */ status = ux_host_stack_initialize(test_host_change_function); /* Check for error. */ if (status != UX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #2\n"); test_control_return(1); } /* Register CDC-ACM class. */ status = ux_host_stack_class_register(_ux_system_host_class_cdc_acm_name, ux_host_class_cdc_acm_entry); /* Check for error. */ if (status != UX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #3\n"); test_control_return(1); } /* The code below is required for installing the device portion of USBX */ status = ux_device_stack_initialize(device_framework_high_speed, DEVICE_FRAMEWORK_LENGTH_HIGH_SPEED, device_framework_full_speed, DEVICE_FRAMEWORK_LENGTH_FULL_SPEED, string_framework, STRING_FRAMEWORK_LENGTH, language_id_framework, LANGUAGE_ID_FRAMEWORK_LENGTH, UX_NULL); /* Check for error. */ if (status != UX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #5\n"); test_control_return(1); } /* Set the parameters for callback when insertion/extraction of a CDC device. */ cdc_acm_parameter.ux_slave_class_cdc_acm_instance_activate = test_cdc_instance_activate; cdc_acm_parameter.ux_slave_class_cdc_acm_instance_deactivate = test_cdc_instance_deactivate; cdc_acm_parameter.ux_slave_class_cdc_acm_parameter_change = UX_NULL; /* Initialize the device cdc class. This class owns both interfaces starting with 0. */ status = ux_device_stack_class_register(_ux_system_slave_class_cdc_acm_name, ux_device_class_cdc_acm_entry, 1,0, &cdc_acm_parameter); /* Check for error. */ if (status != UX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #6\n"); test_control_return(1); } /* Initialize the simulated device controller. */ status = _ux_dcd_sim_slave_initialize(); /* Check for error. */ if (status != UX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #7\n"); test_control_return(1); } /* Register all the USB host controllers available in this system */ status = ux_host_stack_hcd_register(_ux_system_host_hcd_simulator_name, _ux_test_hcd_sim_host_initialize,0,0); /* Check for error. */ if (status != UX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #4\n"); test_control_return(1); } /* Create the main host simulation thread. */ status = tx_thread_create(&tx_test_thread_host_simulation, "tx demo host simulation", tx_test_thread_host_simulation_entry, 0, stack_pointer, UX_DEMO_STACK_SIZE, 20, 20, 1, TX_AUTO_START); /* Check for error. */ if (status != TX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #8\n"); test_control_return(1); } /* Create the main demo thread. */ status = tx_thread_create(&tx_test_thread_slave_simulation, "tx demo slave simulation", tx_test_thread_slave_simulation_entry, 0, stack_pointer + UX_DEMO_STACK_SIZE, UX_DEMO_STACK_SIZE, 20, 20, 1, TX_AUTO_START); /* Check for error. */ if (status != TX_SUCCESS) { printf("Running ux_host_stack_new_configuration_create Test................. ERROR #9\n"); test_control_return(1); } } static void tx_test_thread_host_simulation_entry(ULONG arg) { UINT status; UX_DEVICE *device; /* Inform user. */ printf("Running ux_host_stack_new_configuration_create Test................. "); /* Wait connect. */ ux_test_hcd_sim_host_connect(UX_FULL_SPEED_DEVICE); tx_thread_sleep(100); if (cdc_acm_host_control == UX_NULL || cdc_acm_host_data == UX_NULL || cdc_acm_slave == UX_NULL) { printf("ERROR #%d: connection not detected\n", __LINE__); test_control_return(1); } status = ux_host_stack_device_get(0, &device); if (status != UX_SUCCESS) { printf("ERROR #%d: fail to get device instance\n", __LINE__); test_control_return(1); } /* No other simulation. */ /* Sleep for a tick to make sure everything is complete. */ tx_thread_sleep(1); /* Check for errors from other threads. */ if (error_counter) { /* DPUMP error. */ printf("ERROR #14\n"); test_control_return(1); } else { /* Successful test. */ printf("SUCCESS!\n"); test_control_return(0); } } static void tx_test_thread_slave_simulation_entry(ULONG arg) { while(1) { /* Ensure the dpump class on the device is still alive. */ if (cdc_acm_slave != UX_NULL) { /* Increment thread counter. */ thread_1_counter++; } /* Let other thread run. */ tx_thread_sleep(10); } } static VOID test_cdc_instance_activate(VOID *cdc_instance) { /* Save the CDC instance. */ cdc_acm_slave = (UX_SLAVE_CLASS_CDC_ACM *) cdc_instance; } static VOID test_cdc_instance_deactivate(VOID *cdc_instance) { /* Reset the CDC instance. */ cdc_acm_slave = UX_NULL; } static UINT test_host_change_function(ULONG event, UX_HOST_CLASS *cls, VOID *inst) { UX_HOST_CLASS_CDC_ACM *cdc_acm = (UX_HOST_CLASS_CDC_ACM *) inst; switch(event) { case UX_DEVICE_INSERTION: detect_insertion = UX_TRUE; if (cdc_acm -> ux_host_class_cdc_acm_interface -> ux_interface_descriptor.bInterfaceClass == UX_HOST_CLASS_CDC_CONTROL_CLASS) cdc_acm_host_control = cdc_acm; else cdc_acm_host_data = cdc_acm; break; case UX_DEVICE_REMOVAL: detect_extraction = UX_TRUE; if (cdc_acm -> ux_host_class_cdc_acm_interface -> ux_interface_descriptor.bInterfaceClass == UX_HOST_CLASS_CDC_CONTROL_CLASS) cdc_acm_host_control = UX_NULL; else cdc_acm_host_data = UX_NULL; break; default: break; } return UX_SUCCESS; }