X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=2637f7f811213476bfa978a54188f0a0a2473231;hb=5773aa807454aef8203f277733ff68de705f0198;hp=81574a5cb765a404ce76b156fd99968307588e6a;hpb=9bce073224cd7fb47327743ddc786199887556dc;p=apps%2Fagl-service-can-low-level.git diff --git a/README.md b/README.md index 81574a5c..2637f7f8 100644 --- a/README.md +++ b/README.md @@ -1,99 +1,16 @@ -# OpenXC Message Format Specification +# CAN signaling binder -This specification is a part of the [OpenXC platform][OpenXC]. +CAN bus binder, based upon OpenXC vi-firmware project. -An OpenXC vehicle interface sends generic vehicle data over one or more output -interfaces (e.g. USB or Bluetooth) as JSON objects, separated by newlines. +Full document can be found under `docs` directory. -There are two valid message types - single valued and evented. +# Fast build procedure -There may not be a 1:1 relationship between input and output signals - i.e. raw -engine timing CAN signals may be summarized in an "engine performance" metric on -the abstract side of the interface. +Just use autobuild script: -## Single Valued +```bash +./conf.d/autobuild/agl/autobuild build +./conf.d/autobuild/agl/autobuild package +``` -The expected format of a single valued message is: - - {"name": "steering_wheel_angle", "value": 45} - -## Evented - -The expected format of an event message is: - - {"name": "button_event", "value": "up", "event": "pressed"} - -This format is good for something like a button event, where there are two -discrete pieces of information in the measurement. - -## Official Signals - -These signal names are a part of the OpenXC specification, although some -manufacturers may support custom message names. - -* steering_wheel_angle - * numerical, degrees -* torque_at_transmission - * numerical, Nm -* engine_speed - * numerical, RPM -* vehicle_speed, numerical, Kph -* accelerator_pedal_position - * percentage -* parking_brake_status - * boolean, (true == brake engaged) -* brake_pedal_status - * boolean (True == pedal pressed) -* transmission_gear_position - * states: first, second, third, fourth, fifth, sixth, seventh, eighth, - reverse, neutral -* gear_lever_position - * states: neutral, park, reverse, drive, sport, low, first, second, third, - fourth, fifth, sixth -* odometer - * Numerical, km -* ignition_status - * states: off, accessory, run, start -* fuel_level - * percentage -* fuel_consumed_since_restart - * numerical, liters (goes to 0 every time the - vehicle interfaces power cycles) -* door_status - * Value is State: driver, passenger, rear_left, rear_right. - * Event is boolean: true == ajar -* headlamp_status - * boolean, true is on -* high_beam_status - * boolean, true is on -* windshield_wiper_status - * boolean, true is on -* latitude - * numerical -* longitude - * numerical - -## Raw CAN Message format - -An OpenXC vehicle interface may also output raw CAN messages. Each CAN message -is sent as a JSON object, separated by newlines. The format of each object is: - - {"bus": 1, "id": 1234, "value": "0x12345678"} - -**bus** - the numerical identifier of the CAN bus where this message originated, - most likely 1 or 2 (for a vehicle interface with 2 CAN controllers). - -**id** - the CAN message ID - -**data** - up to 8 bytes of data from the CAN message's payload, represented as - a hexidecimal number in a string. Many JSON parser cannot handle 64-bit - integers, which is why we are not using a numerical data type. - -License -======= - -Copyright (c) 2012-2013 Ford Motor Company - -Licensed under the BSD license. - -[OpenXC]: http://openxcplatform.com +This will build both projects under build directory for each of them with default configuration.