{"id":479,"date":"2017-11-24T23:53:05","date_gmt":"2017-11-24T22:53:05","guid":{"rendered":"http:\/\/mikrocontroller.bplaced.net\/wordpress\/?page_id=479"},"modified":"2017-12-30T19:39:05","modified_gmt":"2017-12-30T18:39:05","slug":"72-hc_sr04-library-stm32f4","status":"publish","type":"page","link":"https:\/\/mikrocontroller.bplaced.net\/wordpress\/stm32f4\/komplette-library-liste-stm32f4\/72-hc_sr04-library-stm32f4\/","title":{"rendered":"72-HC_SR04-Library (STM32F4)"},"content":{"rendered":"

\u2190<\/span> 71-AM2301-Library (STM32F4)<\/a><\/div><\/div>
73-FreeRTOS-Library (STM32F4) →<\/span><\/a><\/div><\/div><\/p>\n

Mit dieser Library kann der Ultraschall-Abstands-Sensor vom Typ (HC-SR04) an die STM32F4-CPU angeschlossen werden.<\/p>\n

Wieder ein DANKE an \u201cJoerg<\/strong>\u201d f\u00fcr den Sensor<\/p>\n

Das Modul wird an 5V angeschlossen und mit einem 10 us langen Hi-Impuls \u00fcber den Pin \u201cTrigger\u201d zu einer Abstandsmessung veranlasst.<\/p>\n

Die L\u00e4nge vom Hi-Pegel am \u201cEcho-Pin\u201d die das Modul daraufhin zur\u00fcckliefert ist ein Ma\u00df f\u00fcr den ermittelten Abstand.<\/p>\n

Der Sensor soll laut Datenblatt Abst\u00e4nde von 2 cm bis 400 cm mit einer Aufl\u00f6sung von 3 mm Messen k\u00f6nnen. Ich habe hier etwa 5 cm bis 130 cm messen k\u00f6nnen, das h\u00e4ngt wohl sehr viel von der Umgebung ab.<\/p>\n

Ein Hinweis zur Benutzung der Library : Der gemessene Abstandswert wird als \u201cfloat\u201d in \u201ccm\u201d zur\u00fcckgeliefert und bei einem Timeout (z.B. wenn kein Sensor angeschlossen ist oder wenn der Abstand > 5m) , wird eine -1 als Fehlererkennung zur\u00fcckgeliefert)<\/p>\n

Nach der Messung macht die Funktion ein Delay von 60ms (der Wert steht im H-File) weil laut Datenblatt der Sensor nicht schneller abgefragt werden soll.
\n(falls ihr in eurem Programm sicherstellt das eh nicht schneller gepollt wird, k\u00f6nnt ihr das l\u00f6schen)<\/p>\n

Hinweis zur Pinbelegung : Der Trigger-Pin kann im H-File beliebig gew\u00e4hlt werden, aber der Echo-Pin muss zum benutzten Timer passen (weil der im Input-Capture-Mode betrieben wird)<\/p>\n

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

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

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

PA0 = Echo-Pin\r\nPD3 = Trigger-Pin<\/pre>\n
Voraussetzungen :<\/strong><\/p>\n
Benutzte Module der CooCox-IDE : GPIO, TIM, MISC\r\nBenutzte Librarys : keine<\/pre>\n
Funktionen :<\/strong><\/p>\n
void UB_HCSR04_Init(void);          \/\/ init vom Sensor\r\nfloat UB_HCSR04_Distance_cm(void);  \/\/ Abstandsmessung (in cm)<\/pre>\n
Beispiel :<\/strong><\/p>\n
\/\/--------------------------------------------------------------\r\n\/\/ File     : main.c\r\n\/\/ Datum    : 22.12.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.4\r\n\/\/ GCC      : 4.7 2012q4\r\n\/\/ Module   : CMSIS_BOOT, M4_CMSIS_CORE\r\n\/\/ Funktion : Demo der HC-SR04-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_led.h\"\r\n#include \"stm32_ub_hcsr04.h\"\r\n\r\nint main(void)\r\n{\r\n  float abstand;\r\n\r\n  SystemInit(); \/\/ Quarz Einstellungen aktivieren\r\n\r\n  \/\/ init der LEDs\r\n  UB_Led_Init();\r\n\r\n  \/\/ init vom HC-SR04\r\n  UB_HCSR04_Init();\r\n\r\n  while(1)\r\n  {\r\n    \/\/ Messung vom Abstand\r\n    abstand=UB_HCSR04_Distance_cm();\r\n    if(abstand>0) {\r\n      \/\/ LEDs je nach Entfernung schalten\r\n      UB_Led_Off(LED_RED);\r\n      UB_Led_On(LED_ORANGE);\r\n      if(abstand<10.0) UB_Led_On(LED_GREEN); else UB_Led_Off(LED_GREEN);\r\n      if(abstand<15.0) UB_Led_On(LED_BLUE); else UB_Led_Off(LED_BLUE);\r\n    }\r\n    else {\r\n      \/\/ au\u00dferhalb vom Messbereich\r\n      UB_Led_On(LED_RED);\r\n      UB_Led_Off(LED_GREEN);\r\n      UB_Led_Off(LED_BLUE );\r\n      UB_Led_Off(LED_ORANGE);\r\n    }\r\n  }\r\n}\r\n<\/pre>\n
Hier die Library zum\u00a0Download :<\/strong><\/p>\n
ub_stm32f4_hcsr04_v100<\/a><\/p>\n
Hier der komplette CooCox-Projektordner zum\u00a0Download :<\/strong><\/p>\n
Demo_72_HCSR04<\/a><\/p>\n
\n
12 Antworten auf 72-HC_SR04-Library (STM32F4)<\/em><\/h3>\n
    \n
  1. \n
    \n
    \"\"Joerg<\/cite> sagt:<\/span><\/div>\n
    <\/p>\n
    22. Dezember 2013 um 22:59<\/div>\n
    <\/p>\n
    \n
    ich hat die Dinger schon ein paar Jahre liegen, vielleicht durch Alterung die nur noch geringe Reichweite. Am Atmega damals war gr\u00f6\u00dferer Abstand m\u00f6glich soweit ich mich erinnere.<\/p>\n<\/div>\n<\/div>\n
    <\/li>\n
  2. \n
    \n
    \"\"Christoph<\/cite> sagt:<\/span><\/div>\n
    <\/p>\n
    12. M\u00e4rz 2014 um 12:12<\/div>\n
    <\/p>\n
    \n
    hi!<\/p>\n
    zun\u00e4chst mal Gl\u00fcckwunsch und Dank f\u00fcr deine Arbeit. Da hast du schon eine Menge auf die Beine gestellt.<\/p>\n
    Ich habe aber auch eine Frage bzw. ein Problem mit dem Code. Eigentlich ist es vielleicht eher ein Verst\u00e4ndnisproblem bei der Timer Initialisierung:
    \nDu bildest du Differenz von 2 Capture Zeiten.
    \nstart=TIM_GetCapture1(TIM2);
    \nstop=TIM_GetCapture2(TIM2);
    \nHCSR04.delay_us=start-stop;
    \nAber woher kommen denn 2 Zeiten der Trigger ist doch nur der Receive Pin, also Input 1. Verstehe nicht wie das gedacht ist und funktioniert.<\/p>\n
    Kurzes Feedback mit Erkl\u00e4rung w\u00e4re genial!<\/p>\n<\/div>\n<\/div>\n
    <\/li>\n
  3. \n
    \n
    \"\"Christoph<\/cite> sagt:<\/span><\/div>\n
    <\/p>\n
    12. M\u00e4rz 2014 um 12:34<\/div>\n
    <\/p>\n
    \n
    Schande \u00fcber mich \u2013 kurz nach Hilferuf erkenne ich, dass der periph. driver offenbar eine spezielle Funktion TIM_PWMIConfig() hat. Der wird dann wohl die beiden channels scharf schalten.
    \nSorry, habe ich fast 4 Stunden nicht geblickt. Man sieht aber auch den Nachteil eines Treiberpaketes gegen\u00fcber einzelnem Bitsetzen ist. Man muss die Funktionen kennen da hilft das Datenblatt nicht \";-)\"<\/p>\n<\/div>\n<\/div>\n
    <\/li>\n
  4. \n
  5. \n
    \n
    \"\"Niels<\/cite> sagt:<\/span><\/div>\n
    <\/p>\n
    23. April 2015 um 11:10<\/div>\n
    <\/p>\n
    \n
    Hi,<\/p>\n
    This code works realy well. I\u2019m trying to get more ultrasones to work, one after the other. I can\u2019t get it to work. Can you give me some tips for it?<\/p>\n
    Tanks.<\/p>\n<\/div>\n<\/div>\n
    <\/p>\n