X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=2637f7f811213476bfa978a54188f0a0a2473231;hb=fae627b646e9ab709adbd0c60d7582176375e0c3;hp=13622d683ac059b2600865b6b64e46f8541d9369;hpb=8e6aeac288787abbe415c90c8ef490a90b2a6c46;p=apps%2Fagl-service-can-low-level.git diff --git a/README.md b/README.md index 13622d68..2637f7f8 100644 --- a/README.md +++ b/README.md @@ -1,80 +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 -* 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 - -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.