-It's meant to generate from a JSON file describing CAN messages and diagnostic message (OBD2 for now), a cpp file to integrate with the project.
-
-Once generated binding is built with it and result will be a widget file to install on an AGL target system.
-
-![OpenXC_to_AGL][OpenXC_to_AGL]
-
-## AGL CAN binding architecture proposal
-
-Bring CAN management into the AGL project is more than allowing decode and print CAN messages, lot of tools can do that (Wireshark, CAN-utils, ...).
-
-The goal is to provide a common API and abstraction to the CAN bus then you can bring some more high level functionnalities to the system.
-
-CAN binding will be separated in two parts:
-
-![CAN_mapping][CAN_mapping]
-
-- High level: Binding from which others applications will connect to.
-It will provides valuable access to the CAN bus by aggregate signals or providing new signals from several originals. For example, a signal exposing whether or not a door is open, no matter which one it is. Also, we can imagine an application which supervise if there is no one in the car but moving (1m, 2m ?) to alert the owner of an unexpected behavior. The high level binding will sends a single event representing that behavior to the application which in turn will send a phone message to.
-
-- Low level: Decode messages that transit and send event through **Application Framework** to the subscribers with human readable message. It provides some basic access to the bus + some basic mathematical, statistical features (last_values, min, max, timestamps, averaging) as well as basic filter to get discerning signal only (This part are not implemented yet in the low level).
-
-
-![Binding_architecture][CAN_bindings_communication]
-
-Last be not least, the low level binding can be shipped as binary only using OpenXC inspired [generator][generator].
-
-# Prerequirements
-
-- Make sure you already have set up the AGL SDK before using the following [guide][SDK_instructions].
-
-- This repo make use of git submodule, make sure to execute the following commands from the repository once cloned :
-
-```bash
-$ git submodule init
-$ git submodule update
-```
-
-- An [USB CAN adapter][USB_CAN] connected to OBD2 connector through the [right cable][OBD2_cable].
-
-- Make sure you have installed the AGL generator else you aren't able to generate custom low-level CAN binding. Generator can be found [here][generator] with the attached instruction to install and run it. It will produce a *configuration-generated.cpp* file to paste in the source, *src/*, directory.
-
-# Getting started
-
-## Compile and install the binding
-
-With an AGL SDK environment correctly set, I encourage you to set the TARGET variable in the root CMakeLists.txt file if you have an AGL target already running in your network.
-
-Then you can directly build and install the binding and source directory on your target system.
-
-Execute commands to get your binding compile :
-
-```bash
-$ mkdir build
-$ cd build
-$ cmake ..
-$ make
-```
-
-And if you have set TARGET variable, you can install it on your AGL system :
-
-```bash
-$ make install
-[ 16%] Built target bitfield
-[ 27%] Built target isotp
-[ 40%] Built target openxc
-[ 48%] Built target uds
-[ 97%] Built target low-can-binding
-[100%] Built target widget
-Install the project...
--- Install configuration: ""
-true
-{ "added": "low-can-binding@0.1" }
-```
-
-It's possible that you'll see the following message :
-
-```bash
-Error org.freedesktop.DBus.Error.Failed: "system error"
-```
-It's because installation remove the binding before installing it.
-
-If it is the first time that you make the installation then you'll have this message in place of ***true***.
-
-To install it manually, you need to copy the *low-can-binding.wgt* file on your target, then from it execute the following commands :
-
-On your host, to copy over the network :
-```bash
-$ scp low-can-binding.wgt root@<target_IP>:~
-```
-
-On the target, assuming ***wgt*** file is in the root home directory :
-
-```bash
-~# afm-util install low-can-binding.wgt
-{ "added": "low-can-binding@0.1" }
-```
-## Install AFB Websocket CLI client to test the binding.
-
-You can test it using afb-client-demo CLI tool provided by the RPM package *libafbwsc-dev*.
-
-You can find this package in your build environment, using docker SDK recommended setup the file is */xdt/build/tmp/deploy/rpm/<your-target-arch>/*.
-
-Using Renesas RCar Gen2, Porter board, you have to copy the file like this if your board is connected to your network and you know its IP address:
-
-```bash
-$ scp /xdt/build/tmp/deploy/rpm/cortex15hf_neon/libafbwsc-dev-1.0-r0.cortexa15hf_neon.rpm root@<target_IP>:~
-```
-
-Else, you have to copy into the SDcard with the AGL image installed on it.
-
-From the docker image copy RPM to the shared directory between docker image and your host:
-
-```bash
-$ cp /xdt/build/tmp/deploy/rpm/cortex15hf_neon/libafbwsc-dev-1.0-r0.cortexa15hf_neon.rpm ~/share
-```
-
-Then plugin you SDcard in your Linux host (Windows can't read ext4 filesystem AGL runs on) and copy RPM file on it.
-
-From you host, identify SDcard block device node here it is **sdc** with the correct capacity automounted by the desktop manager:
-
-```bash
-$ lsblk
-loop1 7:1 0 2G 0 loop
-└─docker-253:0-3146365-pool 253:3 0 100G 0 dm
- └─docker-253:0-3146365-e9f80849a2681e18549d3a4238cbf031e44052e36cd88a0abf041804b799b61c
- 253:4 0 10G 0 dm /var/lib/docker/devicemapper/mnt/e9f80849a2681e18549d3a4238cbf031e44052e36cd88a0abf041804b799b61c
-sdb 8:16 0 238.5G 0 disk
-├─sdb2 8:18 0 238G 0 part
-│ └─Shamash-agl 253:1 0 238G 0 lvm /home/claneys/Workspace/agl-docker
-└─sdb1 8:17 0 500M 0 part /boot
-sr0 11:0 1 1024M 0 rom
-loop0 7:0 0 100G 0 loop
-└─docker-253:0-3146365-pool 253:3 0 100G 0 dm
- └─docker-253:0-3146365-e9f80849a2681e18549d3a4238cbf031e44052e36cd88a0abf041804b799b61c
- 253:4 0 10G 0 dm /var/lib/docker/devicemapper/mnt/e9f80849a2681e18549d3a4238cbf031e44052e36cd88a0abf041804b799b61c
-sdc 8:32 1 14.9G 0 disk
-└─sdc1 8:33 1 2G 0 part /run/media/claneys/97f418a5-612f-44e9-b968-a19505695151
-sda 8:0 0 931.5G 0 disk
-├─sda2 8:2 0 500G 0 part
-│ ├─Shamash-home 253:2 0 150G 0 lvm /home
-│ └─Shamash-root 253:0 0 50G 0 lvm /
-└─sda1 8:1 0 16G 0 part [SWAP]
-```
-
-Copy, still from your host:
-
-**Careful : Make sure to sync IO with sync command before unplug your SDcard. It could be corrupted if removed before all pending IO aren't done.**
-
-```bash
-$ sudo cp ~/devel/docker/share/libafbwsc-dev-1.0-r0.cortexa15hf_neon.rpm /run/media/claneys/97f418a5-612f-44e9-b968-a19505695151/home/root
-$ sync
-```
-
-Insert the modified SDcard in your Porter board and boot from it. Your are ready to go.
-
-## Configure the AGL system
-
-### Virtual CAN device
-
- Connected to the target, here is how to load the virtual CAN device driver and set up a new vcan device :
-
-```bash
- ~# modprobe vcan
- ~# ip link add vcan0 type vcan
- ~# ip link set vcan0 up
- ```
-
-### CAN device using the USB CAN adapter
-
-Using real connection to CAN bus of your car using the USB CAN adapter connected to the OBD2 connector. (This instruction assuming a speed of 500000kbps for your device, you can try supported bitrate like 125000, 250000 if 500000 doesn't work) :