NAME

       sense_emu_gui - Sense HAT emulator

       The  Sense HAT emulator application. This GTK application provides an interactive interface for emulating
       the Raspberry Pi Sense HAT.

SYNOPSIS

          sense_emu_gui

USAGE

       [image]

       The main window is divided into four parts. At the left is a visual  representation  of  the  Sense  HAT.
       Scripts  using  the  emulator  library  (sense_emu)  to  set the HAT's LEDs will display the result here.
       Immediately below the LEDs are the rotation buttons which rotate the view of the HAT. These buttons  also
       affect the action of the joystick buttons (covered below).

       To  the  right  of the LEDs are three sliders representing the temperature, pressure, and humidity of the
       emulated HAT's environment.

       NOTE:
          The emulation does not precisely reflect the settings  of  the  temperature,  pressure,  and  humidity
          sliders.  Random  errors  are introduced that scale according to the sensor specifications, and as the
          sliders are adjusted, the sensor value will gradually drift towards the new setting at a similar  rate
          to the sensors on the real HAT.

       On the far right of the window, three sliders provide the orientation of the emulated HAT in terms of yaw
       (rotation  around the vertical Z axis), pitch (rotation around the Y axis), and roll (rotation around the
       X axis). Adjusting these sliders affect the accelerometer, gyroscope, and magnetometer (compass)  sensors
       on  the emulated HAT. The emulated HAT assumes gravity runs vertically in the direction of the Z axis (as
       in the real HAT), and that North is in the direction of the X axis.

       Finally, at the bottom right of the window, a series of buttons are provided to emulate the  joystick  on
       the  HAT.  The buttons will simulate press, release, and hold events generated by the real joystick. When
       the view of the HAT is rotated, the joystick buttons will act in the new  orientation  of  the  HAT.  For
       example,  initially  the  "up" button will send "up" events. After the HAT is rotated 90° the "up" button
       will send "right" events. After another 90° rotation, the "up" button will send "down" events, and so on.

       NOTE:
          The emulator must be run prior to starting any scripts which expect  to  use  the  sense_emu  library.
          However,  the  emulator  can be terminated (and restarted) while scripts using the library are running
          (obviously, when the emulator isn't running sensor errors can't be emulated and  all  sensor  readings
          will  appear  fixed).  Attempting to spawn more than one instance of the emulator will simply activate
          the existing instance.

PREFERENCES

       On slower Pis in particular, you may wish to disable  some  aspects  of  the  emulation  for  performance
       purposes.  From  the "Edit" menu, select "Preferences".  In the window that appears you can control which
       aspects of the emulation are enabled, and what speed the screen updates will be limited to.  [image]

       You can also control the appearance of angles for the orientation sliders (note that  this  is  a  purely
       visual preference; it doesn't affect the output of the emulated sensors in any way).

REPLAY

       Recordings  of  actual  sensor  readings  from  a Sense HAT can be replayed within the emulator. From the
       "File" menu, select "Replay recording". From the file selection dialog that appears, select the recording
       you wish to replay and click "Open".  The replay will immediately begin, with progress displayed in a bar
       at the bottom of the main window. You can click "Stop" (next to the progress bar) to  terminate  playback
       of the recording.  [image]

       During playback, the sensor sliders will move according to the data in the recording but will be disabled
       (to prevent the user affecting the replay). At the end of the replay (or immediately after termination of
       playback), the sliders will be left at their present positions and re-enabled.

AUTHOR

       Raspberry Pi Foundation

COPYRIGHT

       2016-2021 Raspberry Pi Foundation

1.2                                               Sep 02, 2021                                  SENSE_EMU_GUI(1)