Quelltext der Seite HX3.6 Verwendung von SD-Karten

[[Datei:Hx35_sdcard.JPG|400px|thumb|right|'''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 [http://updates.keyboardpartner.de/Files/?dir=HX3.6%20Manager%20Current%20Firmware 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.

==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==

Dateien (benötigt für Update-Skripte):

'''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>
'''scanmidi.dat''' - Scan Driver für MIDI Input (MIDI Expander, Drawbar Expander)<br>
'''scansr61.dat''' - Scan Driver für Scan16-Strip und Scan61-Inline Boards (StdOrgan)<br>
'''scanfatr.dat''' - Scan Driver für Fatar-Tastatur und FatarScan2 Board (StdOrgan)<br>
'''fir_coe.dat''' - Finite Impulse Response Filterparameter für Rotary-Horn-Simulation<br>
'''taperX.dat''' - 4 Tapering-Dateien (Tastenlautheit) für Hammond-Emulation<br>
'''wavesetX.dat''' - 8 WaveSet-Dateien (Generator-Wellenformen)<br>