User Custom PIDs & Filters

The User Custom tab is the ultimate sandbox for advanced users. If a parameter isn't available in the Standard or Vehicle Specific libraries, or if you've reverse-engineered a proprietary CAN ID on your vehicle, this is where you input it.

This tab is divided into two distinct tools: Custom PIDs (Active Polling) and Custom Filters (Passive Listening).

1. Custom PIDs (Active Polling)

Custom PIDs are used when the WiCAN Pro must ask the vehicle's ECU for a piece of data (Request/Response).

How to configure a Custom PID:

  1. Navigate to Automate > Automate Parameters > User Custom.
  2. Click New PID.
  3. Fill out the configuration fields:
    • Name: A unique identifier for your data (e.g., Inverter Temp).
    • Init: (Optional) A specific initialization string sent before the PID request. Often used to set the CAN header (e.g., ATSH7E4).
    • PID: The hexadecimal request payload (e.g., 220105).
    • Expression: The math formula to decode the raw response. (See the Math & Expressions guide).
    • Unit / Class / Min / Max: Metadata passed to Home Assistant for proper dashboard formatting (e.g., Unit: °C, Class: temperature).
    • Period (ms): How often to send this request.
    • Destination Type / Send_to: Where to route the data (e.g., MQTT_Topic).

!TIP Just like Standard PIDs, you can click the Test button on a Custom PID card to fire the request at your vehicle immediately and verify your expression works before saving.

2. Custom Filters (Passive Listening)

Unlike PIDs that ask the ECU for data, Custom Filters passively listen to the background chatter on the CAN bus. If your car constantly broadcasts steering wheel angle on Frame ID 0x025 without being asked, you use a Filter to catch it.

How to configure a Custom Filter:

  1. Scroll down to the Custom Filters section.
  2. Click New Filter.
  3. Fill out the configuration fields:
    • Frame ID: The specific CAN bus address you want to listen to (e.g., 0x25 or 37 in decimal).
    • Name: What this data represents.
    • Expression: The math formula to decode the payload.
    • Period (ms): Since passive data might broadcast 100 times a second, the Period acts as a throttle. A period of 1000ms means the WiCAN will only process and forward this frame once per second, ignoring the rest to save Wi-Fi/MQTT bandwidth.

!IMPORTANT Custom Filters require the WiCAN Pro's CAN Mode to be set correctly. They work perfectly in Normal Mode or Silent Mode (Listen Only).

3. Integrating with Vehicle Groups

Just like Standard and Vehicle Specific PIDs, you do not have to leave your Custom PIDs and Filters running in a flat list.

  1. Once you have built your Custom PIDs and Filters, save your configuration.
  2. Navigate to the Vehicle Groups tab.
  3. Click the "Copy Custom PIDs" button to automatically import your custom requests and filters into an organized profile.
Table of Contents