HX3 Flash for OEMs: Unterschied zwischen den Versionen

Aus KeyboardPartner Wiki
Zur Navigation springenZur Suche springen
KKeine Bearbeitungszusammenfassung
 
(13 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
==Customizable updater==
'''Information given here is intended for OEM use only.'''
'''Information given here is intended for OEM use only.'''


Due to some demand I changed the '''HX3 Flash updater''' app behaviour.
Due to some demand I changed the '''[[HX3 Flash Application]]''' behaviour.


Former versions of '''[[HX3 Flash]]''' looked what firmware was installed on the HX3 board and tried to determine what might be adequate to install. That often lead to unwanted results if parameters in new firmware changed significantly. Or I had a lot of work implementing minor parameter changes for various OEM *.hex files.
Former versions of ''HX3 Flash'' checked what firmware was installed on the HX3 board and tried to determine what might be adequate to install. That often lead to unwanted results if parameters in new firmware changed significantly. Or I had a lot of work implementing minor parameter changes for various OEM *.hex files.


The new '''HX3 Flash''' is customizable by OEMs like you, so it might be completely adapted to your needs. You might prepare a package for your customers like the Flash_*.ZIPs on
The new ''HX3 Flash'' is customizable by OEMs like you, so it might be completely adapted to your needs. You might prepare a package for your customers like the Flash_*.ZIPs on [https://github.com/keyboardpartner/HX3/tree/master/LATEST our Github repository], containing only the necessary files for a specific instrument. The behaviour of ''HX3 Flash'' is controlled by an INI file named ''hx3_flash_config.ini'' which is human-readable and may be customized by a simple text editor or by HX3 Flash itself. Just raise ''HX3 Flash'' windows fully to the right (dragging its right border). The control script is visible now and may be edited directly. Click "Save Configuration INI" to make changes permanent. Content of ''hx3_flash_config.ini'' looks like this example:


https://github.com/keyboardpartner/HX3/tree/master/LATEST
/// Configuration file for HX3 MIDI Expander      ///
 
  /// Extend to other parameters at own discretion  ///
containing only the necessary files for a specific instrument. The behaviour of HX3 Flash is controlled by an INI file named '''hx3_flash_config.ini''' which is human-readable and may be edited by a simple text editor. Content of INI looks like this example:
  /// Disable lines with comment char '/' at start ///
 
  / Configuration file for HX3 Standard Organ
[BoardInfo]=
  / Disable lines with comment char '/' at start
  / Extend to other parameters at own discretion
/// Disable update of user info or licences by commenting. WARNING: old licences will be overwritten if enabled.
new_user_name=Hans Wurst
  /new_organ_licence=7654321
/new_rotary_licence=1234567
   
   
  [Files]=
  [Files]=
   
   
  / The firmware_name is just shown in HX3 flash window.
  /// this name is showed in HX3 Flash window, nothing else.
  firmware_name=HX3 StandardOrgan
  firmware_name=HX3 Expander
   
   
  / Files to use. Must be present in same folder.
  /// Disable loading/update of particular file by commenting.
  avr_filename=HX3mk3_std.hex
  avr_filename=HX3mk3_expander.hex
  fpga_filename=fpga_20122015.bit
  fpga_filename=fpga_20122015.bit
/// If FPGA is updated, all taper_levels files, fir_coeff and dsp_rev must be activated as well.
  taper1_filename=taper_levels1.dat
  taper1_filename=taper_levels1.dat
  taper2_filename=taper_levels2.dat
  taper2_filename=taper_levels2.dat
  taper3_filename=taper_levels3.dat
  taper3_filename=taper_levels3.dat
  taper4_filename=taper_levels4.dat
  taper4_filename=taper_levels4.dat
fir_coeff_filename=fir_coeff.dat
dsp_rev_filename=dsp_rev.bin
/// If FPGA is updated, at least MIDI and the scan core used in your instrument must be activated.
/scancore0_filename=HX_CHAIN.DAT
scancore1_filename=HX_MIDI.DAT
scancore2_filename=HX_FATAR.DAT
/scancore3_filename=HX_SR44.DAT
/scancore4_filename=HX_SR49.DAT
/scancore5_filename=HX_SR61.DAT
/scancore6_filename=HX_TEST.DAT
/scancore7_filename=HX_XB2.DAT
   
   
  [ButtonEnables]=
  [ButtonEnables]=
   
   
  / Disable buttons that should not be used
  /// Disable HX3 Flash buttons that should not be used
   
   
  restore_organ=false
  restore_organ=false
Zeile 40: Zeile 55:
  [Parameters]=
  [Parameters]=
   
   
  / parameters that must be restored to old value end with '=?'
  /// parameters that must be restored to old value end with '=?'
  / Boolean on/off values are 255 or 0
  /// Disable lines with comment char '/' at start
/ Disable lines with comment char '/' at start
   
   
  / MIDI Channel:
  / MIDI Channel:
Zeile 53: Zeile 67:
  439=?
  439=?
  / ScanCore:
  / ScanCore:
  477=?
  /477=?
  / Analog input Enable:
  / Analog input Enable:
  478=?
  /478=?
  / Button mask PL7:
  / Button mask PL7:
  479=?
  /479=?
  / Button mask PL11:
  / Button mask PL11:
  480=?
  /480=?
  / Preset number to select second drawbar set:
  / Preset number to select second drawbar set:
  483=?
  /483=?
  / No splitted Preset16 panel:
  / No splitted Preset16 panel:
  484=?
  /484=?
  / Save tabs to presets:
  / Save tabs to presets:
  485=?
  /485=?
   
   
  / parameters to set do have a value
  /// parameters to set must have a value behind '=', boolean values are 0 (off) or 255 (on)
/ Boolean values are 0 or 255
  /// Disable lines with comment char '/' at start
  / Disable lines with comment char '/' at start
   
   
  / Jack config A:
  / Jack config A:
Zeile 76: Zeile 89:
  /439=18
  /439=18
  / ScanCore:
  / ScanCore:
  477=0
  /477=1
  / Button mask PL7:
  / Button mask PL7:
  479=255
  /479=255
  / Button mask PL11:
  / Button mask PL11:
  480=240
  /480=240
  / Preset number to select second drawbar set:
  / Preset number to select second drawbar set:
  483=1
  /483=1
  / No splitted Preset16 panel:
  / No splitted Preset16 panel:
  /484=0
  /484=0
Zeile 90: Zeile 103:
  [End]
  [End]


As you see, you can decide which buttons are enabled and which parameters have to be tweaked '''after''' firmware was installed. '''User Name''' and '''Licences''' are always retained.  
Lines can be disabled by placing a comment character '/' in first column. As you see, you can decide which buttons are enabled and which parameters have to be tweaked '''after''' the new firmware was installed. '''User Name''' and '''Licences''' are always restored to old values. You may force ''HX3 Flash'' to write new user/licence info by ''new_user_name='', ''new_organ_licence='' and ''new_rotary_licence='' command. '''Warning:''' Existing licence numbers will be overwritten!


Therefore, you may adjust parameters to your taste or to requirements of your instrument - without urging me to re-compile just for some parameter issues. All parameter numbers given in HX3 Remote pages are valid, so you may even change rotary params or MIDI CCs.
Therefore, you may adjust parameters to your taste or to requirements of your instrument - without urging me to re-compile just for some parameter issues. All parameter numbers given in HX3 Remote pages are valid, so you may even change rotary params or MIDI CCs.
For your convenience, I left some parameters in which are disabled by '/' comment character. You may enable them just by removing the leading '/' and change values to your needs. Please note: Valid parameter commands must start with a digit, no spaces or comments are allowed in a command line. Blank lines or comment lines may be inserted anywhere.
'''Do not change''' the ''[xxx]='' section separator lines.

Aktuelle Version vom 11. Januar 2016, 08:33 Uhr

Information given here is intended for OEM use only.

Due to some demand I changed the HX3 Flash Application behaviour.

Former versions of HX3 Flash checked what firmware was installed on the HX3 board and tried to determine what might be adequate to install. That often lead to unwanted results if parameters in new firmware changed significantly. Or I had a lot of work implementing minor parameter changes for various OEM *.hex files.

The new HX3 Flash is customizable by OEMs like you, so it might be completely adapted to your needs. You might prepare a package for your customers like the Flash_*.ZIPs on our Github repository, containing only the necessary files for a specific instrument. The behaviour of HX3 Flash is controlled by an INI file named hx3_flash_config.ini which is human-readable and may be customized by a simple text editor or by HX3 Flash itself. Just raise HX3 Flash windows fully to the right (dragging its right border). The control script is visible now and may be edited directly. Click "Save Configuration INI" to make changes permanent. Content of hx3_flash_config.ini looks like this example:

/// Configuration file for HX3 MIDI Expander      ///
/// Extend to other parameters at own discretion  ///
/// Disable lines with comment char '/' at start  ///

[BoardInfo]=

/// Disable update of user info or licences by commenting. WARNING: old licences will be overwritten if enabled. 
new_user_name=Hans Wurst
/new_organ_licence=7654321
/new_rotary_licence=1234567

[Files]=

/// this name is showed in HX3 Flash window, nothing else.
firmware_name=HX3 Expander

/// Disable loading/update of particular file by commenting.
avr_filename=HX3mk3_expander.hex
fpga_filename=fpga_20122015.bit

/// If FPGA is updated, all taper_levels files, fir_coeff and dsp_rev must be activated as well.
taper1_filename=taper_levels1.dat
taper2_filename=taper_levels2.dat
taper3_filename=taper_levels3.dat
taper4_filename=taper_levels4.dat
fir_coeff_filename=fir_coeff.dat
dsp_rev_filename=dsp_rev.bin

/// If FPGA is updated, at least MIDI and the scan core used in your instrument must be activated.
/scancore0_filename=HX_CHAIN.DAT
scancore1_filename=HX_MIDI.DAT
scancore2_filename=HX_FATAR.DAT
/scancore3_filename=HX_SR44.DAT
/scancore4_filename=HX_SR49.DAT
/scancore5_filename=HX_SR61.DAT
/scancore6_filename=HX_TEST.DAT
/scancore7_filename=HX_XB2.DAT

[ButtonEnables]=

/// Disable HX3 Flash buttons that should not be used

restore_organ=false
restore_presets=true
restore_midi=true

[Parameters]=

/// parameters that must be restored to old value end with '=?'
/// Disable lines with comment char '/' at start

/ MIDI Channel:
433=?
/ Split default mode:
/436=?
/ Jack config A:
438=?
/ Jack config B:
439=?
/ ScanCore:
/477=?
/ Analog input Enable:
/478=?
/ Button mask PL7:
/479=?
/ Button mask PL11:
/480=?
/ Preset number to select second drawbar set:
/483=?
/ No splitted Preset16 panel:
/484=?
/ Save tabs to presets:
/485=?

/// parameters to set must have a value behind '=', boolean values are 0 (off) or 255 (on)
/// Disable lines with comment char '/' at start

/ Jack config A:
/438=1
/ Jack config B:
/439=18
/ ScanCore:
/477=1
/ Button mask PL7:
/479=255
/ Button mask PL11:
/480=240
/ Preset number to select second drawbar set:
/483=1
/ No splitted Preset16 panel:
/484=0
/ Save tabs to presets:
/485=1

[End]

Lines can be disabled by placing a comment character '/' in first column. As you see, you can decide which buttons are enabled and which parameters have to be tweaked after the new firmware was installed. User Name and Licences are always restored to old values. You may force HX3 Flash to write new user/licence info by new_user_name=, new_organ_licence= and new_rotary_licence= command. Warning: Existing licence numbers will be overwritten!

Therefore, you may adjust parameters to your taste or to requirements of your instrument - without urging me to re-compile just for some parameter issues. All parameter numbers given in HX3 Remote pages are valid, so you may even change rotary params or MIDI CCs.

For your convenience, I left some parameters in which are disabled by '/' comment character. You may enable them just by removing the leading '/' and change values to your needs. Please note: Valid parameter commands must start with a digit, no spaces or comments are allowed in a command line. Blank lines or comment lines may be inserted anywhere.

Do not change the [xxx]= section separator lines.