Das Oszi Protocol - Revision history

Bert: /* 0x02 Read sample data */ update translation

2012-04-02T11:43:17Z

‎0x02 Read sample data: update translation

Bert: /* 0x43 Keycode senden */ translation

2012-04-01T14:09:53Z

‎0x43 Keycode senden: translation

Bert: /* 0x7F Init DSO */ translation

2012-04-01T13:49:55Z

‎0x7F Init DSO: translation

Bert: /* 0x60 Datei updaten */ translation

2012-04-01T13:45:15Z

‎0x60 Datei updaten: translation

Bert: /* 0x50 Datei senden */ translation

2012-04-01T13:39:53Z

‎0x50 Datei senden: translation

Bert: /* 0x45 Interpolation anpassungen */ translation

2012-04-01T13:25:11Z

‎0x45 Interpolation anpassungen: translation

Bert: /* 0x44 DSO Buzzer */ translation

2012-04-01T08:19:25Z

‎0x44 DSO Buzzer: translation

Bert: /* 0x42 FPGA Register beschreiben */ translation

2012-04-01T07:44:25Z

‎0x42 FPGA Register beschreiben: translation

Bert: /* 0x00 Read FPGA register */

2012-04-01T07:39:49Z

‎0x00 Read FPGA register

Bert: /* 0x00 Read FPGA register */

2012-04-01T07:38:12Z

‎0x00 Read FPGA register

← Older revision		Revision as of 11:43, 2 April 2012
Line 247:		Line 247:

	The sample data are post-processed from the image memory. The values are 10 DIV vertical (-127 to 127) and 20 DIV horizontal.		The sample data are post-processed from the image memory. The values are 10 DIV vertical (-127 to 127) and 20 DIV horizontal.
		+
		+	Note: the actual number may be closer to 10.2 DIV vertically (510 pixels). Horizontally, the number is 16 DIV (640 pixels) with menu visible and 19.2 DIV (768 pixels) without menu.
		+
		+	A list of the amount of memory depth per channel is available here in PDF format: http://www.mikrocontroller.net/articles/Datei:Sampledaten.pdf

	If the window timebase is smaller than the main timebase, only the visible part of the data is transmitted (see http://www.mikrocontroller.net/topic/205820?page=4#2613537).		If the window timebase is smaller than the main timebase, only the visible part of the data is transmitted (see http://www.mikrocontroller.net/topic/205820?page=4#2613537).

@@ Line 1,049: / Line 1,049: @@
 <br/>
-=== 0x43 Keycode senden ===
+=== 0x43 Send keycode ===
-Ermöglicht einen Keycode zu senden. Der Unterschied zum 0x53 Normales Meldung [[#0x13_Tastendruck_ausl.C3.B6sen|Tastendruck_auslösen]] ist dabei sehr einfach, es werden auch speziele Keycodes unterstüzt und nicht nur die die Tasten representieren.
+This function lets you send a keycode. The difference from the normal '''0x53 message''' [[#0x13_Keypress_trigger|Keypress trigger]] function is that this supports additional "special" keycodes, not just actual keys.
-Beispiel1 (DST1xxxB/BV) : Die Taste F6 während sie gedrückt wird hat den debug Keycode <66> (Keycode 0x06 aus der '''0x53 Normale Meldung'''[[#0x13_Tastendruck_ausl.C3.B6sen|Tastendruck_auslösen]]) + 0x3C). Während die losgelassen wird hat die Taste F6 den debug Keycode <194> (Keycode 0x06 aus der '''0x53 Normale Meldungen'''[[#0x13_Tastendruck_ausl.C3.B6sen|Tastendruck_auslösen]]) + 0xBB).
+For example on the DST1xxxB/BV when the F6 key is pressed, it generates the debug keycode 0x42 (normal keycode 0x06 + 0x3c). When released, this generates the debug keycode 0xc2 (normal keycode 0x06 + 0xbc). This holds true for all keys in the '''keyprotocol.inf''' file.
-Vereinfacht gesagt - jeweilige Zeilennummer auf keyprotocol.inf + 0x3B beim Taste drücken und jeweilige Zeilennummer + 0xBA beim loslassen.
-Beispiel2 (Hantek DSO5xxxB, Voltcraft DSO-3062C, Tekway DST1xxxB) : Die Taste F6 während sie gedrückt wird hat den debug Keycode <7> (Keycode 0x06 aus der '''0x53 Normale Meldung'''[[#0x13_Tastendruck_ausl.C3.B6sen|Tastendruck_auslösen]]) + 1). Während die losgelassen wird hat die Taste F6 den debug Keycode <135> (Keycode 0x06 aus der '''0x53 Normale Meldungen'''[[#0x13_Tastendruck_ausl.C3.B6sen|Tastendruck_auslösen]]) + 1 + 0x80). Vereinfacht gesagt - jeweilige Zeilennummer aus der keyprotocol.inf beim Taste drücken und jeweilige Zeilennummer + 0x80 beim loslassen.
+For the Hantek DSO5xxxB/Voltcraft DSO-3062C/Tekway DST1xxxB, the values to add to the normal keycodes are 0x01 for keypress, and 0x81 for key release.
-−
-Diese beiden Beispiele zeigen wie unübersichtlich Hantek programmiert.
-−
-Die "0x43 Keycode senden" Funktion erlaubt beide debug Keycodes zu senden.
-Es ist sogar möglich mehrere "clicks" zu senden was sehr interessant für Remote Control sein kann (2 x Utility, 2 x Page, 1 x F1 drucken).
 {| style="color:white" border="0" cellpadding="4"
 |-
 | bgcolor="red"        align="center" rowspan="2" | 0x43
-| bgcolor="darkyellow" align="center" colspan="2" | Länge
+| bgcolor="darkyellow" align="center" colspan="2" | Length
 | bgcolor="darkblue"   align="center" rowspan="2" | 0x43
-| bgcolor="blue"   align="center" rowspan="2" | 0x.. (debug Keycode)
+| bgcolor="blue"   align="center" rowspan="2" | 0x.. (debug keycode)
-| bgcolor="blue"   align="center" rowspan="2" | 0x.. (Anzahl der clicks)
+| bgcolor="blue"   align="center" rowspan="2" | 0x.. (number of times)
-| bgcolor="green"      align="center" rowspan="2" |Checksumme
+| bgcolor="green"      align="center" rowspan="2" |Checksum
 |-
 |bgcolor="darkyellow" align="center" | LSB
@@ Line 1,076: / Line 1,071: @@
 |}
-Die Antwort ist leer. D.h. sie enthält kein Datenbyte.
+The response contains no data bytes:
-−
 {| style="color:white" border="0" cellpadding="4"
 | bgcolor="red"        align="center" | 0x43
@@ Line 1,083: / Line 1,077: @@
 | bgcolor="darkyellow" align="center" | 0x00
 | bgcolor="darkblue"   align="center" | 0xC3
-| bgcolor="green"      align="center" | Checksumme 0x08
+| bgcolor="green"      align="center" | 0x08
 |-
 |}
 === 0x44 DSO Buzzer ===

@@ Line 1,216: / Line 1,216: @@
 === 0x7F Init DSO ===
-Die Anfrage ist leer. D.h. sie enthält kein Datenbyte.
+The request contains no data bytes:
-−
 {| style="color:white" border="0" cellpadding="4"
 | bgcolor="red"        align="center" | 0x43
@@ Line 1,227: / Line 1,226: @@
 |}
-Dies ruft folgende DSO Subroutinen in der Firmware:
+Internally, this calls the following functions in the firmware:
- PauseSysAcq
+* PauseSysAcq
- Acq_InitAcqParam
+* Acq_InitAcqParam
- Acq_SyncEqualAcq
+* Acq_SyncEqualAcq
- SyncChDispWhenEnterX
+* SyncChDispWhenEnterX
- SyncBodeAssiant
+* SyncBodeAssiant
- SyncDsoScanSwitch
+* SyncDsoScanSwitch
- InitCalculationManageParam
+* InitCalculationManageParam
- InitAcqWaveEvent
+* InitAcqWaveEvent
- InitDispWaveEvent
+* InitDispWaveEvent
- InitWaveSoftEvent
+* InitWaveSoftEvent
- Init_SwapTrig
+* Init_SwapTrig
- Tdc_SyncTdcTable
+* Tdc_SyncTdcTable
- Limites_Init
+* Limites_Init
- InitLcdUnwaveareaShow
+* InitLcdUnwaveareaShow
- InitLcdWaveAreaShow
+* InitLcdWaveAreaShow
- InitDsoOtherStat
+* InitDsoOtherStat
- UpdateSysRunParam
+* UpdateSysRunParam
- Fpga_SetTrigHoldTime
+* Fpga_SetTrigHoldTime
- Sync_AutoDispInterval
+* Sync_AutoDispInterval
- ContinueSysAcq
+* ContinueSysAcq
- ForceShowWinBar
+* ForceShowWinBar
-Die Auswirkung ist nicht die selbe wie bei einem Neustart da nicht alle Init Subroutinen aufgerufen werden, allerdings ausreichend um z.b. DSO Variablen (siehe [[#0x40_DSO_Firmware_Variablen_schreiben|DSO_Firmware_Variablen_schreiben]]) oder DSO Selbstkalibrierung Daten (siehe [[#0x41_DSO_Selbstkalibrierung_schreiben|DSO_Selbstkalibrierung_schreiben]]) zu aktivieren.
+This is not entirely the same as a reboot since not all init functions are called. However it's enough to use before calling [[#0x40_Write_DSO_firmware_variables|Write DSO firmware variables]] or [[#0x41_Write_DSO_self-calibration|Write DSO self-calibration]].
-−
-Die Antwort ist leer. D.h. sie enthält kein Datenbyte.
 {| style="color:white" border="0" cellpadding="4"
 | bgcolor="red"        align="center" | 0x43
@@ Line 1,262: / Line 1,260: @@
 |-
 |}
+<br/>
-−

@@ Line 1,194: / Line 1,194: @@
 <br/>
-=== 0x60 Datei updaten ===
+=== 0x60 Update file ===
-Diese Funktion kann benutzt werden um eine beliebige Datei auf dem DSO zu ersetzen.
+The function can be used to replace any existing file on the DSO's filesystem.
-Die Anfrage besteht aus drei Paketen wobei das erste Paket (mit Subkommando 0)
+The structure of the request, and the response, is identical to [[#0x50_Write_file|Write file]].
-den vollständigen Dateipfad (Zielpfad), das zweite Paket (mit Subkommando 1) beinhaltet die Daten selber. Sollte die Datei länger als 10000 Bytes sein, werden ein oder mehrere weitere Pakete (mit Subkommando 1) gesendet, solange bis die gesamte Datei gesendet ist. Zum Abschluß wird noch ein Paket gesendet (mit Subkommando 2). Es markiert das Ende der Übertragung und beinhaltet eine Checksumme über alle Bytes der gesendeten Datei.
-−
-{| style="color:white" border="0" cellpadding="4"
-|-
-| bgcolor="red"        align="center" rowspan="2" | 0x43
-| bgcolor="darkyellow" align="center" colspan="2" | Länge
-| bgcolor="darkblue"   align="center" rowspan="2" | 0x60
-| bgcolor="lightblue"  align="center" rowspan="2" | 0x00
-| width="300" bgcolor="blue" align="center" rowspan="2" |Dateipfad
-| bgcolor="green"      align="center" rowspan="2" |Checksumme
-|-
-|bgcolor="darkyellow" align="center" | LSB
-|bgcolor="darkyellow" align="center" | MSB
-|-
-| fgcolor="black"  | ...
-|-
-| bgcolor="red"        align="center" rowspan="2" | 0x43
-| bgcolor="darkyellow" align="center" colspan="2" | Länge
-| bgcolor="darkblue"   align="center" rowspan="2" | 0x60
-| bgcolor="lightblue"  align="center" rowspan="2" | 0x01
-| width="300" bgcolor="blue" align="center" rowspan="2"| Dateiinhalt
-| bgcolor="green"      align="center" rowspan="2" | Checksumme
-|-
-| bgcolor="darkyellow" align="center" | LSB
-| bgcolor="darkyellow" align="center" | MSB
-|-
-| fgcolor="black"  | ...
-|-
-| bgcolor="red"        align="center" | 0x43
-| bgcolor="darkyellow" align="center" | 0x04
-| bgcolor="darkyellow" align="center" | 0x00
-| bgcolor="darkblue"   align="center" | 0x60
-| bgcolor="lightblue"  align="center" | 0x02
-| width="300" bgcolor="blue" align="center" | Dateiprüfsumme (1 Byte)
-| bgcolor="green"      align="center" | Checksumme
-|-
-|}
-−
-Nach jedem dieser Pakete sollte einmal die Antwort abgefragt werden.
-Die Antwort ist leer. D.h. sie enthält kein Datenbyte.
-−
-{| style="color:white" border="0" cellpadding="4"
-| bgcolor="red"        align="center" | 0x43
-| bgcolor="darkyellow" align="center" | 0x02
-| bgcolor="darkyellow" align="center" | 0x00
-| bgcolor="darkblue"   align="center" | 0xE0
-| bgcolor="green"      align="center" | 0x25
-|-
-|}
-−
-Warum auch immer, aber nach dem ersten Paket kommt bei mir
-eine Antwort mit Fehler = 0x11
 {| style="color:white" border="0" cellpadding="4"
 | bgcolor="red"        align="center" | 0x43
@@ Line 1,257: / Line 1,206: @@
 | bgcolor="darkyellow" align="center" | 0x00
 | bgcolor="darkblue"   align="center" | 0xE0
-| bgcolor="darkblue"   align="center" | 0x11 (<- Fehler Code)
+| bgcolor="darkblue"   align="center" | 0x11 (<- error Code)
 | bgcolor="green"      align="center" | 0x37
 |-
 |}
-was eigentlich für "Datei nicht gefunden" steht.
+This stands for "file not found". However, the specified file is correctly replaced.
-Dennoch wird die angegebene Datei korrekt ersetzt.
+<br/>
-−
 === 0x7F Init DSO ===

@@ Line 1,142: / Line 1,142: @@
 <br/>
-=== 0x50 Datei senden===
+=== 0x50 Write file ===
-Diese Funktion kann benutzt werden um eine beliebige Datei auf das DSO zu übertragen.
+This function can be used to store a file on the DSO.
-−
-Die Anfrage besteht aus drei Paketen wobei das erste Paket (mit Subkommando 0)
-den vollständigen Dateipfad (Zielpfad), das zweite Paket (mit Subkommando 1) beinhaltet die Daten selber. Sollte die Datei länger als 10000 Bytes sein, werden ein oder mehrere weitere Pakete (mit Subkommando 1) gesendet, solange bis die gesamte Datei gesendet ist. Zum Abschluß wird noch ein Paket gesendet (mit Subkommando 2). Es markiert das Ende der Übertragung und beinhaltet eine Checksumme über alle Bytes der gesendeten Datei.
 {| style="color:white" border="0" cellpadding="4"
 |-
 | bgcolor="red"        align="center" rowspan="2" | 0x43
-| bgcolor="darkyellow" align="center" colspan="2" | Länge
+| bgcolor="darkyellow" align="center" colspan="2" | Length
 | bgcolor="darkblue"   align="center" rowspan="2" | 0x50
 | bgcolor="lightblue"  align="center" rowspan="2" | 0x00
-| width="300" bgcolor="blue" align="center" rowspan="2" |Dateipfad
+| width="300" bgcolor="blue" align="center" rowspan="2" |File path
-| bgcolor="green"      align="center" rowspan="2" |Checksumme
+| bgcolor="green"      align="center" rowspan="2" |Checksum
 |-
 |bgcolor="darkyellow" align="center" | LSB
@@ Line 1,164: / Line 1,162: @@
 |-
 | bgcolor="red"        align="center" rowspan="2" | 0x43
-| bgcolor="darkyellow" align="center" colspan="2" | Länge
+| bgcolor="darkyellow" align="center" colspan="2" | Length
 | bgcolor="darkblue"   align="center" rowspan="2" | 0x50
 | bgcolor="lightblue"  align="center" rowspan="2" | 0x01
-| width="300" bgcolor="blue" align="center" rowspan="2"| Dateiinhalt
+| width="300" bgcolor="blue" align="center" rowspan="2"| File contents
-| bgcolor="green"      align="center" rowspan="2" | Checksumme
+| bgcolor="green"      align="center" rowspan="2" | Checksum
 |-
 | bgcolor="darkyellow" align="center" | LSB
@@ Line 1,180: / Line 1,178: @@
 | bgcolor="darkblue"   align="center" | 0x50
 | bgcolor="lightblue"  align="center" | 0x02
-| width="300" bgcolor="blue" align="center" | Dateiprüfsumme (1 Byte)
+| width="300" bgcolor="blue" align="center" |File contents checksum (1 byte)
-| bgcolor="green"      align="center" | Checksumme
+| bgcolor="green"      align="center" | Checksum
 |-
 |}
-Nach jedem dieser Pakete sollte einmal die Antwort abgefragt werden.
+A response should be requested after each of the above packets. It contains no data bytes:
-Die Antwort ist leer. D.h. sie enthält kein Datenbyte.
-−
 {| style="color:white" border="0" cellpadding="4"
 | bgcolor="red"        align="center" | 0x43
@@ Line 1,196: / Line 1,192: @@
 |-
 |}
+<br/>
 === 0x60 Datei updaten ===

@@ Line 1,110: / Line 1,110: @@
 <br/>
-=== 0x45 Interpolation anpassungen ===
+=== 0x45 Adjust interpolation ===
-Erlaubt (temporär) änderungen in der Lagrangeschen Interpolation.
+Lets you (temporarily) adjust changes in the Lagrange interpolation. You can set the boundaries (0-1000ps) and change the phases of all ADCs (0x00=0&deg; up to  0xffff=360&deg;). Actually the data from the FIFO are shifted in phase, not the ADCs.
-Soweit ich verstanden habe kann man die Abgrenzungen (0 bis 1000ps)
-setzen und die Phasen aller ADCs (eigentlich die Daten aus im FIFOs werden phasenverschoben und nicht die ADCs) ändern (0=0° bis FFFF=360°).
 {| style="color:white" border="0" cellpadding="4"
@@ Line 1,124: / Line 1,122: @@
 | bgcolor="lightblue"  align="center" | 0x.. init LSB
 | bgcolor="lightblue"  align="center" | 0x.. init MSB
-| width="220" bgcolor="blue" align="center" | 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.. (Phasen ADC 1 bis 8)
+| width="220" bgcolor="blue" align="center" | 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.., 0x.. 0x.. (ADC phases 1-8)
-| bgcolor="green"      align="center" | Checksumme
+| bgcolor="green"      align="center" | Checksum
 |-
 |}
-Die Antwort ist leer. D.h. sie enthält kein Datenbyte.
+The response contains no data bytes:
-−
 {| style="color:white" border="0" cellpadding="4"
 | bgcolor="red"        align="center" | 0x43
@@ Line 1,140: / Line 1,137: @@
 |}
-Die Lagrangesche Interpolation ist nur in den TBID < 3 (also Horizontal Ablenkung 2ns/DIV, 4ns/DIV und 8ns/DIV) eingeschaltet.
+The Lagrange interpolation is enabled only in the TBID < 3 (i.e. horizontal deflection 2ns/DIV, 4ns/DIV and 8ns/DIV).
-Die mögliche Verwendung muß noch erörtert werden.
-−
-'''Bitte beachten - der Syntax ist temporär, evt. auch falsch'''
 === 0x50 Datei senden===

@@ Line 1,018: / Line 1,018: @@
 <br/>
-=== 0x42 FPGA Register beschreiben ===
+=== 0x42 Write FPGA register ===
-−
-Die Anfrage beinhaltet Register Nummer und die Register Daten, siehe auch [[#0x00_FPGA_Register_lesen|FPGA_Register_lesen]]
 {| style="color:white" border="0" cellpadding="4"
 |-
 | bgcolor="red"        align="center" rowspan="2" | 0x43
-| bgcolor="darkyellow" align="center" colspan="2" | Länge
+| bgcolor="darkyellow" align="center" colspan="2" | Length
 | bgcolor="darkblue"   align="center" rowspan="2" | 0x42
-| bgcolor="blue"   align="center" rowspan="2" | 0x00 bis 0xFF (Register Nummer)
+| bgcolor="blue"   align="center" rowspan="2" | 0x00 up to 0xff (register number)
-| bgcolor="blue"   align="center" rowspan="2" | 0x.. 0x.. 0x.. 0x.. (Register Daten)
+| bgcolor="blue"   align="center" rowspan="2" | 0x.. 0x.. 0x.. 0x.. (register value)
-| bgcolor="green"      align="center" rowspan="2" |Checksumme
+| bgcolor="green"      align="center" rowspan="2" |Checksum
 |-
 |bgcolor="darkyellow" align="center" | LSB
@@ Line 1,035: / Line 1,034: @@
 |}
-Die Antwort ist leer. D.h. sie enthält kein Datenbyte.
+The response contains no data bytes:
-−
 {| style="color:white" border="0" cellpadding="4"
 | bgcolor="red"        align="center" | 0x43
@@ Line 1,046: / Line 1,044: @@
 |}
-Intern wird die Firmware Funktion "PcUartWriteFpgaReg" aufgerufen,
+Internally, this calls the firmware function '''PcUartWriteFpgaReg'''.
-die mögliche Verwendung muß noch erörtert werden.
-−
-'''Bitte beachten - der Syntax ist temporär, evt. auch falsch.'''
 === 0x43 Keycode senden ===

@@ Line 782: / Line 782: @@
 | bgcolor="darkblue"   align="center" | 0x00
 | bgcolor="lightblue"  align="center" | 0x00
-| width="300" bgcolor="blue" align="center" | 0x00 up to 0xFF (register number)
+| width="300" bgcolor="blue" align="center" | 0x00 up to 0xff (register number)
 | bgcolor="green"      align="center" | Checksum
 |-

@@ Line 794: / Line 794: @@
 | bgcolor="darkyellow" align="center" | 0x00
 | bgcolor="darkblue"   align="center" | 0x80
-| width="300" bgcolor="blue" align="center" | 0x.. 0x.. 0x.. 0x.. (register values)
+| width="300" bgcolor="blue" align="center" | 0x.. 0x.. 0x.. 0x.. (register value)
 | bgcolor="green"      align="center" | Checksum
 |-