eBUS Adapter micro-ebusd

Extended eBUS Adapter Shield Interface (“easi>”)

When micro-ebusd is running, it extends the adapter REPL with micro-ebusd specific commands.

Added commands

For the time being, the following added (or extended) commands are supported:

• “hex”:
  send arbitrary hex message, e.g. using “hex 150704” for sending the ID query to 0x15
• “raw”:
  toggle logging of raw messages
• “level”:
  change the log level of ebus/ebusd components to none/error/notice/info/debug (default is notice)
• “info”:
  show some general status info (similar to ebusd) as well as seen participants, their scan status and the loaded message definition files. The output looks like this:

  ...
  signal: acquired
  symbol rate: 89
  max symbol rate: 162
  min arbitration micros: 26
  max arbitration micros: 89
  min symbol latency: 3
  max symbol latency: 9
  scan: finished
  masters: 3
  messages: 608
  conditions: 33
  cache: 50/50, size 6277, max age 65
  queue: idle, empty, size 0/2, direct, state 2=ready
  address 03: master
  address 08: slave, scanned Vaillant;EHP00;327;7201, MF done 10002779, loaded b508.ehp
  address 10: master
  address 15: slave, scanned Vaillant;UIH00;374;6901, MF done 20093224, loaded b515.uih
  address 23: slave, scanned Vaillant;EHP00;327;7201, MF done 10002779, loaded b523.ehp.cc
  address 25: slave, scanned Vaillant;EHP00;327;7201, MF done 10002779, loaded b525.ehp.hwc
  address 31: master, self
  address 36: slave, self
  address 50: slave, scanned Vaillant;EHP00;327;7201, MF done 10002779, loaded b550.ehp.mc
  file 0: address fe/aa, MF 00, circuit broadcast, source fe.broadcast, 7 entries, max ID 4, 0 conditions (0/0)
  file 1: address aa/a9, MF b5, circuit scan, source b5, 2 entries, max ID 5, 0 conditions (0/0)
  file 2: address fe/aa, MF b5, circuit broadcast, source b5fe.broadcast, 5 entries, max ID 5, 0 conditions (0/0)
  file 3: address 08/03, MF b5, circuit ehp, source b508.ehp, 276 entries, max ID 7, 16 conditions (1448/ffffffff)
  file 4: address 15/10, MF b5, circuit uih, source b515.uih, 136 entries, max ID 7, 7 conditions (5e/ffffffff)
  file 5: address 23/aa, MF b5, circuit cc, source b523.ehp.cc, 31 entries, max ID 7, 0 conditions (0/0)
  file 6: address 25/aa, MF b5, circuit hwc, source b525.ehp.hwc, 52 entries, max ID 7, 3 conditions (0/ffffffff)
  file 7: address 50/aa, MF b5, circuit mc, source b550.ehp.mc, 99 entries, max ID 7, 7 conditions (66/ffffffff)
  

• “read”:
  read a message from the bus (or the cache)
• “write”:
  write a message to the bus
• “find”:
  find messages matching the criteria
• “cache”:
  show info about cached messages (allows to clear it and has a verbose mode with count, age, and circuit/message name if known)
• “rm”:
  remove a downloaded file or all of them (using “rm /data/*”, needs a reboot to fill them up again)

Command help

All commands provide help when using “-?” or “–help” as single argument, e.g. using “hex -?” reveals:

hex [-?|--help] [-s QQ] ZZPBSB[DD]*
  Send hex message
         -s QQ  override source address
   ZZPBSB[DD]*  ZZ destination, PBSB primary/secondary command, DD data byte(s)