🔨
Projects
Firmware Reference
A look at A0's preloaded firmware "ESP32RET"
Introduction to ESP32RET
What is ESP32RET?
ESP32RET is the name of the firmware that comes pre-loaded on your new Macchina A0. ESP32RET stands for ESP32 (based) Reverse Engineering Tool and provides two primary functionalities*: ELM327 emulation for use with apps like Torque, and Wi-Fi based connection to SavvyCAN.
*These functionalities are current as of version 0.1, however future versions may have expanded features.
Note: there was a previous version called A0RET that you might still see references to in code, documentation, etc.
ELM327 Emulation, Explained Extra Efficiently
Why would you want to emulate an ELM327 device? ELM327 is a closed-source black box interpreter chip (a PIC with some firmware) and you'd much rather know exactly what is being sent to and from your car, right?
Another answer is that now you can take advantage of the numerous existing, (semi) working and tested applications out there for every platform.
SavvyCAN
A Super Powerful CAN bus reverse engineering and capture tool written by Collin Kidder. Wireless Car Hacking!
LED Color Codes
- RED - Not connected (In WIFIMODE=2 you are creating an AP with the A0, so it will go green immediately because you're the AP)
- Green - Ready to connect to application
- Blue - Connected to application
- Purple - Update mode
Smartphone apps
A0 should be compatible with any ELM327 based app.
Android - Torque Lite can be found at the link below:
Torque Lite (OBD2 & Car) - Apps on Google Play
GooglePlay
Search the Google play store for more options.
iOS - Software version 14 of iOS breaks support for A0. We are working to regain iOS support. For those interested in testing on 13 or older make sure your app settings are:
- Connection = WiFi
- IP address = 192.168.4.1
- OBD2 adapter port = 1000
Other ELM based software
OBD Software
Elm Electronics
Visit this page for an extensive list of software compatible with ELM327, and by extension ESP32RET.
A0 System Menu
Many low level configurations can be done via a Serial Terminal (Real-Term, Tera Term, Arduino Serial Monitor, etc). This includes turning ON and OFF WIFI and Bluetooth, setting CAN speed, and setting the WIFI password.
Here is the system menu:
1
Short Commands:
2
h = help (displays this message)
3
R = reset to factory defaults
4
s = Start logging to file
5
S = Stop logging to file
6
7
Config Commands (enter command=newvalue). Current values shown in parenthesis:
8
9
SYSTYPE=0 - Set board type (0 = Macchina A0, 1 = EVTV ESP32 Board
10
LOGLEVEL=1 - set log level (0=debug, 1=info, 2=warn, 3=error, 4=off)
11
12
CAN0EN=1 - Enable/Disable CAN0 (0 = Disable, 1 = Enable)
13
CAN0SPEED=500000 - Set speed of CAN0 in baud (125000, 250000, etc)
14
CAN0LISTENONLY=0 - Enable/Disable Listen Only Mode (0 = Dis, 1 = En)
15
16
CAN0SEND=ID,LEN, - Ex: CAN0SEND=0x200,4,1,2,3,4
17
MARK= - Set a mark in the log file about what you are about to do.
18
19
BINSERIAL=0 - Enable/Disable Binary Sending of CANBus Frames to Serial (0=Dis, 1=En)
20
21
BTMODE=0 - Set mode for Bluetooth (0 = Off, 1 = On)
22
BTNAME=ELM327-A0RET - Set advertised Bluetooth name
23
24
LAWICEL=1 - Set whether to accept
25
LAWICEL commands (0 = Off, 1 = On)
26
27
WIFIMODE=2 - Set mode for WiFi (0 = Wifi Off, 1 = Connect to AP, 2 = Create AP
28
SSID=A0RETSSID - Set SSID to either connect to or create
29
WPA2KEY=aBigSecret - Either passphrase or actual key
Copied!
To enter A0 System Menu using the Arduino IDE Serial Monitor, follow these steps:
- 1.If you don't already have the Arduino IDE installed, download and install the Arduino IDE from here.
- 2.Connect A0 to your computer with a USB cable (A0's LED should turn green)
- 3.Open Arduino IDE.
- 4.Select the port (port numbers change frequently, your port number will likely be different than the one pictured).
Open an Arduino Serial Monitor: (button in the upper right corner)
Set your baud rate to 1000000 if it is not already
Send a question mark (?) to open the Menu
On the left is the current setting. On the right in parentheses are the options. For example, BTmode=0 means Bluetooth is currently off. Send "BTmode=1" in the top line to turn it on. Send another ? to make sure the change was made.
Re-Flashing ESP32RET
ESP32RET is the firmware shipped pre-loaded on A0, follow these steps to return it back to that state.
- 1.Download the below Zip file
- 2.Extract the files
- 3.Plug A0 into your computer via USB
- 4.Run the correct file for your computer
- 1.PC - Updater.bat
- 2.MAC - Updater.sh
- 3.Linux - Updater.command
- 5.A green light should appear on the A0
A0-Production.zip
8MB
Binary
A0 Firmware Flash File
To compile the code yourself, find everything for ESP32RET here:
GitHub - collin80/ESP32RET: CAN Reverse engineering tool for ESP32 based boards (specifically EVTV ESP32Due)
GitHub
Feel free to make improvements, submit pull requests and post issues!
Putting your own code on A0 (using Arduino IDE)
This removes the preinstalled ESP32RET
Using Arduino to install your own sketch
The following steps are needed to get started programming on the Macchina A0 with the Arduino IDE:
- 1.Install the Arduino Desktop IDE
- 2.Install the Macchina A0 Board Configuration
- 3.Build and upload a sketch
Arduino Desktop IDE
Follow the official installation instructions for your operating system then return here to continue with Macchina A0 specific setup.
Board Definition
Before using Arduino IDE with A0 for the first time, you must follow the instructions in the link below to add ESP32 board definitions.
https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/boards_manager.md
github.com
Flashing A0
- 1.Make sure any dependent libraries are in your Arduino>Libraries folder
- 2.Connect A0 to your computer via a micro USB cable
- 3.In "Tools" set the Port
- 4.Select "ESP32 Dev Module" as board type
- 5.Upload a sketch
- 6.Press upload
Attached is a simple sketch "ColorPallette" for blinking the LED on A0 and the required "FastLED" Library (both need to be unzipped).
ColorPallette.zip
3KB
Binary
ColorPallette Sketch
FastLED.zip
351KB
Binary
FastLED Library
Last modified 8mo ago