mirror of
https://github.com/daniviga/django-ram.git
synced 2026-03-22 16:22:29 +01:00
56 lines
1.3 KiB
Markdown
56 lines
1.3 KiB
Markdown
# DCC Serial-to-Network Bridge
|
|
|
|
This directory provides two ways to bridge a serial port to a network port using `ncat` from [nmap](https://nmap.org/ncat/):
|
|
|
|
1. **Auto-Start with systemd + udev** (Recommended) - Automatically starts/stops when USB device is plugged/unplugged
|
|
2. **Container-based** - Manual control using Podman/Docker
|
|
|
|
> [!IMPORTANT]
|
|
> Other variants of `nc` or `ncat` may not work as expected.
|
|
|
|
## Option 1: Auto-Start with systemd + udev (Recommended)
|
|
|
|
Automatically start the bridge when USB device `1a86:7523` is connected to `/dev/ttyUSB0` and stop it when removed.
|
|
|
|
### Quick Install
|
|
|
|
```bash
|
|
./install-udev-rule.sh
|
|
```
|
|
|
|
### Features
|
|
- ✅ Auto-start when device connected
|
|
- ✅ Auto-stop when device removed
|
|
- ✅ User-level service (no root needed)
|
|
- ✅ Runs on boot (with lingering enabled)
|
|
|
|
See [INSTALL.md](INSTALL.md) for detailed documentation.
|
|
|
|
### Test
|
|
|
|
```bash
|
|
# Run the test script
|
|
./test-udev-autostart.sh
|
|
|
|
# Or manually check
|
|
systemctl --user status dcc-usb-connector.service
|
|
telnet localhost 2560
|
|
```
|
|
|
|
## Option 2: Container-based (Manual)
|
|
|
|
### Build and run the container
|
|
|
|
```bash
|
|
$ podman build -t dcc/bridge .
|
|
$ podman run -d --group-add keep-groups --device=/dev/ttyACM0:/dev/arduino -p 2560:2560 --name dcc-bridge dcc/bridge
|
|
```
|
|
|
|
### Test
|
|
|
|
It can be tested with `telnet`:
|
|
|
|
```bash
|
|
$ telnet localhost 2560
|
|
```
|