User Tools

Site Tools


base:rr-net_memory_map_docs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

base:rr-net_memory_map_docs [2015-04-17 04:33] (current)
Line 1: Line 1:
 +====== RR-net memory map & docs ======
 +<​code>​
 +This document is freely distributable as long as it is not changed, and one
 +of the sources www.jschoenfeld.com,​ www.jschoenfeld.de,​ www.siliconsonic.com
 +or www.ami.ga is mentioned. ​
  
 +last update:
 +august 31st, 2003: initial release
 +
 +General
 +-------
 +RR-Net is a 10MBit networking card that is designed for the commodore C64,
 +for use on the Retro Replay freezer cartridge. It'll also work on the Amiga
 +with a clock-port, but it is not recommended:​ The card does not support IRQs,
 +and it hardly fits mechanically. If you need network for your Amiga, use the
 +X-Surf 2 board.
 +
 +Memory map
 +----------
 +The memory map depends on the place where RR-Net is connected. Although
 +RR-Net is designed for the C64, here are also the offset addresses for the
 +Amiga. Check the corresponding hardware documentations for the carrier cards
 +to obtain the base addresses of the clockport.
 +
 +RR-Net is based on the Cirrus logic CS8900a (Crystal LAN). The chip is used
 +in 8-bit mode, so the 8 registers of an NE2000 are spread over 16 registers
 +in an 8-bit system. The 8-bit mode of the chip does not support IRQs (see
 +Cirrus logic application note AN181).
 +
 +Do not forget to switch on the accessory connector of the Retro Replay by
 +setting bit 0 in $de01. See Inside_Replay.txt for more information.
 +
 +C64 register ​   Amiga register ​ read/​write ​     meaning
 +none            $00/​$04 ​        ​read-only ​      ​interrupt status queue
 +$de02/​$de03 ​    ​$08/​$0c ​        ​read/​write ​     PackatPage pointer
 +$de04/​$de05 ​    ​$10/​$14 ​        ​read/​write ​     PacketPage Data (Port 0)
 +$de06/​$de07 ​    ​$18/​$1c ​        ​read/​write ​     PacketPage Data (Port 1)
 +$de08/​$de09 ​    ​$20/​$24 ​        ​read/​write ​     Receive/​Transmit Data (Port 0)
 +$de0a/​$de0b ​    ​$28/​$2c ​        ​read/​write ​     Receive/​Transmit Data (Port 1)
 +$de0c/​$de0d ​    ​$30/​$34 ​        ​write-only ​     TxCMD (Transmit Command)
 +$de0e/​$de0f ​    ​$38/​$3c ​        ​write-only ​     TxLength (Transmit Length)
 +
 +Although the Amiga makes the interrupt status queue registers available, it
 +does not have any effect. Even if you try to activate the chip's IRQ features,
 +it will not have any effect. The IRQ line of the chip is not wired on RR-Net
 +at all!
 +If you compare this register map to the register map in AN181, you might
 +notice that the first and the second half of the register set is swapped.
 +This has been done, because the accessory connector of the Retro Replay does
 +not provide the full range of registers available on the Amiga clockport. The
 +first two bytes are control registers of the freezer cartridge, and this
 +swapping moves the unnecessary register-pair (IRQ status queue) into the
 +"​invisible"​ area of the cartridge.
 +
 +Endianess
 +---------
 +Although the chip is used in 8-bit mode, you have to know the endianess,
 +because each register pair forms a one 16-bit register. Ethernet is
 +big-endian by default. The chip was designed as an ISA thing, so all
 +registers appear as little endian. In other words: The lowbyte comes first,
 +then the highbyte.
 +
 +MAC address
 +-----------
 +RR-Net does not have an EEprom to store the MAC address, so it should be
 +stored somewhere else: The flash rom of Retro Replay, the disk of the
 +Contiki operating system by Adam Dunkels (http://​dunkels.com/​adam/​contiki/​),​
 +or Kickflash OS4 for the Amiga. The Mac address is only needed when
 +transmitting packets, so it's OK if it's loaded from mass storage media when
 +loading/​starting the driver. The Mac address is NOT needed when RR-Net is
 +just connected to other networking equipment. The LINK led might already be
 +on, but the MAC address is only needed when something is transmitted into the
 +network.
 +         
 +More literature
 +---------------
 +Cirrus Logic Application note AN181: "Using the Crystal CS8900A in 8-bit
 +mode" by James Ayres: http://​www.cirrus.com/​en/​pubs/​appNote/​an181.pdf
 +
 +Crystal LAN CS8900A Ethernet Controller Technical Reference manual AN83:
 +http://​www.cirrus.com/​en/​pubs/​appNote/​An83-3.pdf
 +
 +The product data sheet for the CS8900A also contains software information,​
 +starting at chapter 4 (page 38):
 +http://​www.cirrus.com/​en/​pubs/​proDatasheet/​cs8900a-4.pdf
 +
 +Application note 194: "How to program the Hash filter in the CS8900A":​
 +http://​www.cirrus.com/​en/​pubs/​appNote/​an194-1.pdf
 +
 +The FAQ about the chip: http://​www.cirrus.com/​en/​pubs/​appNote/​an205-2.pdf
 +
 +Fine print
 +----------
 +RR-Net is not designed, authorized or warranted to be suitable for use in
 +life-support devices or systems or other critical operations. Inclusion of
 +the product in such applications is understood to be fully at the
 +customer'​s risk.
 +
 +** EOF
 +</​code>​
base/rr-net_memory_map_docs.txt ยท Last modified: 2015-04-17 04:33 (external edit)