https://github.com/m10k/canny

Simple CAN-over-IP gateway
https://github.com/m10k/canny

can-bus can-fd canbus canfd gateway in-vehicle-network socketcan

Last synced: 3 months ago
JSON representation

Simple CAN-over-IP gateway

• Host: GitHub
• URL: https://github.com/m10k/canny
• Owner: m10k
• License: gpl-3.0
• Created: 2016-06-27T12:51:56.000Z (about 8 years ago)
• Default Branch: unstable
• Last Pushed: 2023-04-08T05:26:41.000Z (over 1 year ago)
• Last Synced: 2024-01-24T15:12:16.490Z (6 months ago)
• Topics: can-bus, can-fd, canbus, canfd, gateway, in-vehicle-network, socketcan
• Language: C
• Homepage:
• Size: 66.4 KB
• Stars: 16
• Watchers: 6
• Forks: 9
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Lists

• awesome-canbus - canny - Simple CAN-over-IP gateway. (Utils / CAN-over-IP)

README

        
# 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.