HX3.6 Verwendung von SD-Karten: Unterschied zwischen den Versionen

Aus KeyboardPartner Wiki
Zur Navigation springenZur Suche springen
Zeile 81: Zeile 81:
==Dateiliste==
==Dateiliste==


Dateien (benötigt für Update-Skripte):
'''firmware.bin''' - ARM Controller Firmware (Flash-Inhalt)<br>
 
'''fpgamain.bin''' – FPGA-Konfiguration (Sound Engine)<br>
'''firmware.bin''' - AVR Controller Firmware (Flash-Inhalt)<br>
'''eeprom.bin''' - AVR Controller-Daten (EEPROM-Inhalt)<br>
'''hx3_main.bin''' – FPGA-Konfiguration (Sound Engine)<br>
'''scan.dat''' - Scan Driver (entweder MIDI, Fatar oder Scan16/61 Typ)<br>
'''scan.dat''' - Scan Driver (entweder MIDI, Fatar oder Scan16/61 Typ)<br>
'''scanmidi.dat''' - Scan Driver für MIDI Input (MIDI Expander, Drawbar Expander)<br>
'''scanmidi.dat''' - Scan Driver für MIDI Input (MIDI Expander, Drawbar Expander)<br>

Version vom 18. April 2023, 14:22 Uhr

SD-Kartenadapter für bequeme Firmware-Updates

Überblick

Sie können eine mit FAT32 formatierte Standard-SD- oder SDHC-Karte alternativ zum Update über USB-Kabel verwenden. Ein geeigneter SD-Kartenadapter ist in unserem Shop erhältlich. Damit sind Updates auch aus anderen Betriebssystemen möglich.

Schließen Sie den SD-Kartenadapter an PL18 an.

Updates für HX3.5 sind auf unserem Update-Server zum Download verfügbar. Entpacken Sie die zu Ihrem Gerät passende ZIP-Datei in ein lokales Verzeichnis und kopieren Sie die zu aktualisierenden Dateien aus dem sdcard-Verzeichnis auf eine leere, mit FAT32 formatierte (!) SD- oder SDHC-Karte. Das Verzeichnis enthält ggf. eine Untermenge des updates-Verzeichnisses:

  • Controller Firmware (firmware.bin), zuständig für das Verhalten des Bedien-Interface und die Verarbeitung von MIDI-Controllerdaten.
  • FPGA Sound Engine (fpgamain.bin), erzeugt alle Orgel-Klänge
  • Wavesets (wavesetX.bin), Wellenform-Definitionen für verschiedene Orgelmodelle
  • Scan Driver (scanXXX.dat), zuständig für Tastatur-Abfrage und MIDI-Empfang
  • Taperings (taperX.dat), B3/H100-Tongenerator-Filter und Tapering-Definitionen
  • FIR–Koeffizienten (fir_coe.dat), Koeffizienten für die Rotary-Horn-Simulation

In den meisten Fällen wird ein Update ausschließlich der Firmware erfolgen, manchmal auch der FPGA Sound Engine. Teile, die nicht auf der SD-Karte gefunden werden, bleiben unverändert.

Komplette Aktualisierung

Ein Update von der SD-Karte kann nur im HX3.6-Bootloader-Modus erfolgen. Drücken Sie im Preset-Hauptmenü den DOWN-Taster und wählen Sie den Punkt BootLoader Update aus. Setzen Sie die SD-Karte im Kartenslot ein. Drücken Sie den Encoder-Knopf etwa zwei Sekunden, bis im Display System Reset... erscheint. Der Bootloader ist aktiv, wenn unten rechts ein inverses BL auf dem Display erscheint.

Der Bootloader wird automatisch aktiviert, wenn HX3.6 beim Einschalten eine SD-Karte im Slot-Adapter vorfindet.

Wenn Sie den Menüpunkt Update from SD Card bestätigen, wird der HX3.6 Bootloader auf der SD-Karte nach Updates suchen. Dies kann entweder ein DFU-Paket (hx36_update.dfu) sein oder einzelne Dateien (z.B. firmware.bin oder 'fpgamain.bin). Achtung: Das Laden von Presets und Defaults wird Ihre Einstellungen überschreiben, kontrollieren Sie also genau, ob diese Dateien wirklich benötigt werden. In der Regel sind im DFU-Paket keine Defaults und Presets enthalten.

INI-Skripte

In der HX3.6 Firmware (aber nicht im Bootloader!) lassen sich über ein Submenü auch INI-Skripte ausführen. Die verfügbaren INI-Skripte werden im Display aufgelistet, wenn Sie den Drehknopf drehen. Um ein Skript zu starten, halten Sie den Knopf etwa zwei Sekunden lang gedrückt, bis eine „running“-Meldung erscheint.

Im Unterschied zu HX3.5 lassen sich über INI-Skripte keine Firmware-Updates mehr ausführen, dies ist dem Bootloader vorbehalten.

Eigene INI-Skripte

INI-Skripte enthalten gültige HX3.5-Befehle im Textformat und lassen sich mit jedem Texteditor bearbeiten. HX3.5 Befehlsformat:

<parameter1>=<newvalue1>
<parameter2>=<newvalue2>
...

Zum Beispiel "1504=1". Die gültigen Parameter-Nummern und ihre Bedeutung können Sie der Haupttabelle im HX3.5 Editor entnehmen. Die Anzahl der Parameter, die durch eine INI-Datei geändert werden können, ist nicht begrenzt. Alle Änderungen sind flüchtig. Um sie auf Dauer zu speichern, stellen Sie den Befehl "WEN=1" voran und schließen mit WEN=0 (Write EEPROM enable/disable):

/ Unlock EEPROM:
WEN=1
<parameter1>=<newvalue1>
<parameter2>=<newvalue2>
...
/ lock EEPROM:
WEN=0
/ Example
/ Unlock EEPROM:
WEN=1
/ Enable analog Inputs:
1503=2
/ Set Panel 16 to Common Preset buttons:
1504=2
/ lock EEPROM:
WEN=0

Mit eigenen INI-Skripts können Sie spezielle Einstellungen der Orgel und Parameter-Wertzuweisungen vornehmen. Jeder Parameter (außer denen, die mit „not used“, „do not use“ oder einer Beschreibung in Klammern versehen sind) kann durch ein INI-Skript gesetzt werden. Außerdem gibt es besondere Befehle, um etwa binäre Images im Flash-Speicher zu aktualisieren („Cores“, COR X = <dateiname>) oder für die FPGA-Konfiguration (CFG = <dateiname>) selbst. Kommentare in den INI-Dateien beginnen mit dem Zeichen „/“.

/ Sample Script for SD card
/ FPGA Update
CFG=hx3_main.bin
/Various Cores, replace scan driver with Fatar type
COR 0=scanfatr.dat
COR 11=taper1.dat
COR 15=fir_coe.dat
/ Wave-Update
/ Wavesets are 16 KByte = 4x Core size of 4 kWords
COR 16=waveset0.bin
COR 20=waveset1.bin
COR 24=waveset2.bin
COR 28=waveset3.bin
/ Reload all
RLD
/ Done!

Dateiliste

firmware.bin - ARM Controller Firmware (Flash-Inhalt)
fpgamain.bin – FPGA-Konfiguration (Sound Engine)
scan.dat - Scan Driver (entweder MIDI, Fatar oder Scan16/61 Typ)
scanmidi.dat - Scan Driver für MIDI Input (MIDI Expander, Drawbar Expander)
scansr61.dat - Scan Driver für Scan16-Strip und Scan61-Inline Boards (StdOrgan)
scanfatr.dat - Scan Driver für Fatar-Tastatur und FatarScan2 Board (StdOrgan)
fir_coe.dat - Finite Impulse Response Filterparameter für Rotary-Horn-Simulation
taperX.dat - 4 Tapering-Dateien (Tastenlautheit) für Hammond-Emulation
wavesetX.dat - 8 WaveSet-Dateien (Generator-Wellenformen)