vehicle/ecus

The vehicle/ecus URI gets a list of detected vehicle ECUs.

URI path

vehicle/ecus

Supported request methods

GET

Query the system for the list of addressable ECUs in the vehicle. The data record returned is a list of URIs corresponding to the “children” of vehicle/ecus in the web services data tree.

Each ECU in the system is referenced by a J1939/CAN bus number, and the ECU address number. A standard ECU in vehicles, for instance, is at address 0, which is defined as the primary engine. The reference designation for the engine on CAN bus 1 is can1ecu0. Both the CAN bus number and the ECU address number in the reference designator are expressed in decimal. ECU address numbers are generally sparse.

Supported content types

HTML

The result URIs are turned into URLs relative to the device, and returned in an HTML list.

XML

The result URIs are each wrapped in element tags, and returned within an ecus block. For example:

<ecus>
         <element>vehicle/ecus/can0ecu0</element>
         <element>vehicle/ecus/can0ecu2</element>
         <element>vehicle/ecus/can1ecu25</element>
</ecus>

JSON

The result URI strings are collected in an array assigned to an ecus field. For example:

{ “ecus” : [ “vehicle/ecus/can0ecu0”,
             “vehicle/ecus/can0ecu2”,
             “vehicle/ecus/can1ecu5” ] }