{"id":423,"date":"2017-11-24T23:15:53","date_gmt":"2017-11-24T22:15:53","guid":{"rendered":"http:\/\/mikrocontroller.bplaced.net\/wordpress\/?page_id=423"},"modified":"2018-01-04T19:20:56","modified_gmt":"2018-01-04T18:20:56","slug":"48-usb_hid-library-stm32f4","status":"publish","type":"page","link":"https:\/\/mikrocontroller.bplaced.net\/wordpress\/stm32f4\/komplette-library-liste-stm32f4\/48-usb_hid-library-stm32f4\/","title":{"rendered":"48-USB_HID-Library (STM32F4)"},"content":{"rendered":"

\u2190<\/span> 47-MP45DT02-Library (STM32F4)<\/a><\/div><\/div>
49-InputCapture_Frq-Library (STM32F4) →<\/span><\/a><\/div><\/div><\/p>\n

Mit dieser Library meldet sich die CPU (per USB) am PC als HID-Device an.<\/p>\n

Zum Datenaustausch zwischen dem PC und der CPU ist kein spezieller Treiber notwendig (der ist bei Windows schon dabei)<\/p>\n

Es wird der Interrupt-Mode benutzt, der PC fragt also zyklisch die CPU nach Daten ab. Die Geschwindigkeit (von 1ms bis 255ms) kann im H-File eingestellt werden.<\/p>\n

Die Gr\u00f6\u00dfe vom sende und empfangs Puffer (der pro Zeiteinheit \u00fcbertragen wird) kann auch im H-File eingestellt werden. Hier sind Werte von 1Byte bis 64Bytes m\u00f6glich.<\/p>\n

Die Einstellung 64Bytes pro Block und eine Abfragerate von 1ms ergibt 64kByte\/sec . Das entspricht dem Maximum Wert f\u00fcr USB-FullSpeed.<\/p>\n

Die VID und PID steht auch in einem H-File genauso die Beschreibung Strings f\u00fcr das Device (\u201cSTM32 HID-Device\u201d) mit der Ser.Nr. 0\u00d70100<\/p>\n

Auf der PC-Seite gibt es fertige Programme (z.B. von STM den USB HID-Demonstrator) oder, was ich auch benutzt habe das \u201cSimple HID-Write\u201d von dieser Seite :
\nhttp:\/\/www.lvr.com\/hidpage.htm<\/a><\/p>\n

Ich habe f\u00fcr die PC-Seite ein mini HID-Terminal geschrieben der auf der USB-DLL von Silicon-Labs aufbaut. Um die Library zu testen reicht es, man kann Daten senden und empfangen.<\/p>\n

Die Funktionen der Library sind identisch mit der von USB-CDC. Es gibt eine Funktion zum initialisieren, eine zum abfragen vom USB-Status und je eine Funktion zum senden und empfangen von Daten. Es werden hier aber keine Strings \u00fcbertragen sondern ein Array von Bytes.<\/p>\n

Im Demo wird nach dem empfang von Daten der Block als Echo wieder zur\u00fcckgesendet.
\nDer PC muss auf der Report-ID Nr. 0\u00d700 senden und empfangen wird auch \u00fcber 0\u00d700.<\/p>\n

Es wird ein USB-Kabel mit Micro-USB-Stecker ben\u00f6tigt. (gibts bei EBay oder Amazon)<\/p>\n

Hinweis : im File \u201cusbd_hid_core.c\u201d wird beim compilieren in der Funktion \u201cUSBD_HID_DataOut\u201d eine Warning angezeigt. Ich habe leider keinen Workaround daf\u00fcr gefunden\u2026vlt. kennt sich jemand besser damit aus und kann sich hier melden.<\/em><\/p>\n

Beispielbild :<\/strong><\/p>\n

\"usb_hid\"<\/a><\/p>\n

Benutzte Pins :<\/strong><\/p>\n

PA8   -> USB_OTG_SOF (wird nicht benutzt)\r\nPA9   -> USB_OTG_VBUS\r\nPA10  -> USB_OTG_ID\r\nPA11  -> USB_OTG_DM\r\nPA12  -> USB_OTG_DP<\/pre>\n
Voraussetzungen :<\/strong><\/p>\n
Benutzte Module der CooCox-IDE : GPIO, MISC\r\nBenutzte Librarys : keine<\/pre>\n
Enumerationen :<\/strong><\/p>\n
typedef enum {\r\n  USB_HID_NO_INIT =0, \/\/ USB-Schnittstelle noch nicht initialisiert\r\n  USB_HID_DETACHED,   \/\/ USB-Verbindung getrennt\r\n  USB_HID_CONNECTED   \/\/ USB-Verbindung hergestellt\r\n}USB_HID_STATUS_t;<\/pre>\n
:<\/strong><\/p>\n
typedef enum {\r\n  RX_USB_ERR =0, \/\/ keine USB Verbindung\r\n  RX_EMPTY,      \/\/ nichts empfangen\r\n  RX_READY       \/\/ es steht was im Empfangspuffer\r\n}USB_HID_RXSTATUS_t;<\/pre>\n
Funktionen :<\/strong><\/p>\n
void UB_USB_HID_Init(void);                                 \/\/ zum init der USB-Schnittstelle\r\nUSB_HID_STATUS_t UB_USB_HID_GetStatus(void);                \/\/ USB Status abpr\u00fcfen\r\nErrorStatus UB_USB_HID_SendData(uint8_t *ptr, uint8_t len); \/\/ zum senden von Daten per USB\r\nUSB_HID_RXSTATUS_t UB_USB_HID_ReceiveData(uint8_t *ptr);    \/\/ zum empfangen von Daten per USB<\/pre>\n
Beispiel :<\/strong><\/p>\n
\/\/--------------------------------------------------------------\r\n\/\/ File     : main.c\r\n\/\/ Datum    : 23.06.2013\r\n\/\/ Version  : 1.0\r\n\/\/ Autor    : UB\r\n\/\/ EMail    : mc-4u(@)t-online.de\r\n\/\/ Web      : www.mikrocontroller-4u.de\r\n\/\/ CPU      : STM32F4\r\n\/\/ IDE      : CooCox CoIDE 1.7.0\r\n\/\/ Module   : CMSIS_BOOT, M4_CMSIS_CORE\r\n\/\/ Funktion : Demo der USB-HID-Library\r\n\/\/ Hinweis  : Diese zwei Files muessen auf 8MHz stehen\r\n\/\/              \"cmsis_boot\/stm32f4xx.h\"\r\n\/\/              \"cmsis_boot\/system_stm32f4xx.c\"\r\n\/\/--------------------------------------------------------------\r\n\r\n#include \"main.h\"\r\n#include \"stm32_ub_usb_hid.h\"\r\n\r\nint main(void)\r\n{\r\n  uint8_t buf[HID_OUT_BUFFER_SIZE]; \/\/ puffer f\u00fcr Datenempfang\r\n  USB_HID_RXSTATUS_t check=RX_EMPTY;\r\n\r\n  SystemInit(); \/\/ Quarz Einstellungen aktivieren\r\n\r\n  \/\/ Init vom USB-OTG-Port als HID-Device\r\n  UB_USB_HID_Init();\r\n\r\n  while(1)\r\n  {\r\n    \/\/ Test ob USB-Verbindung zum PC besteht\r\n    if(UB_USB_HID_GetStatus()==USB_HID_CONNECTED) {\r\n      \/\/ Ceck ob Daten per USB empfangen wurden\r\n      check=UB_USB_HID_ReceiveData(buf);\r\n      if(check==RX_READY) {\r\n        \/\/ wenn Daten empfangen wurden\r\n        \/\/ als Echo wieder zur\u00fccksenden\r\n        UB_USB_HID_SendData(buf,HID_OUT_BUFFER_SIZE);\r\n      }\r\n    }\r\n  }\r\n}\r\n<\/pre>\n
Hier die Library zum\u00a0Download :<\/strong><\/p>\n
ub_stm32f4_usb_hid_v100<\/a><\/p>\n
Hier der komplette CooCox-Projektordner zum\u00a0Download :<\/strong><\/p>\n
Demo_48_USB_HID<\/a><\/p>\n
Hier der Link zu dem PC-Programm :<\/p>\n
PC-Programme<\/a><\/p>\n
19 Antworten auf 48-USB_HID-Library (STM32F4)<\/em><\/h3>\n
    \n
  1. \n
    \n
    \"\"Peter<\/cite> sagt:<\/span><\/div>\n
    <\/p>\n
    25. Juni 2013 um 17:25<\/div>\n
    <\/p>\n
    \n
    Hallo,
    \ndanke f\u00fcr ein weiteres Demo!<\/p>\n
    Zur Warning in USBD_HID_DataOut ein paar Infos:
    \nder * bei *USB_HID_OUT_BUF in Zeile 345 macht keinen Sinn. Mit dem * \u00fcbergibst du das erste Zeichen des USB_HID_OUT_BUF als dessen Adresse. So kopiert USB_OTG_ReadPacket die Daten in\u2019s Nirvana. Wenn man den * weg l\u00e4sst, gibt es keine Warning, daf\u00fcr funktioniert das Demo nicht mehr. Kommentiert man die Zeile 345 aus, funktionert es wieder.
    \nTiefer bin ich nicht eingestiegen.<\/p>\n
    Das erfreulich ist, dass der Treiber hier nicht so \u2018zickt\u2019 wie beim CDC. Hier kann man einen Reset beim Discovery ausf\u00fchren, auch wenn das PC Programm noch Verbindung hat. Eine neue Verbindung kann dann ohne Neustart des PC Programms erfolgen.<\/p>\n<\/div>\n<\/div>\n
    <\/li>\n
  2. \n
    \n
    \"\"Hannes<\/cite> sagt:<\/span><\/div>\n
    <\/p>\n
    16. Juli 2013 um 09:37<\/div>\n
    <\/p>\n
    \n
    Hallo,
    \nich habe vermutlich zeitgleich mit dir an einer USB HID L\u00f6sung gebastelt und bin leider erst jetzt auf deine tolle Seite und USB Lib gesto\u00dfen! Wirklich eine gute Arbeit.
    \nDein Terminalprogramm ist auch spitze, hatte noch keine Probleme damit!!
    \n(fr\u00fcher habe ich auch den SimpleHidWrite verwendet).<\/p>\n
    Nun noch meine Fragen an dich:
    \n– Ist es m\u00f6glich eine zus\u00e4tzliche Funktion bei dem Terminalprog einzubauen, dass die Bufferanzeige wahlweise als HEX oder ASCII dargestellt wird??
    \n– Hast du bei deiner Suche zum USB HID eine L\u00f6sung oder Beispielprog gefunden wo der USB mit DMA arbeitet oder wei\u00dft du wie man die USB Lib von ST auf DMA umstellen kann?<\/p>\n
    Vielen Dank!
    \nSG Hannes<\/p>\n<\/div>\n<\/div>\n
    <\/p>\n