MeatPi Discord server
Please update to the latest firmware version
We are currently in the process of migrating from this large README.md into the proper docs.
Order on Mouser or Crowd Supply!
Ongoing crowdfunding campaign for a new product in development! If you would like to support this project, please subscribe for updates on Crowd Supply!
*** To activate the 120R termination resistor, simply connect the TR pin to CANH. The other end of the termination resistor is connected to CANL internally.
webCAN Coming soon!
- The OBD2 adapter is not designed to powered of the USB connecter. The USB connector can power the adapter to flash custom firmware or hardreset the deivce and can also be used for debuging.
- It is highly recommanded to turn OFF the BLE if not used. Otherwise it might affect the preformance.
- When the BLE is connected, the device configuration access point will be disabled i.e you won't be able to configure the device unless you disconnect the BLE, by turning off the BLE on your phone or device.
- If AP+Station mode is enabled, only use station IP to communicate with the device and AP must be used for configuration only.
- Install ESP-IDF >= v5.1.
- Clone project.
- Open project and build.
WiCAN is a powerful ESP32-C3-based CAN adapter for car hacking and general CAN-bus development. It is available in two form factors, OBD-II and standard USB-CAN. The original firmware can use Wi-Fi or BLE to interface directly with RealDash, which allows you to create your own custom dashboards with stunning graphics. It is available for Android, iOS, and Windows 10. WiCAN connects to your existing Wi-Fi network and any device on that network, where it allows you to configure Wi-Fi and CAN settings through a built-in web interface. Both versions have a power-saving mode that detects when the voltage drops under 13 V or some other preset value. When this power-saving mode is engaged, WiCAN is capable of entering sleep mode, which drops current consumption below 1 mA.
WiCAN is a simple, ready-to-use solution for CAN-bus development and hacking. It accelerates development by providing vehicle-diagnostic APIs and libraries in various languages and for various operating systems. WiCAN works with a large array of pre-existing vehicle-diagnostic libraries, including RealDash, SavvyCAN, BUSmaster, python-can/SocketCA, and more. APIs are also available for LabView, C#, VB.Net, Delphi, and Python in case you’re writing your own software.
WiCAN-OBD will be of great interest to car enthusiasts and tinkers who want to modernize or customize the head-unit displays in their cars using RealDash. Check out some examples of the available graphic interfaces, which are supported by a robust collection of Manuals & Tutorials to get you started with RealDash.
Another great feature of WiCAN-OBD is its MQTT battery alerts. It can monitor your battery voltage and send an alert if that voltage drops under a set threshold. This feature is especially important for users who own multiple cars they do not use regularly.
WiCAN-USB can be powered through USB or through a screw-terminal connector. The hardware and firmware is almost identical to WiCAN-OBD, but with an extended voltage range up to 36 V. Many of the projects we work on involve 12 V or 24 V trucks, and WiCAN-USB comes in handy when we need to monitor those trucks remotely, from the comfort of our desks, by configuring them to connect to Wi-Fi. And, thanks to its low cost, we don’t need to worry about breaking or losing it the WiCAN-USB device itself.
WiCAN-USB can also be used as a USB-to-CAN adapter when Wi-Fi connectivity is not available or when a hardwired connection is needed.
- Supports CAN2.0A/B up to 1Mbits.
- Works with Realdash, based on "realdash 66"
- Supports SocketCAN and works with BUSMaster
- Supports TCP and UDP
- WiFi can be used in AP and station mode
- WiFi and CAN configured using web interface.
- Diode protection for the USB port
- Power up the device using the USB cable, or by plugging into the OBD-II connector.
- The blue LED will light ON, and a WiFi device access point will start. The SSID will look like: WiCAN_xxxxxxxxxxxx
- Connect to the SSID using the default password: @meatpi#
- Using a web browser, go to http://192.168.80.1/
- The status menu shows the device current configuration, if in Ap+Station mode it will show the device IP on your local network if connected successfully.
- The WiFi menu lets you configure the WiFi parameters. It is recommended that you change the AP access point.
- The CAN menu allows to choose the protocol set the bitrate and TCP/UPD port number.
- When ready click submit Changes button and the device will store the configuration reboot immediately.
Note: If you intend to use the device in AP mode it is recommand that you disable the BLE function
You need to download the right version of BUSMaster provided in this Link. Here is how to setup the hardware.
- Go to configuration webpage.
- Baudrate can be set in BUSMaster configuration
- Set "Port Type" = TCP
- Set "Protocol" = slcan
- Click submit changes.
- Select VSCom CAN-API by clicking on 'Driver Selection -> VSCom CAN-API"
- Then Click on 'Channel Configuration -> Advanced'
- Fill in the IP and port. Example: 192.168.80.1:3333
- Check the 'Hardware Timestamps' check box.
- Choose the Baudrate.
- Click 'OK', then Click the Connect button on the top left corner.
WiCAN-OBD and WiCAN-USB can connect with RealDash using either WiFi or BLE. The protocol and CAN bitrate must be set using the configuration page. BLE is supported only on Android and iOS. Windows 10 supports only WiFi connections. Additionally, WiCAN-USB can connect using the USB interface.
- Go to garage then click on the dashboard.
- Click Add connection.
- Select Adapter (CAN/LIN)
- Select RealDash CAN
- Select SERIAL/USB
- Select device
- Set Baud RATE: 4000000 (This is the usb/serial buadrate not the CAN bitrate)
- Click next then Done
- Go to configuration webpage.
- Select the baudrate
- Set "Port Type" = TCP
- Set "Protocol" = reladash 66
- Click submit changes.
- Go to garage then click on the dashboard.
- Click Add connection.
- Select Adapter (CAN/LIN)
- Select RealDash CAN
- Select WIFI/LAN
- Enter IP and Port
- Click Done
If you're using firmware verion v1.64 or below please update to the latest version before enabling BLE
- Go to configuration webpage.
- Select the baudrate
- Set the "BLE Status" to enable
Note: When the BLE is connected, the device will automatically turn off the WiFi configuration access point. Once BLE is disconnected the configuration access point will turn back on.
- Download SavvyCAN
- Connect to the device AP.
- Open SavvyCAN and Click Connection->Open Connection Window->Add New Device
- Select "Network Connection", if you're on the same network it auto detect the IP.
- Click Create New Connection.
- Then select "Enable Bus" checkbox.
Change to protocol in the device configuration page to "slcan", then create a virtual serial port over TCP on your Linux machine. If WiCAN is connected to your home network replace "192.168.80.1" with device IP.
sudo socat pty,link=/dev/netcan0,raw tcp:192.168.80.1:3333 &
sudo slcand -o -c -s8 /dev/netcan0 can0
sudo ifconfig can0 txqueuelen 1000
sudo ifconfig can0 up
sudo slcand -o -s6 -t sw -S 4000000 /dev/ttyACM0 can0
sudo ifconfig can0 txqueuelen 1000
sudo ifconfig can0 up
If you're using firmware verion v1.64 or below please update to the latest version before enabling BLE
- Go to configuration webpage.
- Select the baudrate
- Set "Port Type" = TCP
- Set "Protocol" = elm327
- Enable BLE if needed. Note
- Click submit changes.
- Go to garage then click on the dashboard.
- Click Add connection.
- Select Adapter
OBD2 - Select Bluetooth or WiFi
- If WiFi fill in the IP 192.168.80.1 and port 3333.
- Click on
OBD2 PROTOCOLand select your car protocol, (11 bit ID, 500Kbit) or (11 bit ID, 250Kbit) - Activate
Request Only First Reply - Click Done.
© 2023 meatPi Electronics | www.meatpi.com | PO Box 5005 Clayton, VIC 3168, Australia