Overview: WiCAN Pro (Forked Edition).
If you are looking for a way to pull live vehicle telemetry—like State of Charge, RPM, tire pressures, or raw CAN frames—and route it seamlessly into your smart home or custom servers, you are in the right place. Docs located at: Home · WiCAN Docs
What is the WiCAN Pro?
At its core, the WiCAN Pro is a powerful, ESP32-S3-based OBD2 and CAN bus interface. It plugs directly into your vehicle's diagnostic port and acts as a bridge between your car's internal networks and your Wi-Fi or Bluetooth devices. It supports standard OBD2 protocols (via an ELM327-compatible interpreter) as well as raw CAN bus monitoring and injection.
Why the Forked Edition?
The original (stock) WiCAN firmware was great for basic polling, but it relied on a "flat list" architecture. Every PID was polled blindly on a timer, which often resulted in network spam, slow update rates, and unnecessary battery drain when the car was off. Also, the stock documentation was dated and incomplete. I have created new Docs covering botht he stock and super charged functionality. See Home · WiCAN Docs
This Forked Edition completely rewrites the automation and networking engines. It transforms the WiCAN Pro from a simple OBD scanner into a highly intelligent, edge-computing telemetry node. If you wish to try out the WiCAN Pro forked firmware see the release Wambs Forked Firmware Releases
Core Performance & Polling
- Grouped PIDs: Clusters PIDs with the same initialization strings to cut polling overhead by up to 80%, delivering fast, synchronized data snapshots.
- "On Change" Transmission: Dramatically reduces cellular data usage and MQTT broker spam by only transmitting when a PID's value actually changes.
- Expression Hex Support: Allows raw hex strings over MQTT to bypass integer limits, simplifying the decoding of complex multi-byte data (like TPMS packets) in Home Assistant.
Network & Connectivity
- Native Tailscale Integration: Authenticate the ESP32 directly to your Tailscale mesh. Easily punches through cellular CGNAT and Starlink connections without requiring complex port forwarding.
- Scheduled Wake-Up Time: Configure specific network wake-up schedules, allowing the device to automatically power up, connect, and report telemetry at designated times even when the vehicle is parked and off.
- Failover Webhooks: Supports primary and secondary URLs, seamlessly falling back from a local IP to an external Nabu Casa link if the primary connection drops.
- Static IP & Custom AP SSIDs: Assign a fixed IP to bypass DHCP issues and broadcast a custom Wi-Fi SSID directly from the dongle.
UI & Device Management
- MQTT On-Demand Group Toggling: Turn specific groups of PIDs on or off on the fly directly via MQTT commands from Home Assistant (perfect for switching polling profiles based on whether the car is driving or charging).
- Group Play/Test Button: The Web UI now includes a dedicated play/test button to instantly fire off and validate entire groups of PIDs at once, rather than forcing you to test them individually.
- Revamped Web Interface: Features a drag-and-drop workflow for managing, moving, or temporarily disabling PIDs without needing to edit complex JSON files.
- One-Click PID Importing: Quickly import standard or vehicle-specific PIDs directly into your active groups using UI copy buttons.
Power & Stability
- Advanced Low-Voltage Protection: Automatically pauses polling if the 12V battery drops below a custom threshold, and resumes when the alternator recharges it.
- Sleep & Wakeup Fixes: Patches unexpected network-triggered wakeups (like WireGuard/Netif) that can inadvertently drain the car battery.
- Restart Tracker: Protects the hardware by automatically forcing the device into deep sleep if a continuous bootloop is detected.
