x52output(1) command line frontend for the x52pro library

SYNOPSIS

x52output text 0 'First Line'
x52output text 1 'Second Line'
x52output text 2 'Third Line'
x52output bri 0 40
x52output bri 1 50
x52output led 1 1 # not available for old X52
x52output time 1 12 20
x52output date 7 10 17
x52output second 30 # YOKE only
x52output offset 0 1 0 90 # set 90 minutes offset on time display 2

DESCRIPTION

x52output is a command line frontend for the x52pro MFD library. It is intended for debugging and/or scripting purposes.

The x52pro MFD library provides access to the display/LEDS of following SAITEK pro flight devices

  • X52 Pro Flight Control System
  • X52 Flight Control System
  • X52 Pro Flight Yoke.

x52output has following sub-commands:

text line text
Outputs a single line of text to one of the three lines on the x52/x52pro MFD. line is a number from 0 to 2, text is an alphanumeric text of length 16. Some graphical characters are also supported but no work has currently been spent on charset compatibility.

bri mfd brightness
Sets the brightness of either the button LEDs (x52pro only) or the MFD. mfd=0 selects the buttons and mfd=1 selects the MFD. brightness is a decimal value in the range from 0 to 127.

led led-idx color
Sets the led color of one of the x52pro buttons. led-idx is a value from 1 to 19. The meaning of the led-idx values are specified in the next paragraph.

time h24 hour minute
Sets the time shown on the MFD. h24=0 displays the time in AM/PM notation, h24=1 displays the time in 24 Hour notation. hour is a value from 0 to 24 while minute is a value from 0 to 60.

date year month mday
Sets the date shown on the MFD. year, month, and mday are just values from 0 to 99. Using this order will show as YY-MM-DD on the MFD but it is possible to use the three values in any order preferred.

second second
Sets the second value shown on the Pro Flight Yoke MFD. Can be a value from 0 to 59.

offset offset
Sets the time offset of the secondary and tertiary time display of the x52/x52pro MFD. idx=0 selects the secondary display while idx=1 selects the tertiary display. neg=0 sets a positive offset, neg=1 sets a negative offset. offset is in minutes from 0 to 1023.

led-idx for the led sub-command can be one of the following values:

1
LED(s) of Fire Button
2
Red LED of A Button
3
Green LED of A Button
4
Red LED of B Button
5
Green LED of B Button
6
Red LED of D Button
7
Green LED of D Button
8
Red LED of E Button
9
Green LED of E Button
10
Red LED of T1 Switch
11
Green LED of T1 Switch
12
Red LED of T2 Switch
13
Green LED of T2 Switch
14
Red LED of T3 Switch
15
Green LED of T3 Switch
16
Red LED of Coolie Hat
17
Green LED of Coolie Hat
18
Red LED of i Button
19
Green LED of i Button

x52output needs write access to the raw x52 USB device. This package is supplied with udev rules for providing write access on the SAITEK MFD joysticks to the plugdev group members. If x52output fails, permission problems can be checked by means of running it with sudo.

EXIT STATUS

If the joystick/yoke is not found x52output will return a status code of 1. In every other situation it will return a status code of 0. This includes malformed command lines.

BUGS

x52output can currently control only a single SAITEK mfd device. If there are more than one devices attached to the system, the first will always be used.

AUTHOR

Written by Eduard Hasenleithner <[email protected]>