Skip to content
John edited this page May 25, 2015 · 7 revisions

Introduction

The ebusd binary offers a lot of command-line options to adjust its behaviour. It can either be run as a daemon or in foreground.

Command-line

ebusd only accepts options:

ebusd [OPTION...]

The default value for each option is shown in square brackets like this: [default].

Device options

  • -d, --device=DEV
    Use DEV as eBUS device (serial device or ip:port) [/dev/ttyUSB0]

  • -n, --nodevicecheck
    Skip serial eBUS device test

  • --readonly
    Only read from device, never write to it

Message configuration options

  • -c, --configpath=PATH
    Read CSV config files from PATH [/etc/ebusd]

  • --checkconfig
    Check CSV config files, then stop

  • --dumpconfig
    Check and dump CSV config files, then stop

  • --pollinterval=SEC
    Poll for data every SEC seconds (0=disable) [5]

eBUS options

  • -a, --address=ADDR
    Use ADDR as own bus address [FF]

  • --acquireretries=COUNT
    Retry bus acquisition COUNT times [2]

  • --acquiretimeout=USEC
    Stop bus acquisition after USEC us [9400]

  • --answer
    Actively answer to requests from other masters

  • --numbermasters=COUNT
    Expect COUNT masters on the bus, 0 for auto detection [0]

  • --receivetimeout=USEC
    Expect a slave to answer within USEC us [15000]

  • --sendretries=COUNT
    Repeat failed sends COUNT times [2]

Daemon options

  • -f, --foreground
    Run in foreground

  • --localhost
    Listen for command line connections on 127.0.0.1 interface only

  • -p, --port=PORT
    Listen for command line connections connections on PORT [8888]

  • --httpport=PORT Listen for HTTP connections on PORT, 0 to disable [0]

  • --htmlpath=PATH Path for HTML files served by HTTP port [/var/ebusd/html]

Log options

  • -l, --logfile=FILE
    Write log to FILE (only for daemon) [/var/log/ebusd.log]

  • --logareas=AREAS
    Only write log for matching AREA(S):
    main,network,bus,update,all [all]

  • --loglevel=LEVEL
    Only write log below or equal to LEVEL:
    error/notice/info/debug [notice]

  • --lograwdata
    Log each received/sent byte on the bus

Dump options

  • --dumpfile=FILE
    Dump received bytes to FILE [/tmp/ebus_dump.bin]

  • --dumpsize=SIZE
    Make dump files no larger than SIZE kB [100]

  • -D, --dump
    Enable dump of received bytes

Other options

  • -?, --help
    Give this help list

  • --usage
    Give a short usage message

  • -V, --version
    Print program version