User Tools

Site Tools


aircraft:tmd:inputs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
aircraft:tmd:inputs [2019/07/07 17:11]
jh [Rocker Button and Switch]
aircraft:tmd:inputs [2019/07/20 17:11] (current)
jh [input_active]
Line 685: Line 685:
 </​code>​ </​code>​
  
-===== Digital States ​=====+===== Flight Controls ​=====
  
-input_binary,​ input_discrete,​ input_discrete_cyclic,​ input_discrete_momentary,​ input_event,​ input_active,​ input_cyclic,​ input_pair, ​input_default, input_scratchpad+==== input_default ​====
  
-===== Flight ​Controls =====+The input_default is used for all non-discrete (floating point) inputs. 
 + 
 +Typically these are found for light dimmers, trim inputs, etc. which are typically operated with a joystick or with a cockpit dimmer or trim-wheel, etc. but button inputs are also possible with this generic input. 
 + 
 +The ''​Speed''​ is how fast the input responds when a button is pressed and held. With a speed of 0.1 it takes 10 seconds to reach the full deflection 1.0. 
 + 
 +''​Positions''​ is the number of steps that are available when a button is pressed to increment the value. A single press of the button increases the value of the input_default by ( Range.max - Range.min ) /  ( Positions - 1 ). In the example below that is 0.0025 increment per button press, so rather fine trim adjustments can be made. 
 + 
 +<​code> ​           <​[input_default][RudderInput][] 
 +                <​[string8][Input][Controls.Yaw.Input]>​ 
 +                <​[tmvector2d][Range][ -1.0 1.0 ]> 
 +            > 
 +            <​[input_default][PitchTrimInput][] 
 +                <​[string8][Input][Controls.Trim]>​ 
 +                <​[string8][InputEnable][1.0]>​ 
 +                <​[uint][Positions][801]>​ 
 +                <​[tmvector2d][Range][ -1.0 1.0 ]> 
 +                <​[float64][Value][0.0]>​ 
 +                <​[float64][Speed][0.1]>​ 
 +            > 
 +</​code>​ 
 + 
 +==== input_control ​==== 
 + 
 +The input_control behaves much like the input_default but it allows for multiple input devices at the same time. E.g. you could be holding the yoke with your VR hands, then put them down and use your physical yoke instead. The input_control handles these cases and allows a soft transition between multiple devices or even the operation of multiple devices at the same time. 
 + 
 +> Usually the input_control is only used for the elevator and aileron. 
 + 
 +<​code> ​           <​[input_control][ElevatorInput][] 
 +                <​[string8][Input][Controls.Pitch.Input]>​ 
 +                <​[tmvector2d][Range][ -1.0 1.0 ]> 
 +                <​[float64][Value][0.0]>​ 
 +            > 
 +</​code>​ 
 + 
 +===== Other Inputs ===== 
 + 
 +==== input_binary ==== 
 + 
 +The input_binary either outputs 1.0 (true) or 0.0 (false). With messages from the controls it can either be toggled (qualifier ''​toggle''​) or stepped to on or off (step). 
 + 
 +Using [[aircraft:​tmd:​events|Events]] the input_binary can be Set, Reset and Toggled (.Toggle). 
 + 
 +<​code> ​           <​[input_binary][BinaryState][] 
 +                <​[string8][Input][Controls.State]>​ 
 +            > 
 +            <​[input_binary][BinaryState][] 
 +                <​[string8][Input][Controls.State]>​ 
 +                <​[string8][InputEnable][1.0]>​ 
 +                <​[float64][Value][0.0]>​ 
 +            > 
 +</​code>​ 
 + 
 +==== input_discrete ==== 
 + 
 +There are several types of inputs that are represented by an input_discrete,​ a switch with more then two positions, a rotary selector or a digital input (e.g. selected display page). 
 + 
 +  * ''​Input''​ is the message name 
 +  * ''​InputEnable''​ is used to disable any changes, e.g. when electrical power is not applied it is not possible to manipulate the state. 
 +  * ''​Value''​ is the initial position. 
 +  * ''​Range''​ is the minimum and maximum discrete value that can be reached. Use whole numbers here, e.g. (-1.0 1.0) or (0.0 5.0) 
 +  * ''​EventsUp''​ and ''​EventsDown''​ are used to trigger the sound of the switch. **Do not use these for logic only for sound** 
 + 
 +The ''​Toggle''​ property can be used to set and reset the input with subsequent presses of the same button. One button with the message qualifier ''​value''​ and a value of 2.0 for example could turn on option 2 with the first press and then turn it back off (reset to 0.0) with a second push of the button. A good example is the A320 EFIS control panel to display airports, waypoints, VORs, NDBs, etc. Only one can be selected at a time and two pushes of the same button reset the display to no info displayed. 
 + 
 +<​code> ​           <​[input_discrete][SeatbeltSignsSwitch][] 
 +                <​[string8][Input][Controls.SeatbeltSigns]>​ 
 +                <​[string8][InputEnable][1.0]>​ 
 +                <​[string8][Range][ 0.0 2.0 ]> 
 +                <​[float64][Value][0.0]>​ 
 +                <​[string8][EventsUp] ​ [ SwitchSound.Trigger ]> 
 +                <​[string8][EventsDown][ SwitchSound.Trigger ]> 
 +            > 
 +            <​[input_discrete][NDPilotInformation][] 
 +                <​[string8][Input][NavigationDisplayPilot.Information]>​ 
 +                <​[string8][Range][ 0.0 5.0 ]> 
 +                <​[float64][Value][5.0]>​ 
 +                <​[bool][Toggle][true]>​ 
 +            > 
 +</​code>​ 
 + 
 +The input_discrete has an output to the tmd only (''​Output''​). 
 + 
 +==== input_discrete_cyclic ==== 
 + 
 +The input_discrete_cyclic works exactly like the ''​input_discrete''​ but with the addition that is loops back around to the beginning of the range when the value is stepped beyond the range limits. E.g. it cycles through the list of display pages 
 + 
 +<​code> ​           <​[input_discrete_cyclic][ECAMPageManuallyTuned][] 
 +                <​[string8][Input][ECAM.Page]>​ 
 +                <​[string8][InputEnable][ClockOn.Output]>​ 
 +                <​[string8][Range][ 0.0 11.0 ]> 
 +                <​[float64][Value][0.0]>​ 
 +                <​[bool][Toggle][true]>​ 
 +            > 
 +</​code>​ 
 + 
 +==== input_discrete_momentary ==== 
 + 
 +Again very similar to the ''​input_discrete''​ the input_discrete_momentary does pretty much the same with the difference being that the last value in the range cannot stay selected. It returns to the second to last value after a short time when the input is no longer active. 
 + 
 +> Used for the magneto switch and starter or a hold-to-test switch. 
 + 
 +<​code> ​           <​[input_discrete_momentary][MagnetosSwitch][] 
 +                <​[string8][Input][Controls.Magnetos]>​ 
 +                <​[tmvector2d][Range][ 0.0 4.0 ]> 
 +                <​[float64][Value][3.0]>​ 
 +                <​[string8][EventsUp][ MagnetoSwitchSound.Trigger ]> 
 +                <​[string8][EventsDown][ MagnetoSwitchSound.Trigger ]> 
 +            > 
 +</​code>​ 
 + 
 + 
 +==== input_cyclic ==== 
 + 
 +The input_cyclic is an input that loops back around to the beginning when it reaches the end of the ''​Range''​. 
 + 
 +  * ''​Input''​ is the message name 
 +  * ''​InputEnable''​ can be used to disable the input, e.g. if the input is digital and electric power is lost 
 +  * ''​Range''​ is the minimum and maximum value of the input 
 +  * ''​StepSize''​ is the increment when a single step is added, e.g. ''​0.0174532''​ or 1 degree. 
 +  * ''​Value''​ is the initial position 
 + 
 +<​code> ​           <​[input_cyclic][NAV1Course][] 
 +                <​[string8][Input][Navigation.SelectedCourse1]>​ 
 +                <​[string8][InputEnable][1.0]>​ 
 +                <​[tmvector2d][Range][ 0.0 6.283185 ]> 
 +                <​[uint][StepSize][0.0174532]>​ 
 +                <​[uint][Value][1.570796]>​ 
 +            > 
 +</​code>​ 
 + 
 +==== input_pair ==== 
 + 
 +This is the typical frequency input that can be found in all kinds of aircraft. The frequency input has two values at the same time, an active and a standby value. The standby value is adjustable and can be set without having an immediate impact. Then the frequency is transferred (swapped) to the active frequency and the previously active frequency is now the standby frequency. 
 + 
 +  * ''​Input''​ is the message name for the standby value 
 +  * ''​InputSwap''​ is the transfer button message 
 +  * ''​InputEnable''​ can disable the input, e.g. when electrical power is not available 
 +  * ''​Range''​ is the minimum and maximum value for both values 
 +  * ''​Positions''​ is the number of increments within the Range. When the step increment is known (e.g. 50 kHz) and the limits of the Range are known (e.g. 108 MHz to 118 MHz) the Positions is just: ( Range.max - Range.min ) / step + 1, e.g. ( 118000000.0 - 108000000.0 ) / 50000.0 + 1 = 200 + 1 = 201. 
 +  * ''​StepLarge''​ is the number of small steps that make a coarse step. E.g. 20 x 50 kHz = 1 MHz or 40 x 25 kHz = 1 MHz 
 +  * ''​Active''​ and ''​Standby''​ are the initial two values 
 + 
 +For optional automatic frequency tuning (autotuning):​ 
 +  * ''​InputExternal''​ is an autotuning input from the ''​flight_management''​ or ''​autotuning''​ class. 
 +  * ''​Manual''​ is the initial condition weather or not autotuning is on (1.0 if manual control) 
 + 
 +<​code> ​           <​[input_pair][NAV1Frequency][] 
 +                <​[string8][Input] ​   [Navigation.NAV1StandbyFrequency]>​ 
 +                <​[string8][InputSwap][Navigation.NAV1FrequencySwap]>​ 
 +                <​[tmvector2d][Range][ 108000000.0 118000000.0 ]> 
 +                <​[float64][Active] ​ [116000000.0]>​ 
 +                <​[float64][Standby] [114100000.0]>​ 
 +                <​[uint][Positions][201]>​ 
 +                <​[float64][StepLarge][20.0]>​ 
 +            > 
 +            <​[input_pair][NAV1Frequency][] 
 +                <​[string8][Input] ​       [Navigation.NAV1StandbyFrequency]>​ 
 +                <​[string8][InputSwap] ​   [Navigation.NAV1FrequencySwap]>​ 
 +                <​[string8][InputExternal][AutoTuning.OutputNAV1]>​ 
 +                <​[string8][InputEnable] ​ [1.0]> 
 +                <​[tmvector2d][Range][ 108000000.0 118000000.0 ]> 
 +                <​[float64][Active] ​ [116000000.0]>​ 
 +                <​[float64][Standby] [114100000.0]>​ 
 +                <​[uint][Positions][201]>​ 
 +                <​[float64][StepLarge][20.0]>​ 
 +                <​[float64][Manual][0.0]>​ 
 +            > 
 +</​code>​ 
 + 
 +==== input_event ==== 
 + 
 +Receives messages and then fires events with the received message value. 
 + 
 +  * ''​Input''​ is the message name 
 +  * ''​InputValue''​ filters the messages for a specific value, leave the line of code away to not filter for any values 
 +  * All events in the ''​Events''​ list are triggered once a message is received 
 + 
 +The use of the ''​input_event''​ class is described further in the [[aircraft:​tmd:​events|TMD Events]] topic. 
 + 
 +<​code> ​           <​[input_event][Button_Pressed][] 
 +                <​[string8][Input][Controls.Button]>​ 
 +                <​[string8][Events][ DEV0.Trigger ]> 
 +            > 
 +            <​[input_event][Button_Pressed][] 
 +                <​[string8][Input][Controls.Button]>​ 
 +                <​[float64][InputValue][1.0]>​ 
 +                <​[string8][Events][ DEV0.Trigger ]> 
 +            > 
 +</​code>​ 
 + 
 +==== input_active ==== 
 + 
 +Outputs 1.0 to the tmd as long as a lever is grabbed or a button is depressed. 
 + 
 +> Typically this is only used to make a light illuminate as long as a button is pressed or to give visual feedback that a control is grabbed. Don't use this for every single button in combination with an event_edge, this should be done with the ''​input_event''​ class instead. 
 + 
 +<​code> ​           <​[input_active][ButtonDepressed][] 
 +                <​[string8][Input][Controls.Button]>​ 
 +                <​[float64][InputValue][1.0]>​ 
 +            > 
 +</​code>​
  
-input_control 
aircraft/tmd/inputs.1562512299.txt.gz · Last modified: 2019/07/07 17:11 by jh