Skip to content

A WEB Based OBDII Dongle Platform using the REJSACAN ESP32-S3 OBDII DONGLE

License

Notifications You must be signed in to change notification settings

EQMOD/REJSACAN_OBDWEB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

REJSACAN_OBDWEB

=== A WEB Based OBDII Dongle Platform using the REJSACAN ESP32-S3 OBDII DONGLE

A REJSACAN OBDII Dongle using the ESP32-S3 with built-in SPIFFF memory is used as a CAN BUS OBDII reader and the data is presented as WEB PAGE using a built-in webserver. The webpage code communicates to the dongle via WiFi and uses websockets to retrieve OBDII data. The platform is using an ESP32 microcontroller which is a dual core mcu with the first core handling the CAN Bus comunications part via SN65HVD230 CAN BUS Transceiver and the 2nd core handling the websocket part. OBDII data is pushed to the UI every 60ms to 100ms for critical data such as rpm and speed, and every 1000ms for not so critical data such as temp, voltage, etc.

The platform code is using ESP32 RTOS for the multi core multi tasking component. That's basically an OBDII with a webserver running inside that dongle which is attached to the car's obd port. And literally you can read every car metric data and show it on the car infotainment / Web browser / Phone app with customizable fancy UI stuff (gauges, graphs, etc.) using standard HTML/JS/CSS/JPG renders.

Any web browser client can connect to the dongle via WIFI with the OBD-II dongle acting as a Wifi Hotspot. Wifi credentials are embedded on the code.

You can add an OPTIONAL JDY08 BLE Module with its own embedded CC2541 micrcontroller ( CC2541 source code included in this repository) for other sensor data reception using BLE Advertisements. Simply drop the cc2541 binary file to the SD Card of the RejsaCAN and the built-in flash codes will burn it to the JDY08 module. Two sample JDY08 bin files are provided - one as VC601 BLE Tire Pressure Receiver/BM2 Battery Monitor (need to change IDs on the code) for TPMS Data and live battery stats (aside from the OBD Module voltage). The other cc2541.bin file is a HM10 BLE UART Bridge where you can use the JDY08 as an ELM327 to UART bridge for TORQUE app communications via BLE. Codes are also provided under the loop() function for a ELM327-WIFI based communication

Diagram_001 drawio

=== JDY08 and RejsaCAN v3.4 Board Connection Diagram

Diagram_002 drawio

=== Serial Console when a cc2541.bin file is present on the SD Card. File is flashed to the JDY08 module then deleted from the SD Card

image image

====================================

Webserver entry point / homepage is ;

http://192.168.0.10/index.html

The OBDII Dongle with the built-in ESP32-S3 micrcontroller is designed by Magnus Thome and details can be found here;

https://github.com/MagnusThome/RejsaCAN-ESP32

image

=== The WEB UI assets are stored on the REJSCAN Dongle's SD Card can be customized by a web designer/developer using HTML/JS/CSS/jpg assets;

Sample UIs;

image

image

Transparent UIs with a LIVE CAMERA FEED on the webpage background is also possible

image

image

=== Sample Browser side and Dongle Side SDCARD DocRoot files;

https://github.com/EQMOD/REJSACAN_OBDWEB/tree/main/Custom_USERS_WEBUI

https://github.com/EQMOD/REJSACAN_OBDWEB/tree/main/SDCARD

=== Compiling use the Arduino IDE;

REJSACAN_OBDWEB_DEV_ENVIRONMENT drawio

The codes is using the standard OBD-II Library (already included in this repository) with a little bit of customization from the original obdII Libraries-

Rewritten from sandeepmistry/arduino-OBD2 to instead depend on the ESP32 CAN libraries

https://github.com/collin80/esp32_can https://github.com/collin80/can_common

that support ESP32 with TWAI.

The code is also using the SDFat Library from Greiman. The SdFat library supports FAT16, FAT32, and exFAT file systems on Standard SD, SDHC, and SDXC cards.

https://github.com/greiman/SdFat

One Library file from SDFat needs to be modified in order for SDFat to work on the REJSACAN SD Card Slot;

image

This is a little bit tricky as you need to add the above entry on the SdFatConfig.h file each time you compile the above codes on the REJSACan Dongle and needs to be commented out if the above library will compiled with your other ESP32 based projects.

=== Suggested ARDUINO IDE settings for the compile and code upload/flashing which also include distributing the routines on the 2 cores;

image

PSRAM Size:

image

=== JDY08 Module customization

As mentioned you can add an OPTIONAL JDY08 mmodule with a Texas Instrument CC2541 BLE Chip. The CC2541 firmware can be customized (source code included here) using the IAR Development Environment which you will then create the cc2541.bin file for flashing to the JDY08 module. One sample use of the attached JDY08 is a realtime Serial Console Logger where you can monitor/debug your app on the dongle while attached to the car's OBD Port;

image

Sample Dongle codes here;

https://github.com/EQMOD/REJSACAN_OBDWEB/tree/main/src/RJA_OBDONLY_ESP32S3_JDY08_001

HM10 BLE UART Firmware file for the JDY-08

https://github.com/EQMOD/REJSACAN_OBDWEB/tree/main/JDY08_bin_src/HM10_BLE_UART