13 KiB
icE1usb-proto SoC Memory Map
Overview
| Base | Size | Description | IP Core doc |
|---|---|---|---|
0x00000000 |
0x00400 (1k) |
Boot ROM | |
0x00020000 |
0x10000 (64k) |
Main SRAM | |
0x80000000 |
Flash SPI | no2ice40/ice40_spi_wb |
|
0x81000000 |
Debug UART | no2misc/uart_wb |
|
0x82000000 |
RGB LED | no2ice40/ice40_rgb_wb |
|
0x83000000 |
USB core | no2usb |
|
0x84000000 |
0x01000 (4k) |
USB data buffer | |
0x85000000 |
0x10000 (64k) |
E1 data buffer | |
0x86000000 |
DMA | See below | |
0x87000000 |
E1 core | no2e1. See notes below. |
|
0x88000000 |
Misc | See below | |
0x89000000 |
GPS UART | no2misc/uart_wb |
|
0x8a000000 |
I2C | See below |
Memory
0x00000000: Boot ROM
This memory zone is initialized directly in the FPGA bitstream itself. It contains the bootstrap program that will load the main firmware from flash into the main SRAM and jump to it.
0x00020000: Main SRAM
The main SoC SRAM, implemented using the UP5k SPRAMs. It can't be initialized in the FPGA bitstream directly, hence the need for the Boot ROM zone.
0x84000000: USB data buffer
This 4k zone actually correspond to 8k of SRAM inside the USB core. The RX and TX buffer for the USB are distinct and are accessed independently depending if read or write access are made to this zone. (RX buffer can only be read, TX buffer can only be written). All accesses must also be 32 bit wide !
0x85000000: E1 data buffer
This 64k buffer is reserved for E1 data and is what is used by the E1 core.
Address mapping is :
,---------------------------------------------------------------,
| f | e | d | c | b | a | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
|---------------------------------------------------------------|
| multi-frame | frame | timeslot |
'---------------------------------------------------------------'
and the multi-frame number is what is exchanged in the E1 core buffer
descriptors.
Custom Peripherals
0x86000000: DMA
Very simple DMA core allowing direct copy of data between the USB and E1 data buffers.
Status (Read Only, addr 0x00)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / | b| d| /| len |
'-----------------------------------------------------------------------------------------------'
* [ 15] - b : Busy flag
* [ 14] - d : Direction ( 0=E1 to USB, 1=USB to E1 )
* [12: 0] - len : Remaining length of the in-progress transfer ( -1 = done )
Transfer start/direction/length (Write Only, addr 0x00)
Write to this register initiate the transfer.
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / | d| / | len |
'-----------------------------------------------------------------------------------------------'
* [ 14] - d : Direction ( 0=E1 to USB, 1=USB to E1 )
* [11: 0] - len : Transfer length ( Number of Words - 2 )
E1 buffer offset (Write Only, addr 0x08)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / | e1_ofs |
'-----------------------------------------------------------------------------------------------'
* [13:0] - e1_ofs
Word offset inside the E1 data buffer where the next transfer will start
USB buffer offset (Write Only, addr 0x0C)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / | usb_ofs |
'-----------------------------------------------------------------------------------------------'
* [9:0] - usb_ofs
Word offset inside the USB End Point buffer where the next transfer will start
0x87000000: E1 core
Refer to the no2e1 core documentation
for register description.
The core instanciated here has a 1 single channel containing both RX and TX units.
0x88000000: Misc
Collection of small auxiliary peripherals.
Boot (Write Only, addr 0x00)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / | x| sel |
'-----------------------------------------------------------------------------------------------'
* [ 2] - d : boot eXecute
* [11:0] - sel : boot select
Write to this register with bit 2 set will trigger a FPGA reload of the selected image.
GPIO (Read/Write, addr 0x01)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / | gpio_in | / | gpio_oe | / | gpio_out |
'-----------------------------------------------------------------------------------------------'
* [19:16] - gpio_in : Input
* [11: 8] - gpio_oe : Output Enable (0=Input, 1=Output)
* [ 3: 0] - gpio_out : Output
Note that gpio[3] is the gps_reset_n signal.
E1 connector LEDs (Read/Write, addr 0x02)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / |ac|rn| yl1 | gn1 | yl0 | gn0 |
'-----------------------------------------------------------------------------------------------'
* [0] - ac : Refresh cycle active
* [8] - rn : Run refresh cycle
* [7:6] - yl1 : Chan 1 yellow led
* [5:4] - gn1 : Chan 1 green led
* [3:2] - yl0 : Chan 0 yellow led
* [1:0] - gn0 : Chan 0 green led
This register controls the unit that constantly refreshed the LED and also polls the push button.
Note that because the pins are shared with flash SPI, this units need to be
disabled before any SPI access to flash ! To do so, set rn bit to 0, then
wait for ac to clear, do the SPI access, and finally set rn back to 1.
Each LED can have 4 mode :
00: Off01: On10: Slow blink11: Fast blink
E1 tick channel 0/1 (Read Only, addr 0x04-0x05)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| tx_tick | rx_tick |
'-----------------------------------------------------------------------------------------------'
* [31:16] - tx_tick
* [15: 0] - rx_tick
An internal counter is incremented at every bit received/transmitted by the corresponding E1 channel. That counter value is then captured at every USB Start-of-Frame packet and the last captured value made available here.
GPS PPS Time (Read Only, addr 0x06)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| pps_time |
'-----------------------------------------------------------------------------------------------'
* [31:0] - pps_time
Time register value (see below) captured at the previous PPS rising edge.
Time (Read Only, addr 0x07)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| time |
'-----------------------------------------------------------------------------------------------'
* [31:0] - time
32 bit counter incremented at the system clock rate ( 30.72 MHz )
PDM (Read/Write, addr 0x08-0x0f)
This exposes configurable voltages ( DACs ). Some channels are 12 bits, some are 8 bits.
12 bits:
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
|en| / | value |
'-----------------------------------------------------------------------------------------------'
* [31 ] - enable (output tristated if 0)
* [11:0] - value
8 bits:
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
|en| / | value |
'-----------------------------------------------------------------------------------------------'
* [31 ] - enable (output tristated if 0)
* [11:0] - value
Channels :
0: Clock tune ( low ) [ 12 bits ]1: Clock tune ( high ) [ 12 bits ]2: E1 RX Negative bias [ 8 bits ]3: E1 RX Positive bias [ 8 bits ]4: E1 RX Center Tap bias [ 8 bits ]
0x8a000000: I2C
Very simple I2C core.
Command (Write Only, addr 0x00)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
| / | cmd | / |ak| tx_data |
'-----------------------------------------------------------------------------------------------'
* [13:12] - cmd : Command, see list below
* [8] - ak : TX Ack. Bit to send as ACK for CMD_READ
* [7:0] - tx_data : TX Data. Byte to send for CMD_WRITE
Available commands :
00: CMD_START: Issue Start condition01: CMD_STOP: Issue Stop condition10: CMD_WRITE: Writes 1 byte and reads the ack bit11: CMD_READ: Reads 1 byte and write the ack bit
Status (Read Only, addr 0x00)
,-----------------------------------------------------------------------------------------------,
|31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|11|10| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
|-----------------------------------------------------------------------------------------------|
|ry| / / |ak| rx_data |
'-----------------------------------------------------------------------------------------------'
* [32] - ry : Ready bit. If not set, core is busy and rest of data is invalid
* [8] - ak : RX Ack. Bit received as ACK during previous CMD_WRITE
* [7:0] - rx_data : RX Data. Byte read during previous CMD_READ