can.md

CAN-Bus on AGL

CAN-bus can be used with the agl-service-can-low-level .

Therefore a CAN bus device must be attached e.g. a virtual (vcan) or a serial (slcan).

To enable a virtual can device use following commands

modprobe vcan
ip link add vcan0 type vcan
ip link set vcan0 up

To enable a virtual can device use following commands

/sbin/modprobe slcan; 
/usr/bin/slcan_attach -f -s5 -o /dev/ttyACM0;
/usr/bin/slcand ttyACM0 slcan0;
/sbin/ifconfig slcan0 up

that could although be done with a service-file in /lib/systemd/system

After that you are able to use the commands

candump CANDEVICE(vcan0 | slcan0) // print the messages on canbus
cangen CANDEVICE(vcan0 | slcan0)  // generate random messages on canbus
cansend CANDEVICE(vcan0 | slcan0) 123#DEADBEEF // send a specific message with id#bytes

For the right mapping for the agl-service-can-low-level you need a file /etc/dev-mapping.conf with :

; Default CAN device mapping
; Format has to follow ini rules key="value", notice " around value.

[CANbus-mapping]
hs="slcan0"
ls="slcan0"

according with your candevice.

By entering the following command attention for the right version, you could check that with afm-util list -a

afm-util detail agl-service-can-low-level@8.0

you should get following information and we are interrested in the http-port :

{
  "description":"Expose CAN Low Level APIs through AGL Framework",
  "name":"agl-service-can-low-level",
  "shortname":"",
  "id":"agl-service-can-low-level@8.0",
  "version":"8.0.0-3977705",
  "author":"Romain Forlot <romain.forlot@iot.bzh>",
  "author-email":"",
  "width":"",
  "height":"",
  "icon":"/var/local/lib/afm/applications/agl-service-can-low-level/8.0/icon.png",
  "http-port":31022
}

After that you should be able with afb-client-demo --human 'IPADRESS:31022/api?token=HELLO&uuid=magic' to connect to the serice.

There you could use the following commands AGL Docs CAN :

low-can list // to get a list of all messages
low-can subscribe {"event": "*"} // subscribe to all messages
low-can auth  // authorize writing
low-can write { "signal_name": "hvac.temperature.left", "signal_value": 2} //send can message 
low-can write { "signal_name": "hvac.temperature.average", "signal_value": 2} // send can message

The upper sequence should give you json messages back.