﻿Englisch instructions: Scroll down for [english] section.

=======
Editor Hilfe
=======

Eine ausführliche Bedienungsanleitung finden Sie auf
http://keyboardpartner.remotewebaccess.com/Files/Beta%20Firmware/Bedienungsanleitung_HX35_Editor_55.pdf

Der HX3.5 Editor kann mit dem HX3.5 Mainboard auf verschiedenen Kanälen kommunizieren: 
• vorzugsweise per MIDI over USB mit USB-Kabelverbindung an die USB-B-Buchse auf dem HX3.5-Mainboard oder dem HX3 Extension Board mk5 (nicht aber mk4) oder USB-Buchse am HX3 MIDI Expander,

• über eine bidirektionale MIDI-Verbindung durch die MIDI IN/OUT-Buchsen (angeschlossen über ein handelsübliches USB-MIDI-Interface),

• über ein USB-zu-seriell-Adapterkabel FT232R-5V (erhältlich in unserem Shop). Verbinden Sie das Adapterkabel mit dem USB-Port des PCs und auf dem HX3.5 Mainboard mit dem sechspoligen Steckverbinder PL19, das schwarze Kabel nahe dem schwarzen Steckverbinder PL17,

• über einen USB-zu-seriell-Adapter mit FTDI-Interface-Chip (wie etwa auf unserem alten HX3 Extension Board mk4). Schließen Sie das USB-Kabel an die USB-B-Buchse des HX3 Extension Boards mk4 an (dieser Anschluss läuft intern gleichfalls als serielle Verbindung über einen FTDI-Chip).

Wählen Sie den Kanal, der am besten zu Ihrer Konfiguration passt; alle sind im Editor gleichwertig, mit einer Ausnahme: DSP-Updates sind nur mit "MIDI over USB" möglich. 

Wenn "MIDI over USB" benutzt wird, darf am zweiten MIDI-Eingang (linke DIN-Buchse) kein Kabel angeschlossen sein.  Das gilt auch für den HX3 Drawbar Controller!


Parameterwerte ändern
===============

Um einen Parameterwert zu editieren, klicken Sie in der Spalte Value auf diesen Wert.

Bitte ändern Sie niemals Parameterwerte, deren Zweck Sie nicht genau verstanden haben. Besonders die Gruppen System Inits und Rotary Setup sind kritisch; Änderungen können zu unerwünschten Resultaten führen. 

Rechts unten im Hauptfenster wird ein Hilfe-Text mit Erläuterungen zum jeweiligen Parameter eingeblendet. Abhängig vom Typ des Parameters erscheint beim Anklicken des Wertes ein veränderlicher Scroll-Balken, ein ON/OFF-Schalter oder eine Dropdown-Liste. Einige Parameter enthalten nur eine Zahl ohne spezielle Visualisierung. Unter der Parametertabelle erscheint ein Hilfetext zu der jeweiligen Aktion. 

Klicken Sie oben auf die grünblaue Schaltfläche Get Group, um alle Werte der aktiven Parameter- Gruppe vom HX3.5 abzurufen (etwa Zugriegeleinstellungen, die am Gerät zwischenzeitlich geändert wurden). Set Group sendet alle Werte der aktiven Gruppe an den HX3.5 (was aber kaum je nötig ist, weil die Parameter-Eingabe zumeist „live“ übertragen wird). Die mit Set Group gesendeten Werte bleiben allerdings nicht gespeichert. 


Parameterwerte speichern
================

Änderungen an Parameterwerten werden immer sofort ausgeführt, aber sie bleiben nicht erhalten, sofern die betreffende Parametergruppe nicht gespeichert wird. Der Speicherort hängt vom Parametertyp ab und wird durch eine Farbkodierung der Parameterwerte angezeigt (siehe Legende rechts unten im Hauptfenster des Editors). 

Aktivieren Sie den Reiter Parameters. Klicken Sie in der Tabelle auf einen Parameterwert oder einen der Jump-Buttons, um eine Gruppe für das Speichern zu selektieren. 

Alle schwarz und türkis gefärbten Parameterwerte werden als Common Preset gespeichert. Die Schaltfläche Store Group Values ändert ihre Farbe jeweils entsprechend dem Typ der Parameterwerte. 

Rote Parameterwerte werden als Einschalt-Defaultwert gespeichert; sie gelten für alle Voices und Presets gemeinsam. Diese Einstellungen können bei einem Firmware-Update bei größeren Versionssprüngen verloren gehen. Deshalb sollten Sie vor dem Update eine Backup-Datei anlegen. Siehe Abschnitt Backup. 

Auch pinkfarbenen Werte (System Inits) werden als Einschalt-Defaultwerte für alle Voices und Presets gemeinsam gespeichert. Diese Parameterwerte bleiben auch bei größeren Firmware-Updates unangetastet. Prüfen Sie diese Werte nach einer Änderung Ihrer Hardware-Konfiguration sorgfältig. Prüfen Sie die Werte auch beim ersten Einsatz eines brandneuen Mainboards, das ab Werk als MIDI Expander konfiguriert ist. 

Grau dargestellte Werte sollten nicht geändert werden (nur Lesen, zur Information). 


Hardware-Konfiguration einstellen und ändern
============================

Nach einer Änderung Ihrer Konfiguration (zum Beispiel von Expander auf Zugriegel-Orgel), prüfen Sie bitte die System Inits Parameter im HX3.5 Editor. Diese Werte bleiben auch beim Firmware-Update erhalten. Normalerweise werden diese Werte durch die zu Ihrem Gerät passende „config_xxx.ini“-Datei automatisch eingestellt.

Ab Werk ist unter Parameternummer 1503 die ADC-Einstellung „Swell only“ für den HX3 Expander programmiert. Ändern Sie diese entsprechend Ihrer Konfiguration. 

Außerdem ist der Scan Driver „MIDI only“ installiert. Wenn Sie FatarScan2 oder Scan16/61 verwenden, installieren Sie passenden Scan Driver „scanxxx.dat“, den Sie gleichfalls im Editor-Verzeichnis finden.

Bei spezifischen Konfigurationen prüfen Sie bitte auch die Analog Remaps und die Button Remaps (siehe folgender Abschnitt), denn der HX3.5 Editor setzt hier Default-Werte ein. 

######################################### [english] ######################################### 

=======
Editor Help
=======

Find a comprehensive user manual here:
http://keyboardpartner.remotewebaccess.com/Files/Beta%20Firmware/UserManual_HX35_Editor_55.pdf

Connecting

HX3.5 Editor can connect to the HX3.5 mainboard through several channels: 
• Preferably through MIDI over USB using a USB connection from your PC to the B-type USB Jack of the HX3.5 mainboard or of the HX3 Extension Board mk5 (but not mk4) or to the USB-mini Jack of the HX3 MIDI Expander,

• through a bi-directional MIDI connection (IN/OUT) using a third-party USB MIDI adaptor,

• through our FTDI serial adaptor cable FT232R-5V (available at our shop). Attach USB-to-serial adaptor cable FT232R-5V to the PC USB port and HX3.5 6-pin header PL19, black wire (BK) facing to black header PL17,

• through any FTDI device with FT232 interface chip like the one on our discontinued HX3 Extension Board mk4. Connect the USB cable to the B-type USB jack of the HX3 Extension Board mk4 (internally, this as well goes as USB to serial connection through a FTDI interface).

Choose the channel that fits your configuration best. In the editor application all channels are equal, except for DSP updates, which can be made through MIDI over USB only. 

When using a "MIDI over USB" connection, disconnect any cable from secondary (left) MIDI input DIN jack as both share the same MIDI input line. This applies to the HX3 Drawbar Controller as well!


Parameter Editing
===========

In the column Value click on the parameter line you want to edit.

Please do not change values you don't fully understand. In particular, the System Inits and Rotary Setup group are delicate to changes, which may lead to unwanted results. 

A help text for the selected parameter appears on the right at the bottom of the main window. Depending on type of parameter, either an editable scroll bar, an ON/OFF button or a dropdown list appears on parameter line. Some parameters do not have a special visual control, just the number itself. Below the parameter table a help text is displayed explaining the current action. 

Click on the teal colored Get Group button above to refresh values from HX3.5 board (for example current drawbar settings after moving drawbars at the device). Set Group will send all group values to the HX3.5 (usually not necessary since parameter uplink is always "live"). The values sent by Set Group are not stored permanently though. 


Storing parameter values
===============

Changes to parameters values are executed instantly, but they are temporary until you save their parameter group. Save destination depends on type of the parameter (see color coding at right bottom of main window). 

In the main window, click on the tab Parameters and select a parameter group by clicking on the group button, or click on a parameters value in the table to activate that group for saving. 

The black and teal colored parameter values are saved to common presets. Note that the Store Group Values button changes its color corresponding to the type of the activated parameter values. 

Red colored parameter values are initial default values, which are valid for all voices and presets. Click on Store Group Values to save them as initial default values. These initial default values may get lost in the course of major firmware upgrades. Therefore you should create a backup file before updating. See section Backup. 

Pink colored parameter values (System Inits) are saved as a startup defaults for all voices and presets as well. Click on red Store Group Values button to save as initialization values. These parameters are persistent even with a major firmware update. Examine the values thoroughly, if your hardware configuration has been changed. Also check the values on first-time use of brand new mainboard which is configured as MIDI expander from factory. 

Grayed-out parameters should not be changed (read-only). 


Setting up the Hardware Configuration
========================

After changing the configuration to a different device type (eg. from expander to drawbar organ), check System Inits parameters with HX35 Editor. These values are persistent even when firmware is updated. Normally these values are to be set automatically by the “config_xxx.ini” file suitable for your device.

Factory programming is ADC setting (parameter 1503) "Swell only" for MIDI expander use, so set the configuration according to your needs. 

Also, the “MIDI only” scan driver is installed. If you are using FatarScan2 or Scan16/Scan61, install the appropriate scan driver “scanxxx.dat” contained in the editor directory. 

On custom installations, also check Analog Remaps and Button Remaps (see next section) with HX3.5 Editor as the update will install default values here. 

