User Guide - nickywongdong/wombat GitHub Wiki

Forewarning

Distracted driving may lead to accidents. Please obey all traffic laws and do not operate the system if system operation will affect your driving safety or the safety of other road users.

By continuing to use our system, you agree to these terms.

Launching Axolotl

Launch Axolotl by double-tapping on the Axolotl symlink on the desktop after installation. If the symlink is not present, open the folder ~/wombat/source/build-axolotl-KitRules-Debug and run the Axolotl application.

Exiting Axolotl

Improperly exiting Axolotl may result in corrupted data logs. To exit Axolotl properly, tap on the red X button in the upper left hand corner of the main window.

Navigation

The navigation tab simply contains the Navit navigation system. This system functions similar to how Garmin navigation systems do.

By default, the map is displayed. Here, your route info as well as next turn instruction, GPS satellite strength, and true distance to destination is displayed. Pressing the + or - buttons will zoom the map in and out, respectively.

Pressing on the screen without moving will open the main menu.

  • Go To will allow for address entry, previous destination entry, and the like. When entering a destination, tapping on the auto-completed suggestion will bring that selection up as a possible destination; tapping the checkbox to the right of the entry field will allow for further addresses to be entered.

  • View Map will return you to the map interface.

  • Settings will open a preferences menu that allows you to change navigation settings.

Data

This tab allows the user to manage the data logging system.

  • Clear logs enables the user to clear the data logs on the current logging volume by entering a password.

  • Change password allows the user to change the password used to clear the data logs. The default password is orangemonkeyeagle; we strongly suggest changing this password to a more secure and personal password upon receipt of your system.

  • Reset password resets the password to default.

Note: Password entry for clear logs and change password is unavailable while the vehicle is moving.

DTCs

This tab displays diagnostic trouble codes as well as the date/time of when the current diagnostic trouble codes were fetched. Diagnostic trouble codes are displayed as tuples that include the diagnostic trouble code itself as well as any information on that code found by python-OBD.

  • Refresh will request new diagnostic trouble codes from the vehicle and update the display.

Fuel Economy Analysis

This tab displays fuel economy data with respect to the current boot cycle (this may not encapsulate the entire driving cycle if Axolotl isn't started soon after vehicle start-up or shut-off).

  • Refresh will re-run fuel economy analysis on the current boot cycle's OBD log and update the display.

AHRS

This tab displays data from the AHRS sensor in an easily human-understandable format.

  • Refresh will grab new readings from the sensor and display those.

  • Zero calibrates the sensor; subsequent readings will be made with respect to the sensor's current orientation. Note that this does not affect the readings stored in the data log.

Media

This tab displays media controls for auxiliary input, Bluetooth pairing, and volume settings.

  • Aux will activate any Aux device connected to the Axolotl using the Aux dongle.

  • Pair will block the system and allow you to connect a Bluetooth device for media playback. On the Bluetooth device you desire to connect, simply select "tegra-ubuntu"; the system should automatically connect to the device within 10 seconds.

  • Audio Off will turn the audio system off. Turn the audio system on by adjusting the volume.

A volume slider is provided for adjusting master system output volume.

Note: it may be more easier to have the Axolotl system volume maximized and instead adjust your car's audio output volume.

FM

This tab displays the GQRX software radio.

The radio is turned on by pressing the power button in the upper left-hand corner of the screen.

Tapping on the individual digits at the top will adjust the current radio frequency. You may also drag the slider to change the frequency for finer tuning while driving.

GQRX supports many types of radio frequencies; you can adjust these by opening the "Mode" drop-down menu on the right-hand pane and selecting the desired radio mode. The default FM radio mode is WFM (Stereo).

Radio data system data is not displayed by default. You may enable this functionality by tapping on the RDS checkbox while the RDS tab is selected in the lower right-hand corner.

Media Player

This tab displays the VLC media player. Transport controls are located at bottom left; a dedicated volume slider for VLC output volume only is displayed at the bottom right.

Note: it may be easier to adjust audio volume from the Media tab.

By default, VLC will display the Music folder at /home/nvidia/Music.

Playing Media from External Storage

VLC will automatically display media on an external storage volume if there is one connected. Media on the external storage volume must be saved in a folder labeled Music folder at the base level of the external storage volume.

Accessing Data Logs

Data logs should automatically be saved to an external storage device named AXOLOTLDCV if you have one connected. Accessing the data logs is as simple as disconnecting the storage device, connecting it your computer, and downloading the files in the directory axolotl/data located on the storage device. If an external drive is not connected, you may access the data from the Jetson's Linux file manager by navigating to ~/axolotl/data.

Data logs are saved in individual folders named based off of the time and date of their creation. Each data log should consist of an obd_log.csv, ahrs_log.csv, master_log.csv, dtcs (if DTCs have been fetched during that boot cycle), and front_dashcamX.mp4 files, where X represents the segment number of that particular snippet of dashcam footage.

Please refer to the Data Formatting article on how the data is formatted.