Skip to content
Kristoffer Smith edited this page Aug 23, 2014 · 10 revisions

The Debug Terminal Screen (v0.8)

This screen provides a simple terminal interface to the currently connected ELM327 based OBD2 adapter. It is primarily intended to allow reviewing the exact bus data that the application is receiving. You can also send AT commands to the ELM327 device.

This feature is accessed from the option at the bottom of the Settings screen.

debug terminal

Overview

If the app is currently connected and monitoring an active bus then you should see lines being added to the main terminal area as bus messages are received. The area is scrollable but limited to ~500 lines in order to prevent the UI from becoming sluggish on slower Android devices.

General bus data being received is shown in silver. Received bus messages that are matched with one of the current interface monitors are shown in green. Commands sent are shown in white. Error and other application status messages are shown in red.

Important Note: The app continues to receive and process data even if you switch to another app or return to the home screen. However, the terminal only shows data that is sent/received while the debug terminal screen is being viewed. This limitation should be removed in the next version.

Options Menu

The options menu is available in the top right corner of the screen (within the title bar).

Note that each checkable menu option is selected by default.

options menu and on-screen keyboard showing

Auto-Scroll

If selected then the main terminal area will continually scroll to the bottom as new lines are added. Touching that area automatically de-selects this option. Sending any command will automatically re-select it.

Show Time

If selected then each line in the main terminal area will be prefixed with a timestamp in the format HOURS:MINUTES:SECONDS.MILLISECONDS.

Show Elapsed

If enabled then each line in the main terminal area will be prefixed with the time elapsed since the previous line. The elapsed time is shown in the format (MINUTES:SECONDS.MILLISECONDS). If the Show Time option is also selected then the elapsed time is shown after the timestamp.

Tip: This feature is useful when deciding how to configure the Group Time settings for an interface monitor

Re-send Startup Commands

Choosing this option will re-send the currently configured interface startup commands. This is useful if you've stopped the default monitoring by sending custom commands and later want to resume normal operation.