dev_hid_generic#

Overview#

The USB HID generic application is a simple demonstration program based on the MCUXpresso SDK. It is enumerated as a HID-compliant device. A PC application can be used to exchange data with the device.

System Requirement#

Hardware requirements#

Mini/micro USB cable
USB A to micro AB cable
Hardware (Tower module/base board, and so on) for a specific device
Personal Computer (PC)

Software requirements#

The project files for lite version examples are is:
<MCUXpresso_SDK_Install>/boards//usb_examples/usb_device_hid_generic_lite//.
For non-lite version examples the path is:
<MCUXpresso_SDK_Install>/boards//usb_examples/usb_device_hid_generic//.

The is Bare Metal or FreeRTOS OS.

The PC’s test tool is generated based on Wimar’s USB HID Component for C#. The source code link is:
www.codeproject.com/Articles/18099/A-USB-HID-Component-for-C
To support the USB HID generic device, make these updates in the file “Sniffer.cs”.

Function usb_OnSpecifiedDeviceArrived \n This function is updated as follows :\n

        private void usb_OnSpecifiedDeviceArrived(object sender, EventArgs e)
        {
            this.lb_message.Items.Add("My device was found");
            this.tb_send.Text = "12 34 56 78 90 ab cd ef";
        }

Function btn_send_Click \n This function is updated as follows :\n

        private void btn_send_Click(object sender, EventArgs e)
        {
            try
            {
                string text = this.tb_send.Text + " ";
                int length = 0;
                text = new System.Text.RegularExpressions.Regex("[\\s]+").Replace(text, " ");
                text.Trim();
                string[] arrText = text.Split(' ');
                byte[] data = new byte[arrText.Length];
                for (int i = 0; i < (arrText.Length); i++)
                {
                    if (arrText[i] != "")
                    {
                        int value = Int32.Parse(arrText[i], System.Globalization.NumberStyles.AllowHexSpecifier);
                        data[i] = (byte)Convert.ToByte(value);
                        length++;
                    }
                }

                for (int i = 0;i < length;i = i+this.usb.SpecifiedDevice.OutputReportLength-1)
                {
                    byte[] send_buffer = new byte[this.usb.SpecifiedDevice.OutputReportLength];
                    send_buffer[0] = (byte)0;
                    for(int j = 1; (j < (data.Length - i + 1)) && (j < this.usb.SpecifiedDevice.OutputReportLength);j++)
                    {
                        send_buffer[j] = data[j + i - 1];
                    }
                    if (this.usb.SpecifiedDevice != null)
                    {
                        this.usb.SpecifiedDevice.SendData(send_buffer);
                    }
                    else
                    {
                        MessageBox.Show("Sorry but your device is not present. Plug it in!! ");
                    }
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.ToString());
            }
        }

Function usb_OnDataRecieved \n This function is updated as follows :\n

        private void usb_OnDataRecieved(object sender, DataRecievedEventArgs args)
        {
            if (InvokeRequired)
            {
                try
                {
                    Invoke(new DataRecievedEventHandler(usb_OnDataRecieved), new object[] { sender, args });
                }
                catch (Exception ex)
                {
                    Console.WriteLine(ex.ToString());
                }
            }
            else
            {
                string rec_data = "Recv:";
                int is_report_id = 1;
                foreach (byte myData in args.data)
                {
                    if (is_report_id > 0)
                    {
                        is_report_id = 0;
                    }
                    else
                    {
                        rec_data += myData.ToString("X2") + " ";
                    }
                }
                this.lb_read.Items.Insert(0, rec_data);
            }
        }

Getting Started#

Hardware Settings#

Set the hardware jumpers (Tower system/base module) to default settings.

Prepare the example#

Download the source code of the PC test tool, apply the changes and rebuild the test tool projects.

For X64 OS, the CPU platform should be selected to x86 in project.

Connect the target board to the external power source (the example is self-powered).
Download the program to the target board.
Power off the target board. And then power on again.
Connect a USB cable between the PC and the USB device port of the board.

For detailed instructions, see the appropriate board User’s Guide. this example could also be tested with the “usb_host_hid_generic” example in pairs.

Run the example#

Plug in the device, which is running HID generic example, into the PC. An HID-compliant device is enumerated in the Device Manager.
Run the test tool. Set the Vendr ID (VID) to “1FC9” and Product ID (PID) to “00A2”. Then click the “OK” button.\n If the device is found and opened, the message “My device was found” is shown in the text box “USB Messages”.

The VID and PID is Hex format.

Enter the data in the text box “Send data” and click the “Send” button. If data is sent, the message “Some data was sent” is shown in the text box “USB Messages”. Then, the device sends back the data. When the data is received, the received data is shown in text box “receive data”.\n For example, data “12 34 56 78 90 ab cd ef” is sent to the device. The message “Recv: 12 34 56 78 90 ab cd ef” is shown when the test tool receives the data.

dev_hid_generic

Contents

dev_hid_generic#

Overview#

System Requirement#

Hardware requirements#

Software requirements#

Getting Started#

Hardware Settings#

Prepare the example#

Run the example#

Supported Boards#

LPCXpresso55S16

Getting Started

Hardware Settings

FRDM-K32L2A4S

Getting Started

Hardware Settings