Difference between revisions of "SPI Registers"

From 3dbrew
Jump to navigation Jump to search
 
(15 intermediate revisions by 5 users not shown)
Line 8: Line 8:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_CNT|SPI_CNT]]0
+
| [[#SPI_CNT|SPI_CNT]]1
 
| 0x10142000
 
| 0x10142000
 
| 2
 
| 2
Line 14: Line 14:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| SPI_DATA0
+
| SPI_DATA1
 
| 0x10142002
 
| 0x10142002
 
| 1  
 
| 1  
Line 20: Line 20:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_CNT|SPI_NEW_CNT]]0
+
| [[#NSPI_CNT|NSPI_CNT]]1
 
| 0x10142800
 
| 0x10142800
 
| 4
 
| 4
Line 26: Line 26:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_DONE|SPI_NEW_DONE]]0
+
| [[#NSPI_DONE|NSPI_DONE]]1
 
| 0x10142804
 
| 0x10142804
 
| 4
 
| 4
Line 32: Line 32:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_BLKLEN|SPI_NEW_BLKLEN]]0
+
| [[#NSPI_BLKLEN|NSPI_BLKLEN]]1
 
| 0x10142808
 
| 0x10142808
 
| 4
 
| 4
Line 38: Line 38:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_FIFO|SPI_NEW_FIFO]]0
+
| [[#NSPI_FIFO|NSPI_FIFO]]1
 
| 0x1014280C
 
| 0x1014280C
 
| 4
 
| 4
Line 44: Line 44:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_STATUS|SPI_NEW_STATUS]]0
+
| [[#NSPI_STATUS|NSPI_STATUS]]1
 
| 0x10142810
 
| 0x10142810
 
| 4
 
| 4
 
|
 
|
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_AUTOPOLL|NSPI_AUTOPOLL]]1
 +
| 0x10142814
 +
| 4
 +
| -
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_INT_MASK|NSPI_INT_MASK]]1
 +
| 0x10142818
 +
| 4
 +
| -
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_INT_STAT|NSPI_INT_STAT]]1
 +
| 0x1014281C
 +
| 4
 +
| -
 +
|-
 
|-style="border-top: double"
 
|-style="border-top: double"
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_CNT|SPI_CNT]]1
+
| [[#SPI_CNT|SPI_CNT]]2
 
| 0x10143000
 
| 0x10143000
 
| 2
 
| 2
Line 56: Line 75:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| SPI_DATA1
+
| SPI_DATA2
 
| 0x10143002
 
| 0x10143002
 
| 1  
 
| 1  
Line 62: Line 81:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_CNT|SPI_NEW_CNT]]1
+
| [[#NSPI_CNT|NSPI_CNT]]2
 
| 0x10143800
 
| 0x10143800
 
| 4
 
| 4
Line 68: Line 87:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_DONE|SPI_NEW_DONE]]1
+
| [[#NSPI_DONE|NSPI_DONE]]2
 
| 0x10143804
 
| 0x10143804
 
| 4
 
| 4
Line 74: Line 93:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_BLKLEN|SPI_NEW_BLKLEN]]1
+
| [[#NSPI_BLKLEN|NSPI_BLKLEN]]2
 
| 0x10143808
 
| 0x10143808
 
| 4
 
| 4
Line 80: Line 99:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_FIFO|SPI_NEW_FIFO]]1
+
| [[#NSPI_FIFO|NSPI_FIFO]]2
 
| 0x1014380C
 
| 0x1014380C
 
| 4
 
| 4
Line 86: Line 105:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_STATUS|SPI_NEW_STATUS]]1
+
| [[#NSPI_STATUS|NSPI_STATUS]]2
 
| 0x10143810
 
| 0x10143810
 
| 4
 
| 4
 
|
 
|
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_AUTOPOLL|NSPI_AUTOPOLL]]2
 +
| 0x10143814
 +
| 4
 +
| -
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_INT_MASK|NSPI_INT_MASK]]2
 +
| 0x10143818
 +
| 4
 +
| -
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_INT_STAT|NSPI_INT_STAT]]2
 +
| 0x1014381C
 +
| 4
 +
| -
 
|-style="border-top: double"
 
|-style="border-top: double"
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_CNT|SPI_CNT]]2
+
| [[#SPI_CNT|SPI_CNT]]3
 
| 0x10160000
 
| 0x10160000
 
| 2
 
| 2
Line 98: Line 135:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| SPI_DATA2
+
| SPI_DATA3
 
| 0x10160002
 
| 0x10160002
 
| 1  
 
| 1  
Line 104: Line 141:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_CNT|SPI_NEW_CNT]]2
+
| [[#NSPI_CNT|NSPI_CNT]]3
 
| 0x10160800
 
| 0x10160800
 
| 4
 
| 4
Line 110: Line 147:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_DONE|SPI_NEW_DONE]]2
+
| [[#NSPI_DONE|NSPI_DONE]]3
 
| 0x10160804
 
| 0x10160804
 
| 4
 
| 4
Line 116: Line 153:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_BLKLEN|SPI_NEW_BLKLEN]]2
+
| [[#NSPI_BLKLEN|NSPI_BLKLEN]]3
 
| 0x10160808
 
| 0x10160808
 
| 4
 
| 4
Line 122: Line 159:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_FIFO|SPI_NEW_FIFO]]2
+
| [[#NSPI_FIFO|NSPI_FIFO]]3
 
| 0x1016080C
 
| 0x1016080C
 
| 4
 
| 4
Line 128: Line 165:
 
|-
 
|-
 
| style="background: green" | Yes
 
| style="background: green" | Yes
| [[#SPI_NEW_STATUS|SPI_NEW_STATUS]]2
+
| [[#NSPI_STATUS|NSPI_STATUS]]3
 
| 0x10160810
 
| 0x10160810
 
| 4
 
| 4
 
|
 
|
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_AUTOPOLL|NSPI_AUTOPOLL]]3
 +
| 0x10160814
 +
| 4
 +
| -
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_INT_MASK|NSPI_INT_MASK]]3
 +
| 0x10160818
 +
| 4
 +
| -
 +
|-
 +
| style="background: green" | Yes
 +
| [[#NSPI_INT_STAT|NSPI_INT_STAT]]3
 +
| 0x1016081C
 +
| 4
 +
| -
 
|}
 
|}
 +
 +
There are two register interfaces: the old NDS/DSi one and an alternative faster interface introduced with the 3DS.
 +
 +
To toggle between those interfaces, use the [[CONFIG11_Registers#CFG11_SPI_CNT|CFG11_SPI_CNT]] register.
  
 
== SPI_CNT ==
 
== SPI_CNT ==
Line 138: Line 197:
  
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Old3DS
+
Bits
 
!  Name
 
!  Name
 
|-
 
|-
 
| 0-1
 
| 0-1
| Baudrate (0=4MHz/Firmware, 1=2MHz/Touchscr, 2=1MHz/Powerman., 3=512KHz)
+
| Baudrate (0=4MHz, 1=2MHz, 2=1MHz, 3=512KHz)
 
|-
 
|-
 
| 2-6
 
| 2-6
| Not used            (Zero)
+
| This was added with 3DS.
 
|-
 
|-
 
| 7
 
| 7
Line 151: Line 210:
 
|-  
 
|-  
 
| 8-9
 
| 8-9
| Device Select      (0-3)
+
| Device Select      (0=Powerman., 1=Firmware, 2=Touchscreen)
 
|-
 
|-
 
| 10
 
| 10
Line 169: Line 228:
 
|}
 
|}
  
== SPI_NEW_CNT ==
+
== NSPI_CNT ==
 
This is an alternative faster interface introduced with the 3DS.
 
This is an alternative faster interface introduced with the 3DS.
  
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Old3DS
+
Bits
 
!  Name
 
!  Name
 
|-
 
|-
| 0-5
+
| 0-2
| Baudrate?
+
| Clock
 
|-
 
|-
 
| 6-7
 
| 6-7
| Device Select
+
| Device select
 +
|-
 +
| 12
 +
| Bus mode (0 = 1 bit, 1 = 4 bit)
 
|-
 
|-
 
| 13
 
| 13
| Transfer Direction? (0=Incoming, 1=Outgoing)
+
| Transfer direction (0 = read, 1 = write)
 
|-
 
|-
 
| 15
 
| 15
| Busy/enable
+
| 1 = Busy/enable
 
|}
 
|}
  
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
!  Device id
 
!  Device id
!  Device select bits
+
!  Bus
 +
!  Device select
 +
!  Clock
 +
|-
 +
| 0
 +
| 3
 +
| 0
 +
| 2
 +
|-
 +
| 1, 2
 +
| 3
 +
| 1, 2
 +
| ?, ?
 
|-
 
|-
| 0, 3, >=6
+
| 3
 +
| 1
 
| 0
 
| 0
 +
| 5
 
|-
 
|-
| 1, 4
+
| 4, 5
 
| 1
 
| 1
 +
| 1, 2
 +
| ?, ?
 
|-
 
|-
| 2, 5
+
| 6
 
| 2
 
| 2
 +
| 0
 +
| ?
 
|}
 
|}
  
 +
== NSPI_DONE ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
Device id
+
BIT
Used baudrate
+
DESCRIPTION
 +
|-
 +
| 0
 +
| Chip select
 +
|-
 +
| 1-31
 +
| Unused
 +
|}
 +
 
 +
Contains 1 when the SPI slave is selected. A 0 is written here on transfer end to deselect the slave.
 +
 
 +
== NSPI_BLKLEN ==
 +
{| class="wikitable" border="1"
 +
!  BIT
 +
!  DESCRIPTION
 +
|-
 +
| 0-20
 +
| Transfer size
 +
|-
 +
| 21-31
 +
| Unused
 +
|}
 +
 
 +
The number of bytes to be sent/read is written to this register.
 +
 
 +
== NSPI_FIFO ==
 +
{| class="wikitable" border="1"
 +
!  BIT
 +
!  DESCRIPTION
 
|-
 
|-
| 3
+
| 0-31
| 5
+
| Data
 +
|}
 +
 
 +
32-bit FIFO for reading/writing the SPI payload. This FIFO is one way (half-duplex).
 +
 
 +
== NSPI_STATUS ==
 +
{| class="wikitable" border="1"
 +
!  BIT
 +
!  DESCRIPTION
 
|-
 
|-
 
| 0
 
| 0
| 2
+
| FIFO full (0 = not full, 1 = full)
 +
|-
 +
| 1-31
 +
| Unused
 +
|}
 +
 
 +
At transfer start and every 32 bytes the FIFO becomes busy.
 +
 
 +
== NSPI_AUTOPOLL ==
 +
{| class="wikitable" border="1"
 +
!  BIT
 +
!  DESCRIPTION
 +
|-
 +
| 0-7
 +
| Command
 +
|-
 +
| 16-19
 +
| Timeout (Tries = 31<<Clock (from [[#NSPI_CNT|NSPI_CNT]]) + Timeout)
 +
|-
 +
| 24-26
 +
| Bit offset (0-7)
 +
|-
 +
| 30
 +
| Poll for a set or unset bit
 +
|-
 +
| 31
 +
| 1 = Enable/Busy
 
|}
 
|}
  
== SPI_NEW_DONE ==
+
This automatically sends a command to the device and compares the specified bit in the response with bit 30 until it matches or a timeout occurs.
When the transfer is finished, a 0 has to be written to this register.
 
  
==SPI_NEW_BLKLEN==
+
== NSPI_INT_MASK ==
The number of bytes to be sent/read is written to this register.
+
{| class="wikitable" border="1"
 +
!  BIT
 +
!  DESCRIPTION
 +
|-
 +
| 0
 +
| Transfer finished (1 = disabled)
 +
|-
 +
| 1
 +
| Autopoll success (1 = disabled)
 +
|-
 +
| 2
 +
| Autopoll timeout (1 = disabled)
 +
|}
  
==SPI_NEW_FIFO==
+
== NSPI_INT_STAT ==
32-bit FIFO for reading/writing the SPI payload.
+
{| class="wikitable" border="1"
 +
!  BIT
 +
!  DESCRIPTION
 +
|-
 +
| 0
 +
| Transfer finished (also fires on each autopoll try?)
 +
|-
 +
| 1
 +
| Autopoll success
 +
|-
 +
| 2
 +
| Autopoll timeout
 +
|}
  
==SPI_NEW_STATUS==
+
[[ARM11_Interrupts#Hardware_Interrupts|Interrupt]] ID 0x24, 0x56 or 0x57 (depending on the bus) is fired when any of the bits change to 1 except for interrupts masked in [[#NSPI_INT_MASK|NSPI_INT_MASK]]. Writing 1 to a bit in this register aknowledges the interrupt.
Bit0: FIFO busy.
 

Latest revision as of 00:09, 15 February 2021

Registers[edit]

Old3DS Name Address Width Used by
Yes SPI_CNT1 0x10142000 2
Yes SPI_DATA1 0x10142002 1
Yes NSPI_CNT1 0x10142800 4
Yes NSPI_DONE1 0x10142804 4
Yes NSPI_BLKLEN1 0x10142808 4
Yes NSPI_FIFO1 0x1014280C 4
Yes NSPI_STATUS1 0x10142810 4
Yes NSPI_AUTOPOLL1 0x10142814 4 -
Yes NSPI_INT_MASK1 0x10142818 4 -
Yes NSPI_INT_STAT1 0x1014281C 4 -
Yes SPI_CNT2 0x10143000 2
Yes SPI_DATA2 0x10143002 1
Yes NSPI_CNT2 0x10143800 4
Yes NSPI_DONE2 0x10143804 4
Yes NSPI_BLKLEN2 0x10143808 4
Yes NSPI_FIFO2 0x1014380C 4
Yes NSPI_STATUS2 0x10143810 4
Yes NSPI_AUTOPOLL2 0x10143814 4 -
Yes NSPI_INT_MASK2 0x10143818 4 -
Yes NSPI_INT_STAT2 0x1014381C 4 -
Yes SPI_CNT3 0x10160000 2
Yes SPI_DATA3 0x10160002 1
Yes NSPI_CNT3 0x10160800 4
Yes NSPI_DONE3 0x10160804 4
Yes NSPI_BLKLEN3 0x10160808 4
Yes NSPI_FIFO3 0x1016080C 4
Yes NSPI_STATUS3 0x10160810 4
Yes NSPI_AUTOPOLL3 0x10160814 4 -
Yes NSPI_INT_MASK3 0x10160818 4 -
Yes NSPI_INT_STAT3 0x1016081C 4 -

There are two register interfaces: the old NDS/DSi one and an alternative faster interface introduced with the 3DS.

To toggle between those interfaces, use the CFG11_SPI_CNT register.

SPI_CNT[edit]

This is the old NDS/DSi SPI interface.

Bits Name
0-1 Baudrate (0=4MHz, 1=2MHz, 2=1MHz, 3=512KHz)
2-6 This was added with 3DS.
7 Busy Flag (0=Ready, 1=Busy) (presumably Read-only)
8-9 Device Select (0=Powerman., 1=Firmware, 2=Touchscreen)
10 Transfer Size (0=8bit/Normal, 1=16bit/Bugged)
11 Chipselect Hold (0=Deselect after transfer, 1=Keep selected)
12-13 Not used (Zero)
14 Interrupt Request (0=Disable, 1=Enable)
15 SPI Bus Enable (0=Disable, 1=Enable)

NSPI_CNT[edit]

This is an alternative faster interface introduced with the 3DS.

Bits Name
0-2 Clock
6-7 Device select
12 Bus mode (0 = 1 bit, 1 = 4 bit)
13 Transfer direction (0 = read, 1 = write)
15 1 = Busy/enable
Device id Bus Device select Clock
0 3 0 2
1, 2 3 1, 2 ?, ?
3 1 0 5
4, 5 1 1, 2 ?, ?
6 2 0 ?

NSPI_DONE[edit]

BIT DESCRIPTION
0 Chip select
1-31 Unused

Contains 1 when the SPI slave is selected. A 0 is written here on transfer end to deselect the slave.

NSPI_BLKLEN[edit]

BIT DESCRIPTION
0-20 Transfer size
21-31 Unused

The number of bytes to be sent/read is written to this register.

NSPI_FIFO[edit]

BIT DESCRIPTION
0-31 Data

32-bit FIFO for reading/writing the SPI payload. This FIFO is one way (half-duplex).

NSPI_STATUS[edit]

BIT DESCRIPTION
0 FIFO full (0 = not full, 1 = full)
1-31 Unused

At transfer start and every 32 bytes the FIFO becomes busy.

NSPI_AUTOPOLL[edit]

BIT DESCRIPTION
0-7 Command
16-19 Timeout (Tries = 31<<Clock (from NSPI_CNT) + Timeout)
24-26 Bit offset (0-7)
30 Poll for a set or unset bit
31 1 = Enable/Busy

This automatically sends a command to the device and compares the specified bit in the response with bit 30 until it matches or a timeout occurs.

NSPI_INT_MASK[edit]

BIT DESCRIPTION
0 Transfer finished (1 = disabled)
1 Autopoll success (1 = disabled)
2 Autopoll timeout (1 = disabled)

NSPI_INT_STAT[edit]

BIT DESCRIPTION
0 Transfer finished (also fires on each autopoll try?)
1 Autopoll success
2 Autopoll timeout

Interrupt ID 0x24, 0x56 or 0x57 (depending on the bus) is fired when any of the bits change to 1 except for interrupts masked in NSPI_INT_MASK. Writing 1 to a bit in this register aknowledges the interrupt.