Changed to talk about the ethernet functionality generically

akuker 2020-12-27 20:51:20 -06:00
parent 5d27f18a6b
commit e7cd00ef8e
1 changed files with 18 additions and 12 deletions

@ -1,4 +1,4 @@
# NuvoLink Network Card emulation
# SCSI Network Card emulation
The aim is to provide network capabilities through SCSI interface emulated by RaSCSI.
This documentation is for developer who would like to contribute to this project.
@ -10,13 +10,13 @@ Packets go through `ras0` tun/tap and are read by RaSCSI service, and are sent t
## How does it work?
Packets can come from `wlan0` or from localhost, they are sent to a tun/tap virtual interface named `ras0`.
The RaSCSI software connects to `ras0` and reads the packets, then write those packets to the SCSI interface.
On the Mac, the NuvoLink SC Driver, reads the packets from the SCSI physical port of the Mac and provide them to the System.
Same operation happen in the other direction when packets are sent from the Mac to the SCSI (thanks the NuvoLink SC Driver).
On the Mac, the device driver, reads the packets from the SCSI physical port of the Mac and provide them to the System.
Same operation happen in the other direction when packets are sent from the Mac to the SCSI (thanks the driver).
RaSCSI reads the packets from the SCSI emulation and write then to the virtual network interface `ras0`, packets can then travel to the internet through `wlan0`.
```
[ wlan0 ] <---> [ ras0 ] <---> [ RaSCSI + NuvoLink Emulation ] <---> SCSI <--> [ NuvoLink SC Driver ] <-> [ Mac System ]
[ wlan0 ] <---> [ ras0 ] <---> [ RaSCSI + SCSI NIC Emulation ] <---> SCSI <--> [ Mac OS Device Driver ] <-> [ Mac System ]
[ internet ] [ tun virtual ] [ read packets from ras0 and ]
[ interface ] [ write them to the SCSI. ]
[ read the packets from SCSI ]
@ -48,11 +48,11 @@ sudo echo 1 >/proc/sys/net/ipv4/ip_forward
sudo iptables -t nat -A POSTROUTING -o wlan0 -j MASQUERADE
```
# Setting up RaSCSI with NuvoLink support
# Setting up RaSCSI with SCSI Ethernet support
## Checkout the code
You will need to clone the repository, and the switch to the nuvolink branch.
You will need to clone the repository, and the switch to the daynaport or nuvolink branch.
```
git checkout nuvolink
git checkout daynaport
git pull
```
@ -74,14 +74,20 @@ sudo systemctl start rascsi
sudo systemctl status rascsi
```
### attach the NuvoLink virtual card to RASCSI
### attach the NuvoLink or DaynaPort virtual card to RASCSI
```
rasctl -c attach -i 4 -t bridge
rasctl -c attach -i 4 -t nuvolink
# or
rasctl -c attach -i 4 -t daynaport
```
# Install NuvoLink Driver
On the Macintosh you will need to install the NuvoLink driver:
[https://macintoshgarden.org/apps/nuvolink](https://macintoshgarden.org/apps/nuvolink)
# Install NuvoLink or DaynaPort Driver
On the Macintosh you will need to install either the NuvoLink or Daynaport driver:
- [NuvoLink Drivers](https://macintoshgarden.org/apps/nuvolink)
- [DaynaPort Drivers](https://macintoshgarden.org/apps/daynaport-drivers)
- [DaynaPort ISO Disk Image (works with RaSCSI)](http://www.bitsavers.org/pdf/apple/scsi/dayna/daynaPORT/)
- [Both are available here](https://vintageapple.org/macdrivers/network.shtml)
# Debugging