How to use Dashwerks

Dashwerks displays live OBD-II vehicle data on customizable gauge dashboards called Dashwerks. Open the main menu by tapping on the screen to reach the controls. For additional help, visit our frequently asked questions or contact support.

Quick Start Guide
  1. Open Dashwerks. On first launch, read and acknowledge the Disclaimer and End User License Agreement before continuing.
  2. Plug a compatible Bluetooth ELM327 OBD-II adapter into your vehicle’s OBD-II port, then turn the vehicle on or use the ignition position required to power the port.
  3. Open the main menu and tap Bluetooth Devices. Scan for adapters, then tap Connect next to your adapter and wait for the status to show Connected.
  4. In the main menu, open Settings > Dashwerks, tap +, and create a Dashwerk. Give it a name, choose a layout, and configure each gauge with the vehicle data you want to monitor. Save your Dashwerk with the green checkmark.
  5. Return to the main menu and tap Display Choices. Select the Dashwerk tab, then tap your newly created Dashwerk. A checkmark confirms that it is the active display.
  6. Exit or dismiss the menu to return to the dashboard and view your active Dashwerk.

For safety, configure the app only while parked. Do not rely on Dashwerks data to operate your vehicle; use your vehicle’s factory instruments and warnings, and always pay attention to the road.

Connect a Bluetooth ELM 327 OBD-II Adapter
  1. Plug in and power on a compatible Bluetooth OBD-II adapter.
  2. On the main menu, tap Bluetooth Devices (the sensor icon).
  3. If prompted, turn on Bluetooth in the device Settings app.
  4. Tap Scan for Adapters.
  5. Under Available Adapters, tap Connect beside your adapter.
  6. Wait for the status to change to Connected. The adapter is saved under My Adapters for future connections.

When the adapter is connected, the menu icon turns from blue to green. The application remembers the last connected adapter and tries to reconnect to it the next time it starts.

Close other apps that may be using the adapter while using Dashwerks; they can interfere with the connection and vehicle data readings.

View Vehicle Information
  1. Connect to an OBD-II adapter and wait for it to connect to the vehicle.
  2. Open the main menu and tap Vehicles (the car icon).
  3. Tap the connected vehicle.
  4. View its make, model, year, and VIN.

When a vehicle is detected, the vehicle icon in the menu turns from blue to green. Vehicle make, model, and year are identified from the VIN; because this information relies on the available VIN data, it may not always precisely reflect the vehicle or include the newest models.

Scan for Supported Standard PIDs

A PID is a data item your vehicle can report, such as RPM, speed, or coolant temperature.

  1. Connect the adapter to the vehicle you want to scan.
  2. Open Vehicles from the main menu and select that vehicle.
  3. Tap Standard PIDs.
  4. Tap the scan icon in the upper-right corner, then choose OK (Start scanning).
  5. Keep this screen open and keep Dashwerks in the foreground. The scan normally takes about 10 seconds.
  6. When finished, the list shows the standard PIDs the vehicle supports. Tap one to see its details.

If you believe the scan was incomplete, you can start another scan later using the scan icon.
Dashwerks supports a subset of standard OBD-II PIDs, so the scan does not list every standard PID your vehicle supports.

Dashwerk supported Standard OBD-II PIDs

PID (hex)Supported data
04Engine Load
05Engine Temperature
0AFuel Pressure
0BIntake Manifold Pressure
0CRPM
0DSpeed
0ETiming Advance
0FIntake Air Temperature
11Throttle Position
22Fuel Rail Pressure (relative to manifold vacuum)
23Fuel Rail Pressure (gauge pressure)
2FFuel Tank Level
33Absolute Barometric Pressure
46Ambient Air Temperature
59Fuel Rail Pressure (absolute)
5CEngine Oil Temperature
Create a Dashwerk
  1. Open the main menu, then tap Settings (the gear icon).
  2. Tap Dashwerks, then tap +.
  3. Enter a name.
  4. Choose a Layout and, if desired, a background color.
  5. Tap each gauge position to configure its gauge.
  6. Optionally tap the eye icon to preview the Dashwerk.
  7. Tap the green checkmark to save it.
  8. To edit an existing Dashwerk, tap it in the Dashwerks list to view its details and update settings such as the background or any gauge configuration.
Customize a Gauge
  1. While creating or editing a Dashwerk, tap the gauge position you want to change.
  2. Tap Gauge and choose a gauge design. Use search or filters to narrow the list, then confirm with the checkmark.
  3. Tap OBD2 PID and choose the data item for that gauge. Only compatible PID types are shown.
  4. Adjust the available options, such as units, range, labels, colors, needle settings, or redline settings.
  5. Review the live preview, then return to the Dashwerk and save it.

Changing a gauge design restores that design's default options. Reapply any custom gauge settings afterward.

Add an Image to Display
  1. Open the main menu and tap Settings.
  2. Tap Images, then tap +.
  3. Tap Select a Photo and choose an image from your photo library.
  4. Review the preview and tap Save.
Switch Between a Dashwerk and an Image
  1. Open the main menu and tap Display Choices (the display icon).
  2. Select the Dashwerk or Image tab.
  3. Tap the Dashwerk or image you want to show. A checkmark confirms the active choice.
  4. Use the reset button in the upper-right corner to clear the active display and return to the app's normal display selection.
Set Daytime or Nighttime Dashwerks
  1. Open Settings from the main menu.
  2. Tap Daytime Dashwerk or Nighttime Dashwerk.
  3. Choose a saved Dashwerk, or choose None to clear that assignment.
Configure a Custom OBD-II PID

Custom PIDs are for vehicle-specific data. Confirm the required header, service, DID, and formula with your vehicle documentation before saving.

  1. Open the main menu, then go to Settings > Custom OBD2 PIDs.
  2. Tap +.
  3. Enter a unique name and the vehicle make, model, year, and optional notes.
  4. Enter the three-character hexadecimal Module (header) and the 2–4 character hexadecimal DID.
  5. Choose the required Service. Standard OBD-II PIDs generally use header 7DF and service 01; custom PIDs generally use service 22.
  6. Choose the conversion Formula, metric type, and polling frequency.
  7. Tap the save-as-new icon. The button is enabled only after the required fields are valid.
  8. Add the new PID to a compatible gauge through that gauge's OBD2 PID picker.
Request a Formula To Be Added

Vehicle responses received over OBD-II can contain one to four data bytes, represented in formulas as A through D. A is the first byte returned, B the second, C the third, and D the fourth; a one-byte response uses only A, while shorter responses omit the remaining letters.

For example, Dashwerks uses the odometer formula (A × 2^24 + B × 2^16 + C × 2^8 + D) ÷ 10. A is the most significant byte and is multiplied by 2^24; B, C, and D are the next bytes in order, multiplied by 2^16, 2^8, and 1 respectively. The combined value is then divided by 10 to produce the odometer reading.

  1. If a suitable formula is not available, submit a support inquiry through the contact form. Include the exact formula, the applicable service and PID, its intended use case, and the required units. Supported formula units are Celsius for temperature, kPa for pressure, kph for speed, and raw values for RPM, degrees, and percentage. We will do our best to add requested formulas that are approved by our developers in a subsequent app update.
Edit or Remove Saved Items
  1. Dashwerks: Go to Settings > Dashwerks. Tap a Dashwerk to edit it, or tap Edit to delete one.
  2. Images: Go to Settings > Images, tap Edit, then delete an image.
  3. Custom PIDs: Go to Settings > Custom OBD2 PIDs. Tap a PID to edit it, or use the delete control in the list.
  4. Saved adapters: Open Bluetooth Devices, tap Edit, then remove an adapter.
Troubleshoot an Adapter Connection

If Dashwerks cannot find or connect to your adapter, check the vehicle connection and Bluetooth settings:

  1. Check vehicle power: Turn the ignition on or start the engine as required by your vehicle. An adapter’s power light may illuminate even when the vehicle’s computers are not ready to respond.
  2. Check the port and adapter: Make sure the adapter is firmly seated in the OBD-II port. If its power light does not come on, check the vehicle’s documentation for the appropriate fuse or consult a qualified technician. On some vehicles, the OBD-II port shares a fuse with an accessory outlet.
  3. Check iOS compatibility: Confirm that the adapter supports iPhone or iPad. Some Bluetooth Classic adapters are not compatible with iOS apps.
  4. Connect in Dashwerks: Enable Bluetooth in iOS Settings, then open Bluetooth Devices in Dashwerks, scan for adapters, and connect there.
  5. Close other OBD-II apps: Another app using the adapter may interfere with the connection or vehicle data readings. Close other OBD-II apps and try connecting again.

If the connection still fails, unplug and reconnect the adapter, then scan again. See the FAQ for more adapter troubleshooting.

Troubleshoot a Missing or Incorrect Reading

A gauge starts at zero when it is displayed. If its PID requests fail from that point, it continues to show zero even though no reading has been received. Zero can also be a valid reading, such as vehicle speed when stopped, so zero alone does not confirm a response from the vehicle. If a reading is unexpected, work through these checks:

  1. Check the connection: Make sure Dashwerks is connected to the adapter and the vehicle is on or in the ignition position needed for its computers to respond. Close other OBD-II apps that may be using the adapter.
  2. Check the gauge: Edit the Dashwerk and confirm that the gauge has the intended PID and units selected.
  3. Check PID support: Scan for supported standard PIDs using the Vehicles menu. The scan lists the supported PIDs that Dashwerks can scan for, not every PID the vehicle supports. A vehicle may have a sensor without exposing its reading through OBD-II, or the reading may require a manufacturer-specific PID.
  4. Check custom PID settings: Confirm that the header, service, DID, and formula are correct for your vehicle’s make, model, and year.
  5. Check for delays: If readings are frozen or slow, try reducing the number of gauges or how often they update. ELM327 requests are processed one at a time, so a slow response can delay other readings.
  6. Test the request: Disconnect Dashwerks and use an app with an ELM327 terminal to send the PID request and check whether the adapter receives a valid response. Close the terminal app before reconnecting Dashwerks.

If the gauge is blank or the issue persists, send us a message through the support contact form. Include the symptoms, PID details and formula if applicable, vehicle make, model and year, and adapter brand and model.

Set Up Dashwerks for Another Vehicle
  1. Plug a compatible Bluetooth ELM327 adapter into the other vehicle’s OBD-II port and turn the vehicle on or use the ignition position needed to power the port.
  2. Open Dashwerks and connect to the adapter through Bluetooth Devices. The app will automatically connect to the vehicle.
  3. Check your gauges and adjust them as needed, or create a separate Dashwerk for the vehicle.

Different vehicles support different PIDs, so readings available in an existing Dashwerk may not be available in another vehicle.

Find and Verify a Custom PID

Custom PIDs, also known as UDS data identifiers (DIDs) or Mode 22 PIDs, are often specific to a vehicle manufacturer and may not be publicly documented.

  1. Find a source: Look in open-source repositories, vehicle-specific enthusiast forums, diagnostic app communities, or available vehicle documentation. Search using your vehicle’s make, model, and year and the reading you want.
  2. Check the details: Confirm that the information applies to your vehicle. Note the module header, service, DID, conversion formula, and units. These can vary between vehicles.
  3. Test the request: Disconnect Dashwerks, then use an app with an ELM327 terminal to send the request with the appropriate settings. Check that the adapter receives a valid response. Close the terminal app before reconnecting Dashwerks.
  4. Configure the PID: Follow Configure a Custom OBD-II PID above to enter the details, choose the formula and metric type, and add the PID to a compatible gauge.
  5. Check the reading: Compare the result with a known or expected value where possible. A valid response alone does not confirm that the formula or units are correct.

If the required formula is not available in Dashwerks, see Request a Formula To Be Added above. If the reading is missing or unexpected, follow Troubleshoot a Missing or Incorrect Reading.

Choose a Formula for a Custom PID

A custom PID’s formula converts the data bytes returned by the vehicle into a usable reading. Choose a formula that matches the PID and produces the unit Dashwerks expects for the selected metric type.

  1. Find the correct formula: Check your PID source or vehicle documentation for the formula and confirm that it applies to your vehicle’s make, model, and year. In formulas, A through D represent the first through fourth data bytes returned by the vehicle.
  2. Check the output unit: Dashwerks expects Celsius for temperature, kPa for pressure, and km/h for speed. RPM, degrees, and percentage use raw values. Make sure the formula produces the expected unit, even if you plan to display another unit on the gauge.
  3. Select and test the formula: In Settings > Custom OBD2 PIDs, choose the matching formula and metric type. Add the PID to a compatible gauge and compare the reading with a known or expected value where possible.

If the formula you need is not available, use the support contact form to request it. Include the exact formula, service and PID, intended use, and required units. See Request a Formula To Be Added above for more details.

Prepare a Support Request

When contacting support, provide as much detail as you can so we can understand and investigate the issue. Include the following where relevant:

  • What happened: Describe the issue, what you expected to happen, and what the app did instead.
  • Where and when it happens: Identify the screen or menu involved, the steps leading up to the issue, and whether it happens every time or only occasionally.
  • Gauge readings: Describe the symptoms, such as a missing, delayed, or unexpected reading. Include the PID details and, for a custom PID, the formula it uses.
  • Vehicle and adapter: Include the vehicle’s make, model, and year, along with the brand and model of your Bluetooth ELM327 adapter.
  • Device and troubleshooting: Include your iPhone or iPad model, iOS version, and any steps you have already tried.

Send these details through the support contact form.