Toggle search
Toggle menu
26
23
1
553
KNAS Wiki
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

The Ekdahl FAR - Command reference: Difference between revisions

From KNAS Wiki
More actions
← Older edit
VisualWikitext
No edit summary
No edit summary
 
(6 intermediate revisions by the same user not shown)
Line 60: Line 60:
|[variable number (0-9)]:[value (float)]
|[variable number (0-9)]:[value (float)]
|Sets or returns the user variable defined in the first ''parameter,'' if used to set the variable, the second ''parameter'' is the value.
|Sets or returns the user variable defined in the first ''parameter,'' if used to set the variable, the second ''parameter'' is the value.
|-
|expressionparserevaluate
|epev
|[expression]
|Evaluates the given ''expression'' and returns the calculated value. Used for debugging
|-
|testadclatency
|tal
|[value (0 - 65535)]
|Debugging command to test ADC latency
|-
|testadclatencyreturn
|talr
|none
|Stops ADC latency testing started with ''tal''
|-
|testadcminmac
|tamm
|[channel]
|Debugging command to test the min/max value for a given ''channel''
|}
MIDI commands
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|midiconfiguration
|midiconfiguration
Line 105: Line 135:
|<nowiki>[conditional (0|1)]</nowiki>
|<nowiki>[conditional (0|1)]</nowiki>
|Clears the entire ''MIDI'' buffer of notes held and turns off any bowing
|Clears the entire ''MIDI'' buffer of notes held and turns off any bowing
|}
ADC / Control box commands
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|adccommandmap
|adccommandmap
Line 125: Line 165:
|[channel]:[averages]:[interrupterrorthreshold]:[continuouserrorthreshold]:[continuoustimeout]
|[channel]:[averages]:[interrupterrorthreshold]:[continuouserrorthreshold]:[continuoustimeout]
|Sets the settings for the ''averager'' used for the given ''Control box analog-to-digital channel''. ''Averages'' denote number of values read and averaged, ''interrupterrorthreshold'' sets the value change required for the ''Control box'' to report a new value. The ''continuouserrorthreshold'' and ''continuoustimeout'' are used to allow for ''continuous'' changes. See the ''firmware'' for more information
|Sets the settings for the ''averager'' used for the given ''Control box analog-to-digital channel''. ''Averages'' denote number of values read and averaged, ''interrupterrorthreshold'' sets the value change required for the ''Control box'' to report a new value. The ''continuouserrorthreshold'' and ''continuoustimeout'' are used to allow for ''continuous'' changes. See the ''firmware'' for more information
|-
|expressionparserevaluate
|epev
|[expression]
|Evaluates the given ''expression'' and returns the calculated value. Used for debugging
|-
|testadclatency
|tal
|[value (0 - 65535)]
|Debugging command to test ADC latency
|-
|testadclatencyreturn
|talr
|none
|Stops ADC latency testing started with ''tal''
|-
|testadcminmac
|tamm
|[channel]
|Debugging command to test the min/max value for a given ''channel''
|}
|}
MIDI commands
The ''local'' commands as of this writing (2025-01-26) are:
The ''local'' commands as of this writing (2025-01-26) are:
{| class="wikitable"
{| class="wikitable"
|+
|+
Line 158: Line 182:
|[bow (0)]
|[bow (0)]
|Sets the ''current bow.'' This command is intended for future versions of the Ekdahl FAR that may have more than one ''bow'' per ''string module.'' Currently '0' is the only valid ''parameter''
|Sets the ''current bow.'' This command is intended for future versions of the Ekdahl FAR that may have more than one ''bow'' per ''string module.'' Currently '0' is the only valid ''parameter''
|-
|bowstatus
|bs
|none
|Outputs debugging data. Deprecated
|-
|pickupstringfrequency
|psf
|none
|Returns the fundamental frequency calculated from the current audio signal if, applicable
|-
|pickupaudiopeak
|pap
|none
|Returns the peak amplitude of the current audio signal
|-
|pickupaudiorms
|par
|none
|Returns the [[wikipedia:Root_mean_square|RMS]] amplitude of the current audio signal
|-
|bowdebugmeasuretimetotarget
|bdmtt
|[frequency]
|Measure the time it takes to change from the current frequency to the target frequency, used to debug the ''PID''
|-
|bowhome
|bh
|none
|Homing bow, used at startup and in case of the bow loosing position
|-
|bowcalibrateall
|bca
|none
|Performs all calibration routines for a single bow available in the given firmware
|-
|bowcalibratespeed
|bcf
|none
|Performs a ''bowing speed calibration''
|-
|bowcalibratepressure
|bcp
|none
|Performs a ''pressure calibration''
|-
|nooperation
|nop
|none
|Do absolutely, positively, nothing
|}
Commands setting parameters relating to the bow PID
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|bowpid
|bowpid
Line 198: Line 282:
|none
|none
|Returns the last ''error value'' measured in between the ''set point'' and the ''process variable''
|Returns the last ''error value'' measured in between the ''set point'' and the ''process variable''
|}
Commands relating to bow frequency control
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|bowcontrolfrequecy
|bowcontrolfrequecy
Line 248: Line 342:
|<nowiki>[mode (0|1)]</nowiki>
|<nowiki>[mode (0|1)]</nowiki>
|Sets the ''speed mode'' where ''0 = Automatic'' and ''1 = Manual''. The only difference in between these two modes is that ''Automatic'' will automatically turn off the motor when the bow has been set in its ''rest position'' and no frequency changing ''commands'' have been sent within the time period given by ''bowmotortimeout''
|Sets the ''speed mode'' where ''0 = Automatic'' and ''1 = Manual''. The only difference in between these two modes is that ''Automatic'' will automatically turn off the motor when the bow has been set in its ''rest position'' and no frequency changing ''commands'' have been sent within the time period given by ''bowmotortimeout''
|}
Commands for controlling harmonic series
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|bowharmonicseries
|bowharmonicseries
Line 254: Line 358:
|Sets the ''current harmonic series''
|Sets the ''current harmonic series''
|-
|-
|bowharmonicserieslist
|bowharmonicseriesdata
|bhsl
|bhsl
|[(set  only) series]:[(set only) name]:[ratios]
|[(set  only) series]:[name]:[ratios]
|Sets <u>all</u> ''ratios'' and the ''name'' of the ''harmonic list'' in the given ''series''. There can be any number of ''ratio''-parameters and this effectively sets the number of ''harmonics'' per octave. If required, empty ''harmonic lists'' will be added until ''slot'' is a valid number. On return, only returns ''ratios'' of the ''current harmonic list'' (takes no ''parameters'')
|Sets <u>all</u> ''ratios'' and the ''name'' of the ''harmonic list'' in the given ''series''. There can be any number of ''ratio''-parameters and this effectively sets the number of ''harmonics'' per octave. If required, empty ''harmonic lists'' will be added until ''slot'' is a valid number. On return, requires [series] and returns ''name'' and ''ratios'' of the ''harmonic series'' given
|-
|-
|bowharmonicseriesratio
|bowharmonicseriesratio
Line 276: Line 380:
|bowharmonicseriessave
|bowharmonicseriessave
|bhss
|bhss
|[name]:[series]
|[series]:[name]
|Saves the current ''harmonic series'' into the slot given by the second ''parameter'' with the name give in the first ''parameter''. Note that this ''command'' does <u>not</u> save it into flash memory
|Saves the current ''harmonic series'' into the slot given by the second ''parameter'' with the name give in the first ''parameter''. Note that this ''command'' does <u>not</u> save it into flash memory
|-
|-
Line 283: Line 387:
|[series]
|[series]
|Removes the ''harmonic series'' given in the ''parameter''. Shifts all ''series''' with a higher ''series'' number
|Removes the ''harmonic series'' given in the ''parameter''. Shifts all ''series''' with a higher ''series'' number
|-
|}
|bowstatus
 
|bs
Commands relating to the bowing motor
|none
 
|Outputs debugging data. Deprecated
{| class="wikitable"
|-
|+
|pickupstringfrequency
!Long name
|psf
!Short name
|none
!Parameters
|Returns the fundamental frequency calculated from the current audio signal if, applicable
!Description
|-
|pickupaudiopeak
|pap
|none
|Returns the peak amplitude of the current audio signal
|-
|pickupaudiorms
|par
|none
|Returns the [[wikipedia:Root_mean_square|RMS]] amplitude of the current audio signal
|-
|bowdebugmeasuretimetotarget
|bdmtt
|[frequency]
|Measure the time it takes to change from the current frequency to the target frequency, used to debug the ''PID''
|-
|bowhome
|bh
|none
|Homing bow, used at startup and in case of the bow loosing position
|-
|bowcalibrateall
|bca
|none
|Performs all calibration routines for a single bow available in the given firmware
|-
|bowcalibratespeed
|bcf
|none
|Performs a ''bowing speed calibration''
|-
|bowcalibratepressure
|bcp
|none
|Performs a ''pressure calibration''
|-
|-
|bowmotorrun
|bowmotorrun
Line 388: Line 457:
|[command string]
|[command string]
|Sets the ''commands'' to execute when the ''bowing motor'' is over the power limit, <u>used to safeguard the motor, '''can ruin the instrument if improperly set'''</u>
|Sets the ''commands'' to execute when the ''bowing motor'' is over the power limit, <u>used to safeguard the motor, '''can ruin the instrument if improperly set'''</u>
|}
Commands for controlling bow pressure
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|bowpressurebaseline
|bowpressurebaseline
Line 438: Line 517:
|<nowiki>[(0|1)]</nowiki>
|<nowiki>[(0|1)]</nowiki>
|Sets ''bow hold'' off or on. If ''bow hold'' is on, any ''bowpressurerest''-command will be ignored until ''bowpressurehold'' is set to off. Analog to the concept of ''infinite sustain''
|Sets ''bow hold'' off or on. If ''bow hold'' is on, any ''bowpressurerest''-command will be ignored until ''bowpressurehold'' is set to off. Analog to the concept of ''infinite sustain''
|}
Commands for solenoid control
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|solenoid
|solenoid
Line 473: Line 562:
|[duration (0 - 65535)]
|[duration (0 - 65535)]
|Sets the duration of the ''solenoid engagement'' in ɥS. if a value of ''0'' is set the ''solenoid'' will not disengage until a ''solenoiddisengage-''command has been given. This latter behavior is <u>not encouraged</u> as it <u>'''can ruin the instrument if improperly used'''</u>
|Sets the duration of the ''solenoid engagement'' in ɥS. if a value of ''0'' is set the ''solenoid'' will not disengage until a ''solenoiddisengage-''command has been given. This latter behavior is <u>not encouraged</u> as it <u>'''can ruin the instrument if improperly used'''</u>
|}
Commands for controlling the mute
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|mutesetposition
|mutesetposition
Line 543: Line 642:
|none
|none
|Runs the ''mute calibration''
|Runs the ''mute calibration''
|}
Commands for bow actuators
{| class="wikitable"
|+
!Long name
!Short name
!Parameters
!Description
|-
|-
|bowactuatoradd
|<s>bowactuatoradd</s>
|baa
|baa
|none
|none
Line 554: Line 663:
|Removes the ''actuator'' given in the ''parameter''
|Removes the ''actuator'' given in the ''parameter''
|-
|-
|bowactuatorset
|<s>bowactuatorset</s>
|bas
|bas
|[actuator]
|[actuator]
|Sets the ''current actuator'' to the number given in the ''parameter''
|Sets the ''current actuator'' to the number given in the ''parameter''
|-
|-
|bowactuatorload
|<s>bowactuatorload</s>
|bal
|bal
|none
|none
Line 571: Line 680:
|bowactuatordata
|bowactuatordata
|bad
|bad
|[actuator]:[engage]:[max]:[rest]:[name]
|[actuator]:[engage]:[max]:[rest]:[id]
|Sets the ''bow pressure position engage, bow pressure position max, bow pressure position rest'' and ''actuator name'' of the ''actuator'' given by the first ''parameter''
|Sets the ''bow pressure position engage, bow pressure position max, bow pressure position rest'' and ''actuator id'' of the ''actuator'' given by the first ''parameter''
|-
|-
|bowactuatorcount
|bowactuatorcount
Line 579: Line 688:
|Returns the number of saved ''actuators''
|Returns the number of saved ''actuators''
|-
|-
|s
|<s>bowactuatorid</s>
|
|bai
|
|id
|
|Sets the ''id'' of the ''current actuator''
|}
|}
a{{docnav
Please note that ''commands'' may be added or subtracted from this list as the Ekdahl FAR ''firmware'' development progresses, the most sincere attempts will be made to keep this list up to date but no guarantees will be made.{{docnav
|[[The Ekdahl FAR - Command langue|Command language]]
|[[The Ekdahl FAR - Command langue|Command language]]
|[[The Ekdahl FAR - Specifications|Specifications]]
|[[The Ekdahl FAR - Specifications|Specifications]]
}}
}}
Retrieved from "http://knasmusic.com/wiki/index.php?title=The_Ekdahl_FAR_-_Command_reference"