Cand

Der Cand[y] ist der Daemon der auf rl laeuft und die vom Canbus ankommenden Nachrichten verarbeiten kann. Urspruenglich war er nur als zentrale Instanz fuer lapcontrol gedacht. Lapcontrol ist dabei die Clientsoftware die von jedem Rechner aus gestartet werden kann und via tcp/ip eine Verbindung zu rl aufbaut. Genau genommen sieht es so aus, dass cand ein uart-tcp gateway ist. Damit fuegt er sich in die Struktur wie folgt ein:

 ---------------------     --------------------------------     -------------------------     --------------------------
| candevice - canport | - |canport - cangateway - uartport | - |uartport - cand - tcp/ip | - | tcp/ip - lapcontrol - UI | 
 ---------------------     --------------------------------     -------------------------     --------------------------

start des cand

Cand wird mit auf rl mit

start cand

gestartet resp mit

stop cand

gestoppt. Es ist davon abzuraten den cand von hand zu starten, da er unter einem spez benutzer laeuft der unter anderem schreibenden zugriff auf /var/log/cand hat. Aus sicherheitsgruenden sollte der cand auch nicht als benutzer root gestartet werden, was durch die start/stop-scripte sicher gestellt ist. Daher die obenstehenden commands nur als root ausfuehren

logging

Der cand loggt alles was auf dem Canbus (eigentlich ja auf der uart) passiert mit. Diese Datei befindet sich unter /var/log/cand/cand.log. Sie sollte einmal in der Woche von logrotate rotiert werden. Sie kann mit unter recht gross werden, wenn Geraete ueber den can-bus ein neues image erhalten.

scripting

Es ist moeglich den cand auf spez. events des can-bus reagieren zu lassen. Dafuer ist unter /etc/cand/ die datei cand.scripts gedacht. Diese hat ein recht eigenwilliges Format da hier kurz am beispiel der Uhrzeitanzeige des Laufschriftborgs beschrieben ist. Die beschreibende Zeile ist

0x24:0x30 0x00:0x30 0x01 -> /etc/cand/timeserv.sh

Das liesst sich wie folgt:

src_addr:src_port dst_addr:dst_port data_length -> command_to_call

wenn also ein packet auf dem bus ankommt, das die entsprechenden eigenschaften hat (src/dst/payloadlength) wird das entsprechenden Command ausgefuehrt. Diese command bekommt dabei als ARGV die daten mit. Ein entsprechendes Script saehe dann z.b. so aus:

#!/bin/bash
DATALENGHT=$1
FIRSTDATABYTE=$2
SECONDDATABYTE=$3
...
LASTDATABYTE=$n #entspricht n=$DATALENGTH+1 max(n)=9

Die uebergebenen Werte kommen alle als Hexwerte rein. Also z.b. '0xde' '0xeb'

listen

Der cand heoert per default auf den Port 2342.

source

http://das-labor.org/trac/browser/autoLab/cand http://das-labor.org/trac/browser/autoLab/labcontrol