📄 cdc acm readme.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head> <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" /> <title>CDC ACM ReadMe</title></head><body><b>USB CDC (Communication Device Class) implementation for 'F32x and 'F34x</b><br><br>Posted to: http://www.cygnal.org/ubb/Forum9/HTML/000945.html<br><br>USB_CDC_skeleton_15.zip<br><br>History<br> v1.0 (July 19, 2006)<br> Initial release<br> v1.1 (July 21, 2006)<br> Added support for 'F34x<br> Renamed the project and file names, not to include 'F32x_'<br> Delete Low-speed support<br> Actually, low-speed is achieved using interrupt endpoints instead of bulk.<br> But it is out of spec for CDC ACM.<br> The temporary buffer in line coding handling was moved<br> from unused USB FIFO to IDATA, for 'F34x compatibility<br> v1.2 (Aug 14, 2006)<br> Revised USB interrupt setting after USB bus reset.<br> Deleted 'reset data toggle' code in Set_Configuration, because it is done <br> by USB bus reset (from personal communication with SiLabs)<br> v1.3 (Aug 18, 2006)<br> Optimized setup stage handling in the device request handler.<br> This optimization reduces the code size about 150 bytes for Keil,<br> 230 bytes for SDCC<br> v1.4 (Sep 5, 2006)<br> Optimized class-specific request handling. As the check of interface number is common, <br> it is done before dispatcher.<br> Reviced Usb0_Init in USB_Main.c : enabled USB reset interrupt.<br> Reviced Set_Configuration in USB_Standard_Requests.c : recovered 'reset data toggle'<br> Reviced Usb_Suspend in USB_ISR.c, to match to the peripheral initialization in Port_Init.<br> Commented out USB Resume interrupt handling, It does nothing in this implementation.<br> Bug fix: F32x occasionally fails SET_LINE_CODING on high-speed hub.<br> This bug was fixed by deleting DATAEND of SUEND event handling in Handle_Setup (USB_ISR.c)<br> v1.5 (May 10, 2008)<br> Rewrote most of the source code to fit to composite device<br> Added ZLP to terminate the bulk IN transfer<br> Fixed bug of FIFO_Read_generic()<br> Revised the INF file to support Vista<br><br><br>Applying CDC ACM, the device is recognized as 'virtual' COM port using built-in device driver, in most of major OS including Windows, MacOS and Linux.<br><br>In this code, the USB side is fully implemented, but no UART is attached. Instead, support routines to connect peripherals to it are provided. The purpose of this implementation is to place a start point for further modification. For simple USB-serial conversion, I recommend you to use existing USB-serial chips.<br><br>The code is based on SiLabs USB_INT (release 1.3). Though the original comments by SiLabs are preserved to respect their work, this implementation has no relation to them. (I also have no relation to SiLabs ;)) Use it on your own risk as usual.<br><br>Thanks Patryk, your advices in <a href="http://www.cygnal.org/ubb/Forum9/HTML/000938.html">"Optimization of SiLabs USB examples in code size"</a> are fully reflected to this implementation. Also, thanks Maarten and Frieder, your suggestions in the topic, <a href="http://www.cygnal.org/ubb/Forum10/HTML/000025.html">"Help to convert sample code of USB_INT to compile under SDCC"</a> help me much on this implementation.<br><br>Tsuneo<br><br><br><b>Note</b><br><b>A) Compilation</b><br>This code was checked on SiLabs 'F320 and 'F340 dev board.<br>Select one of appropriate include file for the device in 'USB_CDC_Type.h'<br><br>#include <c8051f320.h><br>//#include <c8051f340.h><br><br>The code is compiled with Keil or SDCC. The conditional compilation on the code automatically detects the compiler. The work space files, 'Keil_USB_CDC_skeleton.wsp' and 'SDCC_USB_CDC_skeleton.wsp', are provided for SiLabs IDE.<br><br>SMALL memory model<br>Code size<br> Keil full version and 4K eval (SiLabs)<br> 3754 (F320 and F340) bytes<br> SDCC 2.6.0 #4290 (20060718-4290)<br> 4105 (F320 and F340) bytes<br><br><br>USB spec compliance was checked using <a href="http://www.usb.org/developers/tools/">USBCV R1.3 beta</a> on Chapter 9.<br><br>Unfortunately, 'F326/7 cannot be supported because these devices has only two EP other than EP0.<br><br><br><b>B) Installation</b><br>Download the code to 'F320DK and connect the board to an USB port of your PC. 'New Hardware' wizard asks you to locate an INF(.inf) file. Specify the 'CDC_ACM.inf' in the INF folder in the zip file.<br><br>When installed successfully, the device appears on your PC as a COM port.<br><br><b>C) Demonstration</b><br>This implementation simply echoes back the TX output of COM port to RX port. Using a terminal software, such as <a href="http://realterm.sourceforge.net/">RealTerm</a>, you can confirm it by keyboard and file transfer.<br><br>Following transfer speed was observed on loop back, simultaneous bi-direction transfer (WinXP SP2).<br><pre><font size="2"> SYSCLK Speed (Kbytes/sec)<br>F320DK 24MHz 150 <br>F340DK 48MHz 280</font></pre><br>Though I didn't check about transfer speed of single direction transfer, it'll be much faster, from the record of bus analyzer.<br><br>LEDs and SWs on the 'F320DK are connected to RTS, DTR and CTS, DSR, respectively. But RTS and CTS don't work well because usbser.sys on Windows is weird as noted below.<br><br><b>D) Modification</b><br>VID/PID of this implementation was bought from <a href="http://www.voti.nl/shop/catalog.html?USB-PID-10">VOTI</a> to puslish it on the web. You can use this VID/PID in your lab, but get your own VID/PID when you distribute your products. VID/PID is defined in 'USB_Descriptor.h' and INF file.<br><br>TX and RX from PC over USB are attached to ring buffers respectively in 'USB_CDC_UART.c'.<br>The data received from PC is stored in TX buffer.<br>'bit TXReady' shows the TX buffer has any data<br>'UINT TXcount' holds the number of bytes on the TX buffer.<br>'BYTE COMGetByte(void)' retrieves a byte from the TX buffer, and decrements 'TXcount'<br><br>The data sent to PC is held in RX buffer.<br>'bit RXReady' shows that RX buffer has room to store another data<br>'UINT RXcount' holds the number of bytes on the RX buffer.<br>'void COMPutByte( BYTE )' put the data to RX buffer.<br><br>The size and memory space allocation for the TX and RX buffer are defined in 'USB_CDC_UART.h'.<br><br>In this implementation, these output and input of ring buffers are connected directly together in the main loop, 'USB_Main.c', for demonstration. In your modification, these main stream buffers will be connected to the input and output of your peripheral.<br><br>Ring buffer is easy to use, but its speed performance is not so good. To handle an IN transfer (device -> PC) of steady transfer rate, such as ADC, a double buffer is suitable. Also when the packet size of single transfer is always the same, a double buffer works better. You can find an example of double buffer in the topic <a href="http://www.cygnal.org/ubb/Forum9/HTML/000292.html">'256000 bytes/sec Isochronous transfer'</a> on this forum.<br><br>Other than these main data transfer path, you'll need to exchange 'trigger' and 'parameters' between the device and the PC.<br><br>In 'USB_CDC_UART.c',<br>- The COM port setting (baudrate, data bits, stop bits, parity) from PC is received in Set_Line_Coding(). <br>- DTR setting from PC is received in Set_Line_State().<br>- Break signaling from PC is received in Send_Break().<br>- DSR and other UART status (parity, frame error, etc.) are returned to PC in Update_Line_State().<br>See following 'COM session examples' how these functions on the firmware corresponds to the PC COM APIs.<br><br>These handshake signals and setting parameters are completely independent from the main data transfer path. ie. Even if you set the baudrate to either 9600 or 115200 on the PC, it has nothing to do with the transfer rate of the TX and RX. Therefore, these signals and setting parameters are used for 'command' from PC and 'reply' from the device.<br><br>Using or modifying these functions, you can connect any peripherals to PC COM port.<br><br>Turning macro POLL_READ_BYTE/POLL_WRITE_BYTE into functions saves about 310 bytes in Keil, 130bytes in SDCC. When the code size is more essential for your project than execution speed, apply this modification. To convert these macro to function, comment out these macros at the bottom of USB_Register.h.<br><br>Edit the INF file, 'CDC_ACM.inf', in the INF folder with your favorite text editor.<br>The VID/PID specified in the INF file must match to that of the device.<br>See the comments in the INF file for another points to edit.<br><br><b>Q and A</b><br>Q1. What are the resources of C8051F340 which are used by to implement this functionality ?<br>A1. <br> On-chip peripherals:<br> - USB0 - absolutely yes <br> - Internal OSC - for USB clock with clock recovery<br> - - SYSCLK: no restriction, select appropriate one for your task<br> - USB0 interrupt - required, priority (high/low) - either will do<br><br> Memories (bytes) - v1.4<br> 'xdata' is used for RX/TX buffer - tunable on its size and memory assignment<br> KEIL - code: 3754, data: 73.5, xdata: 512<br> SDCC - code: 4105, data: 0x00 - 0x46, except stack, xdata: 512<br><br> For the demonstration only - not the absolute requirement<br> - Timer2 and Timer2 interrupt<br> - - To debounce the switch inputs on the dev board<br> - Ports on 'F34x dev board<br> - - P2.0 and P2.1 - switch<br> - - P2.2 and P2.3 - LED<br> The ports (P0,P1,P2) are configured to fit to the jumper setting of the dev board. But it is not the absolute requirement.<br><br>Q2. In addtion to virtual com port, can this device equip another USB functions at the same time?<br>A2. Unfortunately, Windows built-in device driver, usbser.sys, doesn't accept it.<br>As the USB CDC spec allows it, a custom device driver can support composite device of CDC and other USB class, such as HID, MSC. But I don't know any free device driver which replaces usbser.sys. You must make it by yourself, or buy a commercial one.<br><br><b>E) Weird usbser.sys</b><br>The usbser.sys (built-in device driver of Windows) is weird in several points.<br><br>WinXP SP2, usbser.sys (5.1.2699.2180)<br><br>When the transfer size is just the multiple of 64 bytes (max packet size of bulk IN EP), ReadFile doesn't finish until zero length packet is received, even if the actual transfer size is equal to the requested size.<br><br>The requests issued (or not issued) by usbser.sys are as follows. You'll find how usbser.sys is weird.<br><pre><font size="2">a) Just after device configuration GET_LINE_CODING SET_CONTROL_LINE_STATE(0x00) - RTS:0, DTR:0b) COM session: example 1 RTS doesn't match between PC and device until SetCommState. Even though usbser.sys issues SET_CONTROL_LINE_STATE(0x00) at the configuration, its internal setting (fRtsControl field of DCB) doesn't reflect it. GetCommState and SetCommState issues redundant requests. CloseHandle issues redundant SET_CONTROL_LINE_STATE- CreateFile no request- PurgeComm no request- GetCommState GET_LINE_CODING GET_LINE_CODING- change baudrate on DCB fRtsControl is '1' as default when DCB is read out.- SetCommState GET_LINE_CODING GET_LINE_CODING SET_LINE_CODING GET_LINE_CODING SET_CONTROL_LINE_STATE(0x02) - RTS:1, DTR:0 SET_LINE_CODING GET_LINE_CODING- ReadFile/WriteFile bulk transfer- CloseHandle SET_CONTROL_LINE_STATE(0x02) - RTS:1, DTR:0c) COM session: example 2 EscapeCommFunction( SETRTS ) and EscapeCommFunction( CLRRTS ) issue no request. Only the fRtsControl field of DCB seems to be able to set/reset RTS - CreateFile no request- EscapeCommFunction( SETDTR ) SET_CONTROL_LINE_STATE(0x01) - RTS:0, DTR:1- EscapeCommFunction( CLRDTR ) SET_CONTROL_LINE_STATE(0x00) - RTS:0, DTR:0- EscapeCommFunction( SETRTS ) no request- EscapeCommFunction( CLRRTS ) no request- EscapeCommFunction( SETBREAK ) SEND_BREAK(0xFFFF)- EscapeCommFunction( CLRBREAK ) SEND_BREAK(0x0000)- SetCommBreak SEND_BREAK(0xFFFF)- ClearCommBreak SEND_BREAK(0x0000)- GetCommModemStatus no request - (because the status is returned by the interrupt EP)- ClearCommError no request - (because the status is returned by the interrupt EP)- CloseHandle SET_CONTROL_LINE_STATE(0x00) - RTS:0, DTR:0d) COM session: example 3 CTS is always asserted regardless of actual input.- CreateFile no request- GetCommModemStatus stat = 0x10 (CTS: 1, DSR: 0)- set DSR to 1- GetCommModemStatus stat = 0x30 (CTS: 1, DSR: 1)- set DSR to 0- GetCommModemStatus stat = 0x10 (CTS: 1, DSR: 0)- set CTS to 1- GetCommModemStatus stat = 0x10 (CTS: 1, DSR: 0)- set CTS to 0- GetCommModemStatus stat = 0x10 (CTS: 1, DSR: 0)- CloseHandle SET_CONTROL_LINE_STATE(0x00) - RTS:0, DTR:0</font></pre></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -