API ESP32: Unterschied zwischen den Versionen

Aus Wiki-500-Euro-RTM
Wechseln zu: Navigation, Suche
(ESP32 Kommando Übersicht)
(ESP32 Kommando Übersicht)
 
(31 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
= ESP32 Kommando Übersicht =
 
= ESP32 Kommando Übersicht =
 +
 +
 +
Im Folgenden sind die Kommandos beschrieben, mit denen der ESP32 gesteuert wird. Die Kommandos können mit dem PC Programm gesendet werden. Es ist aber auch möglich, ein Terminalprogramm wie z.B. hterm zu verwenden.<br>
 +
Nach dem Poweron-Start sendet der ESP32 zyklisch ''''IDLE'''' über die USB Schnittstelle an den Computer, um seine Bereitschaft zur Annahme eins der folgenden Kommandos anzuzeigen. <br>
 +
 +
 
'''MEASURE'''<br>
 
'''MEASURE'''<br>
 
Beim Empfang vom MEASURE startet der ESP32 einen Messreihe. Er sendet die Messdaten im CSV Format an den PC. <br>
 
Beim Empfang vom MEASURE startet der ESP32 einen Messreihe. Er sendet die Messdaten im CSV Format an den PC. <br>
Format DATA,X,Y,Z<br>
+
Format: DATA,X,Y,Z<br>
Der letzte Datensatz ist DATA,DONE
+
Der letzte Datensatz ist DATA,DONE<br><br>
wird mit "D die Messdateb <br>
+
Der Ablauf eines Mess-Zyklus ist in [[Hauptseite#Mess Zyklus - Ablauf|Mess Zyklus - Ablauf]] beschrieben
Die Messdaten werden im Verzeichnis ''data'' in einer csv Datei gespeichert unter einem Namen, der sich aus Datum und Uhrzeit zusammensetzt. Format ''YYYYMMDD-hhmmss.csv''  
+
 
* ADJUST
+
'''ADJUST'''<br>
Im Adjust Modus kann die Prüfspitze gesteuert werden. X Y und Z Werte können gesetzt werden. Der ADC Wert mit der Spannung aus dem Tunnel-Vorverstärker wird zyklisch ausgegeben. ADJUST wird verwendet, um den Abstand der Prüfspitze über der Probe zu justieren.
+
Bei Empfang von ADJUST sendet der ESP zyklisch den ADC Messwert an den PC.<br>
* PARAMETER
+
'''ADJUST,parameter'''<br>
Parameter zeigt die aktuelen Messparameter an und erlaubt, die Parameter zu setzen. Die gesetzen Parameter werden an den ESP32 übertragen und bleiben dort gespeichert.
+
TIP ??????????????????????<br>
Mit Default werden die Stadard Parameter gesetzt. Bedeutung der Parameter: LINK
+
Ein positiver Parameter bei DAC Z verkleinert den Abstand zwischen Prüfling und Messpitze, ein negativer Parameter vergrössert den Abstand<br><br>
 +
 
 +
'''PARAMETER,?'''<br>
 +
Beim Empfang vom PARAMETER,? schickt der ESP32 die aktuell gespeicherten Messparameter an den Computer.<br>
 +
 
 +
'''PARAMETER,DEFAULT'''
 +
Nach Empfang setzt der ESP32 die Messparaeter auf die default Werte:<br>
 +
kI = 10<br>
 +
kP = 1000<br>
 +
destinationTunnelCurrentnA = 10.0<br>
 +
remainingTunnelCurrentDifferencenA = 0.01<br>
 +
startX = 0<br>
 +
startY = 0<br>
 +
direction = 0<br>
 +
maxX = 199<br>
 +
maxY = 199<br>
 +
multiplicator = 100<br><br>
 +
 
 +
'''PARAMETER,parameter als csv string'''<br>
 +
 
 +
Der ESP32 übernimmt die Parameter aus dem csv-string und speichert sie.<br>
 +
 
 +
'''Bedeutung der Parameter'''<br>
 +
 
 +
destinationTunnelCurrentnA: Sollwert für gültige Messung<br>
 +
remainingTunnelCurrentDifferencenA: Maximale Abweichung vom Sollwert, damit eine Messung gültig ist.<br>
 +
multiplicator: Schrittweite ADC-Werte X und Y für einen Scan – Schritt<br>
 +
 
 +
'''Strg C'''
 +
Strg C stoppt jedes Kommando und löst einen Reset des ESP32 aus (Strg C = CTRL C = ASCI 3)<br>
  
* ADJUST
 
Der Computer sendet 'ADJUST' an den ESP 32. Der ESP32 geht in eine Schleife, in der im Sekundentakt der Tunnelstrom gemessen und ausgegeben wird.
 
* ADJUST,parameter
 
Wird zusätzlich ein Parameter angegeben, ändert sich die Z-Position der Prüfspitze. Ein positiver parameter verkleinert den Abstand zwischen Prüfling und Messpitze, ein negativer Parameter vergrössert den Abstand
 
* MEASURE
 
'Normaler' Prüfzyklus. Es werden bis zu 200*200 X Y Positionen angefahren und nach Abschluss die Messergebnisse an den Computer geschickt
 
Der ESP32 startet einen Messyklus mit typisch 200*200 Messpositionen. Nach der Hälfte der Messungen schickt der ESP32 das erste Paket mit Messdaten an den Computer, nach Abschluss aller Messung das zweite und letzte Paket. Nach Abschluss der Messung sendet der ESP32 'DONE'
 
* PARAMETER,?
 
Nach Empfang von 'PARAMETER,?' sendet der ESP32 seine aktuell gespeicherten Messparameter an den Computer
 
* PARAMETER,DEFAULT
 
Nach Empfang setzt der ESP32 die Messparaeter auf die default Werte:
 
kI = 10
 
kP = 1000
 
destinationTunnelCurrentnA = 10.0
 
remainingTunnelCurrentDifferencenA = 0.01
 
startX = 0
 
startY = 0
 
direction = 0
 
maxX = 199
 
maxY = 199
 
multiplicator = 100
 
• Parameter details:
 
o destinationTunnelCurrentnA:
 
Sollwert für gültige Messung
 
o remainingTunnelCurrentDifferencenA:
 
Maximale Abweichung vom Sollwert, damit eine Messung gültig ist.
 
o multiplicator:
 
Schrittweite ADC-Werte X und Y für einen Scan – Schritt.
 
  
• PARAMETER,parameter als csv string
+
''' Baudrate '''<br>
Der ESP32 übernimmt die Parameter aus dem csv-string und speichert sie.
+
Die Baudrate ist auf 115200 Bit pro Sekunde festgelegt
Beispiel: 'PARAMETER,10,1000,10.0,0.01,0,0,0,199,199,100' setzt die DEFAULT Parameter
 
• Strg C
 
Strg C stoppt jedes Kommando und löst einen Reset des ESP32 aus (Strg C = CTRL C = ASCI 3)
 

Aktuelle Version vom 14. Juni 2023, 17:01 Uhr

ESP32 Kommando Übersicht

Im Folgenden sind die Kommandos beschrieben, mit denen der ESP32 gesteuert wird. Die Kommandos können mit dem PC Programm gesendet werden. Es ist aber auch möglich, ein Terminalprogramm wie z.B. hterm zu verwenden.
Nach dem Poweron-Start sendet der ESP32 zyklisch 'IDLE' über die USB Schnittstelle an den Computer, um seine Bereitschaft zur Annahme eins der folgenden Kommandos anzuzeigen.


MEASURE
Beim Empfang vom MEASURE startet der ESP32 einen Messreihe. Er sendet die Messdaten im CSV Format an den PC.
Format: DATA,X,Y,Z
Der letzte Datensatz ist DATA,DONE

Der Ablauf eines Mess-Zyklus ist in Mess Zyklus - Ablauf beschrieben

ADJUST
Bei Empfang von ADJUST sendet der ESP zyklisch den ADC Messwert an den PC.
ADJUST,parameter
TIP ??????????????????????
Ein positiver Parameter bei DAC Z verkleinert den Abstand zwischen Prüfling und Messpitze, ein negativer Parameter vergrössert den Abstand

PARAMETER,?
Beim Empfang vom PARAMETER,? schickt der ESP32 die aktuell gespeicherten Messparameter an den Computer.

PARAMETER,DEFAULT Nach Empfang setzt der ESP32 die Messparaeter auf die default Werte:
kI = 10
kP = 1000
destinationTunnelCurrentnA = 10.0
remainingTunnelCurrentDifferencenA = 0.01
startX = 0
startY = 0
direction = 0
maxX = 199
maxY = 199
multiplicator = 100

PARAMETER,parameter als csv string

Der ESP32 übernimmt die Parameter aus dem csv-string und speichert sie.

Bedeutung der Parameter

destinationTunnelCurrentnA: Sollwert für gültige Messung
remainingTunnelCurrentDifferencenA: Maximale Abweichung vom Sollwert, damit eine Messung gültig ist.
multiplicator: Schrittweite ADC-Werte X und Y für einen Scan – Schritt

Strg C Strg C stoppt jedes Kommando und löst einen Reset des ESP32 aus (Strg C = CTRL C = ASCI 3)


Baudrate
Die Baudrate ist auf 115200 Bit pro Sekunde festgelegt