README
node-obd2
Vehicle communication and data parsing with OBD-II connector.
INSTALLATION
$ npm install obd2 --save
USAGE
See sample files in "example" direction. Need for example project:
$ npm install express
$ npm install socket.io
WARNING
Beta package, does not suggested for stable use! Stable version 1.x soon.
TESTS
- Integrated "fake serial"
- Usb connection ( ELM327 v1.4b )
- Ford focus 2008 ( CAN 11 bit 500kb )
Bluetooth connection ( ELM327 v1.? )- Included example
DOCUMENTATION
Source documentation find here.
ROADMAP
- DTC read
- DTC clear
- FREEZE mode read
MODE and PID Support
| MODE | PID | Byte | Description | Min | Max | Unit | Slug name |
|---|---|---|---|---|---|---|---|
| 01 | 00 | 4 | PIDs supported 00-20 | BIT | pidsupp0 | ||
| 01 | 01 | 4 | Monitor status since DTCs cleared | BIT | dtc_cnt | ||
| 01 | 02 | 2 | DTC that caused required freeze frame data storage | BIT | dtcfrzf | ||
| 01 | 03 | 2 | Fuel system 1 and 2 status | BIT | fuelsys | ||
| 01 | 04 | 1 | Calculated LOAD Value | 0 | 100 | % | load_pct |
| 01 | 05 | 1 | Engine Coolant Temperature | -40 | 215 | °C | temp |
| 01 | 06 | 1 | Short Term Fuel Trim - Bank 1,3 | -100 | 99.22 | % | shrtft13 |
| 01 | 07 | 1 | Long Term Fuel Trim - Bank 1,3 | -100 | 99.22 | % | longft13 |
| 01 | 08 | 1 | Short Term Fuel Trim - Bank 2,4 | -100 | 99.22 | % | shrtft24 |
| 01 | 09 | 1 | Long Term Fuel Trim - Bank 2,4 | -100 | 99.22 | % | longft24 |
| 01 | 0A | 1 | Fuel Rail Pressure (gauge) | 0 | 765 | kPa | frp |
| 01 | 0B | 1 | Intake Manifold Absolute Pressure | 0 | 255 | kPa | map |
| 01 | 0C | 2 | Engine RPM | 0 | 16383.75 | r/m | rpm |
| 01 | 0D | 1 | Vehicle Speed Sensor | 0 | 255 | km/h | vss |
| 01 | 0E | 1 | Ignition Timing Advance for #1 Cylinder | -64 | 63.5 | ° | sparkadv |
| 01 | 0F | 1 | Intake Air Temperature | -40 | 215 | °C | iat |
| 01 | 10 | 2 | Air Flow Rate from Mass Air Flow Sensor | 0 | 655.35 | g/s | maf |
| 01 | 11 | 1 | Absolute Throttle Position | 0 | 100 | % | throttlepos |
| 01 | 12 | 1 | Commanded Secondary Air Status | BIT | air_stat | ||
| 01 | 13 | ||||||
| 01 | 14 | ||||||
| 01 | 15 | ||||||
| 01 | 16 | ||||||
| 01 | 17 | ||||||
| 01 | 18 | ||||||
| 01 | 19 | ||||||
| 01 | 1A | ||||||
| 01 | 1B | ||||||
| 01 | 1C | 1 | OBD requirements to which vehicle is designed | BIT | obdsup | ||
| 01 | 1D | ||||||
| 01 | 1E | ||||||
| 01 | 1F | 2 | Time Since Engine Start | 0 | 65535 | sec | runtm |
| 01 | 20 | 4 | PIDs supported 21-40 | BIT | pidsupp2 | ||
| 01 | 21 | 2 | Distance Travelled While MIL is Activated | 0 | 65535 | km | mil_dist |
| 01 | 22 | 2 | Fuel Rail Pressure relative to manifold vacuum | 0 | 5177.265 | kPa | frpm |
| 01 | 23 | 2 | Fuel Rail Pressure (diesel) | 0 | 655350 | kPa | frpd |
| 01 | 24 | ||||||
| 01 | 25 | ||||||
| 01 | 26 | ||||||
| 01 | 27 | ||||||
| 01 | 28 | ||||||
| 01 | 29 | ||||||
| 01 | 2A | ||||||
| 01 | 2B | ||||||
| 01 | 2C | 1 | Commanded EGR | 0 | 100 | % | edr_pct |
| 01 | 2D | 1 | EGR Error | -100 | 99.2 | % | egr_err |
| 01 | 2E | 1 | Commanded Evaporative Purge | 0 | 100 | % | eavp_pct |
| 01 | 2F | 1 | Fuel Level Input | 0 | 100 | % | fuellevel |
| 01 | 30 | 1 | Number of warm-ups since diagnostic trouble codes cleared | 0 | 255 | pcs | warm_ups |
| 01 | 31 | 2 | Distance since diagnostic trouble codes cleared | 0 | 65535 | km | clr_dist |
| 01 | 32 | 2 | Evap System Vapour Pressure | -8192 | 8192 | Pa | evap_vp |
| 01 | 33 | 1 | Barometric Pressure | 0 | 255 | kPa | baro |
| 01 | 34 | ||||||
| 01 | 35 | ||||||
| 01 | 36 | ||||||
| 01 | 37 | ||||||
| 01 | 38 | ||||||
| 01 | 39 | ||||||
| 01 | 3A | ||||||
| 01 | 3B | ||||||
| 01 | 3C | 2 | Catalyst Temperature Bank 1 / Sensor 1 | -40 | 6513.5 | °C | catemp11 |
| 01 | 3D | 2 | Catalyst Temperature Bank 2 / Sensor 1 | -41 | 6513.6 | °C | catemp21 |
| 01 | 3E | 2 | Catalyst Temperature Bank 1 / Sensor 2 | -42 | 6513.7 | °C | catemp12 |
| 01 | 3F | 2 | Catalyst Temperature Bank 2 / Sensor 2 | -43 | 6513.8 | °C | catemp22 |
| 01 | 40 | 4 | PIDs supported 41-60 | BIT | pidsupp4 | ||
| 01 | 41 | 4 | Monitor status this driving cycle | BIT | monitorstatus | ||
| 01 | 42 | 2 | Control module voltage | 0 | 65535 | V | vpwr |
| 01 | 43 | 2 | Absolute Load Value | 0 | 25700 | % | load_abs |
| 01 | 44 | 2 | Fuel/air Commanded Equivalence Ratio | 0 | 2 | (ratio) | lambda |
| 01 | 45 | 1 | Relative Throttle Position | 0 | 100 | % | throttlerel |
| 01 | 46 | 1 | Ambient air temperature | -40 | 215 | °C | ambient |
| 01 | 47 | 1 | Absolute Throttle Position B | 0 | 100 | % | throttleposb |
| 01 | 48 | 1 | Absolute Throttle Position C | 0 | 100 | % | throttleposc |
| 01 | 49 | 1 | Accelerator Pedal Position D | 0 | 100 | % | accpedald |
| 01 | 4A | 1 | Accelerator Pedal Position E | 0 | 100 | % | accpedale |
| 01 | 4B | 1 | Accelerator Pedal Position F | 0 | 100 | % | accpedalf |
| 01 | 4C | 1 | Commanded Throttle Actuator Control | 0 | 100 | % | tac_pct |
| 01 | 4D | 2 | Time run by the engine while MIL activated | 0 | 65525 | min | mil_time |
| 01 | 4E | 2 | Time since diagnostic trouble codes cleared | 0 | 65525 | min | clr_time |
| 01 | 4F | ||||||
| 01 | 50 | ||||||
| 01 | 51 | 1 | Fuel Type | BIT | fuel_type | ||
| 01 | 52 | 1 | Ethanol fuel % | 0 | 100 | % | alch_pct |
| 01 | 53 | 2 | Absolute Evap system Vapor Pressure | 0 | 327.675 | kPa | evap_press_abs |
| 01 | 54 | 2 | Evap system vapor pressure | -32767 | 32768 | Pa | evap_press |
| 01 | 55 | ||||||
| 01 | 56 | ||||||
| 01 | 57 | ||||||
| 01 | 58 | ||||||
| 01 | 59 | ||||||
| 01 | 5A | 1 | Relative accelerator pedal position | 0 | 100 | % | accpedal_pos |
| 01 | 5B | 1 | Hybrid battery pack remaining life | 0 | 100 | % | hybridbatt |
| 01 | 5C | 1 | Engine oil temperature | -40 | 210 | °C | oiltemp |
| 01 | 5D | 2 | Fuel injection timing | -210.00 | 301.992 | ° | fuelinjection |
| 01 | 5E | 2 | Engine fuel rate | 0 | 3212.75 | L/h | fuelrate |
| 01 | 5F | ||||||
| 01 | 60 | 4 | PIDs supported 61-80 | BIT | pidsupp6 | ||
| 01 | 61 | 1 | Driver's demand engine percent torque | -125 | 125 | % | demand_pct |
| 01 | 62 | 1 | Actual engine percent torque | -125 | 125 | % | torque_pct |
| 01 | 63 | 2 | Engine reference torque | 0 | 65535 | Nm | torque |
| 01 | 64 | ||||||
| 01 | 65 | ||||||
| 01 | 66 | ||||||
| 01 | 67 | ||||||
| 01 | 68 | ||||||
| 01 | 69 | ||||||
| 01 | 6A | ||||||
| 01 | 6B | ||||||
| 01 | 6C | ||||||
| 01 | 6D | ||||||
| 01 | 6E | ||||||
| 01 | 6F | ||||||
| 01 | 70 | ||||||
| 01 | 71 | ||||||
| 01 | 72 | ||||||
| 01 | 73 | ||||||
| 01 | 74 | ||||||
| 01 | 75 | ||||||
| 01 | 76 | ||||||
| 01 | 77 | ||||||
| 01 | 78 | ||||||
| 01 | 79 | ||||||
| 01 | 7A | ||||||
| 01 | 7B | ||||||
| 01 | 7C | ||||||
| 01 | 7D | ||||||
| 01 | 7E | ||||||
| 01 | 7F | ||||||
| 01 | 80 | 4 | PIDs supported 81-A0 | BIT | pidsupp8 | ||
| 01 | 81 | ||||||
| 01 | 82 | ||||||
| 01 | 83 | ||||||
| 01 | 84 | ||||||
| 01 | 85 | ||||||
| 01 | 86 | ||||||
| 01 | 87 | ||||||
| 01 | A0 | 4 | PIDs supported A1-C0 | BIT | pidsuppa | ||
| 01 | C0 | 4 | PIDs supported C1-E0 | BIT | pidsuppc | ||
| 01 | C3 | ||||||
| 01 | C4 | ||||||
| 03 | 6 | Requested DTC | BIT | requestdtc | |||
| 04 | Clear Trouble Codes (Clear engine light) | cleardtc |