More actions
No edit summary |
No edit summary |
||
| Line 23: | Line 23: | ||
|module | |module | ||
|m | |m | ||
|[module number] | |[module number (0)] | ||
|Sets the current ''module''. This command is intended for future versions of the Ekdahl FAR that may have more than one ''string module.'' Currently '0' is the only valid ''parameter'' | |Sets the current ''module''. This command is intended for future versions of the Ekdahl FAR that may have more than one ''string module.'' Currently '0' is the only valid ''parameter'' | ||
|- | |- | ||
| Line 146: | Line 146: | ||
|Debugging command to test the min/max value for a given ''channel'' | |Debugging command to test the min/max value for a given ''channel'' | ||
|} | |} | ||
The ''local'' commands as of this writing (2025-01-26) are: | |||
{| class="wikitable" | |||
|+ | |||
!Long name | |||
!Short name | |||
!Parameters | |||
!Description | |||
|- | |||
|bow | |||
|bow | |||
|[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'' | |||
|- | |||
|bowpid | |||
|bpid | |||
|<nowiki>[conditional (0|1)]</nowiki> | |||
|Sets whether the [[wikipedia:Proportional–integral–derivative_controller|Proprtional-Integral-Deriviate controller]] is on or off. For all normal operation, the ''PID'' should be turned on. If it is turned off the instrument will not be able to play specific frequencies, but will only respond to ''bowmotordirectpwm''-commands | |||
|- | |||
|bowpidki | |||
|bpki | |||
|[float] | |||
|Sets the ''ki''-value of the ''PID'' | |||
|- | |||
|bowpidkp | |||
|bpkp | |||
|[float] | |||
|Sets the ''kp-''value of the ''PID'' | |||
|- | |||
|bowpidkd | |||
|bpkd | |||
|[float] | |||
|Sets the ''kd''-value of the ''PID'' | |||
|- | |||
|bowpidintegratorerror | |||
|bpie | |||
|[float] | |||
|Sets the minimum ''error value'' required in between the ''set point'' and the ''process variable'' for the integrator part of the ''PID'' to initiate correction | |||
|- | |||
|bowpidmaxerror | |||
|bpme | |||
|[float] | |||
|Sets the maximum error correction attempted in each call to the ''PID loop'' | |||
|- | |||
|bowpidr | |||
|bpir | |||
|none | |||
|Resets all data stored by the ''PID'' | |||
|- | |||
|bowpidpeakerror | |||
|bpperr | |||
|none | |||
|Returns the last ''error value'' measured in between the ''set point'' and the ''process variable'' | |||
|- | |||
|bowcontrolfrequecy | |||
|bcf | |||
|[float] | |||
|Sets the frequency (in Hertz) that the ''bowing motor'' should attempt to run at | |||
|- | |||
|bowcontrolfundamental | |||
|bcu | |||
|[float] | |||
|Sets the ''fundamental frequency'' that all ''harmonics'' are using as its base for calculations | |||
|- | |||
|bowcontrolharmonic | |||
|bch | |||
|[float] | |||
|Sets the ''harmonic number'' to use to calculate the ''motor speed''. See ''bowcontrolharmonicadd'' and ''bowcontrolharmonicbase'' | |||
|- | |||
|bowcontrolharmonicadd | |||
|bcha | |||
|[float] | |||
|Sets the number of ''harmonic numbers'' to add or remove to the value given in ''bowcontrolharmonic'' and ''bowcontrolharmonicbase''. Can be negative values | |||
|- | |||
|bowcontrolharmonicbase | |||
|bchb | |||
|[float] | |||
|Sets the ''harmonic number'' to use to calculate the ''motor speed'' but uses the value set by ''bowcontrolharmonicbasenote'' as its base. Includes any value set by ''bowcontrolharmonicadd'' and overwrites any value set by ''bowcontrolharmonic'' | |||
|- | |||
|bowcontrolharmonicbasenote | |||
|bchbn | |||
|[midi key (0-127)] | |||
|Sets the ''MIDI'' key to use as the base for ''bowcontrolharmonicbase'' | |||
|- | |||
|bowcontrolharmonicshift | |||
|bchsh | |||
|[value (-32767 - 32767)] | |||
|Sets how much to shift the ''motor speed'' away from the ''harmonic number'' set by ''bowcontrolharmonic'' or ''bowcontrolharmonicbase''. The ''harmonic shift'' is dependent on the range set by ''bowcontrolharmonicshiftrange''. Also see ''bowcontrolharmonicshift5'' | |||
|- | |||
|bowcontrolharmonicshiftrange | |||
|bchsr | |||
|[harmonics (0-36)] | |||
|Sets the range of the ''bowcontrolharmonicshift''-command. The ''parameter'' given denotes how many ''harmonic numbers'' to shift from the current ''harmonic number'' when the maximum ''harmonic shift'' has been set. | |||
|- | |||
|bowcontrolharmonicshift5 | |||
|bchs5 | |||
|[value (-32767 - 32767)] | |||
|Sets how much to shift the ''motor speed'' away from the ''harmonic number'' set by ''bowcontrolharmonic'' or ''bowcontrolharmonicbase''. Unlike ''bowcontrolharmonicshift'' this value is <u>always</u> calculated on a range of 5 octaves, meaning a maximum ''harmonic shift'' will equal 5 times the amount of ''harmonic ratios'' in the current ''harmonic table''. This value is added to the ''harmonic shift'' set by ''bowcontrolharmonicshift'' | |||
|- | |||
|bowcontrolspeedmode | |||
|bcsm | |||
|<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'' | |||
|- | |||
| | |||
| | |||
| | |||
| | |||
|} | |||
a{{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]] | ||
}} | }} | ||