obd

ELM327 OBD-II class for vehicle self-diagnostics, written in PHP

Installation

To install using Composer, add "mdlayher/obd": "dev-master" to the require section of your composer.json.

Usage

Connect an ELM327 OBD-II device using serial interface, and point the class at its device file location. Optionally, a baud rate, preferred unit system, and verbosity may be specified.

<?php
    // obd demo
    require_once __DIR__ . "/vendor/autoload.php";
    use \obd\obd as obd;

    // Open serial connection
    $obd = new obd("/dev/pts/1", obd::BAUD_FAST);
    $obd->connect();

    // Run a few basic commands
    $commands = array("AT I", "AT RV", "AT DP");
    printf("Basic commands:\n");
    foreach ($commands as $c)
    {
        printf("\t%s -> %s\n", $c, $obd->command($c));
    }

    // Call all parameter ID (PID) functions using English units
    printf("English:\n");
    foreach ($obd->pid as $key => $p)
    {
        printf("\t%s: %s\n", $key, $p());
    }

    // Switch to Metric and call a few functions
    $obd->set_units(obd::UNIT_METRIC);
    printf("Metric:\n");
    printf("\tfuel_pressure: %s\n", $obd->pid['fuel_pressure']());
    printf("\tspeed: %s\n", $obd->pid['speed']());