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