Socketcand is a daemon that provides access to CAN interfaces on a machine via a network interface. The communication protocol uses a TCP/IP connection and a specific protocol to transfer CAN frames and control commands. The protocol specification can be found in ./doc/protocol.md.
To build and run socketcand make sure you have the following tools installed:
- gcc or another C compiler
- a kernel that includes the SocketCAN modules
- the headers for your kernel version
- the libconfig with headers (libconfig-dev under debian based systems)
to create the 'configure' script.
Then run the created script with
to check your system and create the Makefile. If you want to install scripts for a init system other than SysVinit check the available settings with './configure -h'. To compile and install the socketcand run
$ make $ make install
The daemon uses a simple UDP beacon mechanism for service discovery. A beacon containing the service name, type and address is sent to the broadcast address (port 42000) at minimum every 3 seconds. A client only has to listen for messages of this type to detect all SocketCAN daemons in the local network.
socketcand [-v | --verbose] [-i interfaces | --interfaces interfaces] [-p port | --port port] [-l ip_addr | --listen interface] [-h | --help]
Description of the options
- -v activates verbose output to STDOUT
- -i interfaces is used to specify the SocketCAN interfaces the daemon shall provide access to
- -p port changes the default port (29536) the daemon is listening at
- -l interface changes the default network interface (eth0) the daemon will bind to
- -h prints a help message