Home

Welcome to the stratux_ahrs wiki!

Here, the correct operation of the app will be explained, as well as details on how to contribute and customize the app for specific uses.

Example Screenshot

This example image was created using simulated data, and shows all visual features of the device.

Parts of the Display

The following image displays some of the parts of the display that may not be inherently obvious.

GPS satellite count is displayed in the lower left corner. If the AHRS CPU is above the threshold specified in the configuration (default 60°C), the TEMP banner will also be displayed, as shown in the example below:

How to Tell Information is Valid

The above image shows what the display looks like when it suspects that data is not valid. This can be caused by a few things:

• There is no AHRS connected (ADS-b off)
• The phone is not on the same network as the AHRS (wrong network)
• The ADSb doesn't have a AHRS module (invalid hardware)
• The connection is temporarily offline, or there is some other error with the data being received (bad data)

If this issue persists and you believe the data and connection should be good (working ADS-b, stopped working "out of the blue", etc.) a good first step is to close the app and restart it, or close and refresh the page in your browser.

There may be times where only portions of the display are shown to be "invalid". This can signify a failure of one system in particular. For example, if the "GPS GS" and "GPS TRK" tapes are invalid, a GPS issue might be the culprit. In this particular case, check the GPS Sat Count badge to see if the system has any satellites. In the above image, the badge is showing "-", which signifies that there are no valid satellites being used.

If the device is in Simulation Mode, a tag, as shown below, will appear in the top left corner of the display. This means that the data shown is not valid. Disable Simulation Mode before using the AHRS. This can be done by editing system.simulate in configuration.js, or by tapping the SIMULATING Banner.

Understand where the data comes from:

There are 3 primary sources of data that the AHRS displays:

• GPS - Used for GPS Speed, GPS Ground Track, and GPS Altitude (if selected)
• IMU (inertial measurement unit) - Used for AHRS attitude information
• Pressure Sensor (Usually attached to the IMU) - Used for Baro Altitude

Each of these sources are relatively independent, so understanding which metrics are dependent on each source can help troubleshoot issues. As a rule of thumb, if all sources are signified as "invalid", there is probably a communication issue between the display and Raspberry pi, especially if ADS-b traffic is correctly being displayed on Foreflight (or other ADS-b wifi display).

Calibrate GYRO and Center Accelerometer

Before departing, it's recommended that you calibrate the GYRO at a minimum, to ensure there is no "drift" in flight. In my experience, calibrating on the ground before the run-up is the easiest time. Calibrating the Accelerometer can be done at this time, though it can also be done in the air when a better straight-and-level attitude can be assumed.

GYRO - On the ground

To calibrate the GYRO, click the "Roll XX°" field at the top right of the AHRS zone. A prompt will be displayed to ensure you want to proceed with the calibration. No message is displayed upon completion- simply allow about 3 seconds for the process to complete.

Accelerometer - On the ground or in flight

To calibrate the Accelerometer, click the "Pitch XX°" field at the top left of the AHRS zone. A prompt will be displayed to ensure you want to proceed with the calibration. No message is displayed upon completion- simply allow about 3 seconds for the process to complete.

Change Altitude and Vertical Speed Source

Altitude and vertical speed can be computed from GPS data, or from pressure altitude data from the IMU's pressure sensor. As a rule of thumb, GPS altitude is closer to actual altitude, but pressure altitude from the IMU is more responsive and produces better vertical speed data. (NOTE: If you have a pressurized cabin, or know your aircraft has a significant separation in cabin pressure vs. outside static pressure, DO NOT use pressure altitude data. Stick to GPS altitude only.)

The source can be easily switched by clicking the teal Altitude Unit field below the altitude tape. The current source will always be displayed in the field ("Baro Altitude", for example).

Simulation at Home

To use simulation data instead of Stratux data (say, for ground testing), the configuration file must be changed: configuration.js:

• Set system.simulate to true. Note that this is the last variable in the "simulate" section. If working on a local machine (not the Raspberry pi), set up a local webserver to test the result:

python -m SimpleHTTPServer 8000

Alternatively, the included host.sh script can be used to run the command above:

./host.sh

Now visit the page in the browser via localhost:8000