Skip to content

Latest commit

 

History

History
70 lines (45 loc) · 2.1 KB

README.md

File metadata and controls

70 lines (45 loc) · 2.1 KB

canny - A simple CAN-over-IP gateway

The original purpose of canny was to allow multiple machines to communicate with a CAN bus without the need for multiple CAN controllers. It was originally meant for development/evaluation and is NOT intended to be used in production environments. There are no security precautions taken to authenticate devices connecting from the IP-network, and messages are blindly forwarded without sanitizing their contents. It should go without saying that this is not meant to be used in an actual car or industrial control network.

Usage

There are two possible use-cases for canny:

  • To connect IP-based machines to a CAN bus
  • To connect two CAN buses over an IP network

How to use canny in these situations will be described in the following sections.

IP-to-CAN gateway

In the first case, canny can be started like this:

$ canny -p 1234

This way, canny will listen for incoming TCP connections on port 1234 and forward messages between all connected CAN buses and established TCP connections. However, messages received on one CAN bus will not be forwarded to another.

CAN-over-IP tunnel

To connect two CAN buses over an IP network, start canny on two different machines like the following example.

Start a canny server on machine A (let's assume its IP is 10.0.0.1):

$ canny -p 1234

Then, start canny as a client on machine B:

$ canny -c 10.0.0.1 -p 1234

Now, messages received on any CAN interfaces on machine A will be forwarded to all CAN interfaces of machine B, and vice-versa. Again, messages will not be forwarded between different CAN interfaces of the same machine.

Notes

You do not have to tell canny what SocketCAN interfaces to use for sending and receiving messages to and from the connected CAN buses. Upon startup, canny will iterate over all network interfaces, looking for interfaces containing the string "can". This way, most common interfaces (e.g. can0, vcan0) will be automatically detected.

License

Canny is free software, distributed under the terms of the GNU GPLv3+. For further information, see the COPYING file.