summaryrefslogtreecommitdiff
path: root/megalogger/README.md
blob: bd9ada5d4553510ff8bb22f9d6caef8be0e44c72 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
MegaLogger
==========

MegaLogger is a sketch developed for Arduino Telematics Kits based on Arduino MEGA or MEGA ADK. The sketch features OBD-II, GPS and motion sensor data access, data logging, data streaming and data display.

The sketch utilize following custom Arduino libraries:

    OBD-II Library
    TinyGPS Library
    MPU6050 Library
    MPU9150 Library
    MultiLCD Library


Configuration
-------------

MegaLogger has several configurable options all stay in the config.h file. Major options include:

    OBD_MODEL - defines the model of OBD-II Adapter (OBD_MODEL_UART or OBD_MODEL_I2C)
    USE_GPS - defines whether GPS is used
    USE_MPU6050 - defines whether MPU-6050 is used
    USE_MPU9150 - defines whether MPU-9150 is used
    ENABLE_DATA_LOG - toggles data logging on microSD card
    ENABLE_DATA_OUT - toggles data streaming (to mobile devices via Bluetooth)
    STREAM_FORMAT - sets streaming data format (FORMAT_BIN for binary format or FORMAT_CSV for text format)

OBD-II
------

The kit connects to the OBD-II port of a motor vehicle via OBD-II Adapter for Arduino. There are two versions of OBD-II Adapter available, UART and I2C. The UART version provides ELM327 command-set via serial UART at baudrate of 38400bps. The I2C version works as an I2C device which is accessed by I2C address for OBD-II data access. It also integrates I2C MEMS sensor which provides accelerometer and gyro. OBD_MODEL define in config.h should be corresponding to the model of the adapter. The OBD-II Adapter should be connected at Serial1 or I2C interface and is access from Arduino by OBD-II library. 

GPS
---
The kit comes with optional GPS receiver which should be connected at Serial2. The incoming NMEA data stream is parsed by TinyGPS library.

MEMS Sensors
------------

MEMS Sensors (MPU-6050 or MPU-9150) are embedded in I2C version of OBD-II Adapter. They are accessed via I2C by MPU6050/MPU9150 library.

Data Logging
------------

The kit provides complete data logging for OBD-II, GPS and motion sensor data. The data is stored on microSD card if present. Standard Arduino SD library used for accessing microSD card.

The data is logged in a simple CSV text format.Each line represents a record with time, data type and data value like this:

    [Time Elapsed],[Data Type],[Data Value]

Time Elapsed is the time elapsed in milliseconds since previous data record. Data Type is the OBD-II PID which is defined in the OBD-II library (e.g. 0x10C is engine RPM). Here is an example data clip:

    169,10D,0
    171,111,12
    170,143,21
    165,10B,30
    175,10C,705
    169,10D,0
    170,111,12
    ...

GPS and motion sensor data are defined as special PID which OBD-II standard does not use and are defined in datalogger.h file.

    #define PID_GPS_LATITUDE 0xA
    #define PID_GPS_LONGITUDE 0xB
    #define PID_GPS_ALTITUDE 0xC
    #define PID_GPS_SPEED 0xD
    #define PID_GPS_HEADING 0xE
    #define PID_GPS_SAT_COUNT 0xF
    #define PID_GPS_TIME 0x10
    #define PID_GPS_DATE 0x11
    #define PID_ACC 0x20
    #define PID_GYRO 0x21
    #define PID_COMPASS 0x22
    #define PID_MEMS_TEMP 0x23
    #define PID_BATTERY_VOLTAGE 0x24

Data Streaming
--------------

Live data can be streamed to a mobile device via Bluetooth (BLE or 2.1) module which is optionally connected at Serial3. Two stream data formats are available, text or binary based. Text based format is same as data logging format in form of CSV. The binary format is based on a framed data format and is used by streaming data to iOS device with Freematics OBD App installed.

Data Display
------------

The kit provides a 3.2" color TFT LCD display. The live data will be displayed on the screen. The LCD display is driven by MultiLCD library.