git.sesse.net Git - pistorm/blob - a314/software-amiga/ethernet_pistorm/README.md

   1 # a314eth.device - SANA-II driver for A314
   2
   3 **NOTE: This readme is the default A314 Ethernet driver readme, and some of these things don't apply to the PiStorm A314 emulation adapted binary.**
   4 This SANA-II driver works by copying Ethernet frames back and forth between the Amiga and a virtual ethernet interface (tap0) on the Raspberry Pi. The Pi will, when configured properly, do network address translation (NAT) and route packets from the Amiga to the Internet.
   5
   6 ## Configuring the Raspberry Pi
   7
   8 - Install pytun: `sudo pip3 install python-pytun`.
   9 - Copy `ethernet.py` to `/opt/a314/ethernet.py`.
  10 - Update `/etc/opt/a314/a314d.conf` with a line that starts `ethernet.py` on demand.
  11   - In order for `a314d` to pick up the changes in `a314d.conf` you'll have to restart `a314d`, either by `sudo systemctl restart a314d` or by rebooting the Pi.
  12 - Copy `pi-config/tap0` to `/etc/network/interfaces.d/tap0`. This file creates a tap device with ip address 192.168.2.1 when the Raspberry Pi is booted up.
  13 - Add the lines in `pi-config/rc.local` to the bottom of `/etc/rc.local` just before `exit 0`. This create iptables rules that forwards packets from the `tap0` interface to the `wlan0` interface.
  14   - Please note that if the Pi is connected using wired ethernet then `wlan0` should be changed to `eth0`.
  15
  16 The first four steps are performed by `sudo make install`. The last step you have to do manually.
  17
  18 ## Configuring the Amiga
  19
  20 This has only been tested with the Roadshow TCP/IP stack, and these instructions are written for Roadshow. The instructions won't describe how to install Roadshow.
  21
  22 - Build the `a314eth.device` binary, for example using the `rpi_docker_build.sh` script.
  23 - Copy `bin/a314eth.device` to `DEVS:`.
  24 - Copy `amiga-config/A314Eth` to `DEVS:NetInterfaces/A314Eth`.
  25 - Copy `amiga-config/routes` to `DEVS:Internet/routes`.
  26 - Copy `amiga-config/name_resolution` to `DEVS:Internet/name_resolution`.
  27   - You should change the nameserver to a DNS server that works on your network.
  28   - Note that there may be settings in the above two files (`routes` and `name_resolution`) that you wish to keep, so look through the changes you are about to make first.
  29
  30 Reboot the Amiga and with some luck you should be able to access the Internet from your Amiga.
  31
  32 ## Important note:
  33
  34 After `ethernet.py` starts it waits for 15 seconds before it starts forwarding Ethernet frames. Without this waiting there is something that doesn't work properly (I don't know why this is). So when the Amiga boots for the first time after power off you'll have to wait up to 15 seconds before the Amiga can reach the Internet.