docs: update README

README.md

@@ -5,11 +5,26 @@ WS281X Cube Controller based on MAX10 FPGA.
 
 ## Main Features
 
-* 4-Wire SPI Interface
-* High Refresh Rate (Up to 500fps@8x8x8)
-* 8 Data Lines in Parallel (64 LEDs per line)
-* Configurable Waveform Generator (T0H, T0L, T1H, T1L)
-* Configurable LED Serial Connection Sequence (Addr Linked List)
+* 4-wire SPI interface
+* High refresh rate (up to 500fps@8x8x8)
+* 8 parallel output data lines (64 LEDs per line)
+* Configurable waveform generator (T0H, T0L, T1H, T1L)
+* Configurable LED serial connection sequence (address linked list)
+
+## Pinout
+
+| Input Port | FPGA Pin | Output Port | FPGA Pin |
+| ---------: | :------- | :--------------: | :------: |
+| clk_i | PIN_J5 | ws281x_code_o[7] | PIN_R5 |
+| rst_n_i | PIN_R9 | ws281x_code_o[6] | PIN_L7 |
+| dc_i | PIN_P15 | ws281x_code_o[5] | PIN_P4 |
+| spi_sclk_i | PIN_R14 | ws281x_code_o[4] | PIN_L6 |
+| spi_mosi_i | PIN_P12 | ws281x_code_o[3] | PIN_R3 |
+| spi_cs_n_i | PIN_R11 | ws281x_code_o[2] | PIN_M5 |
+| - | | ws281x_code_o[1] | PIN_P3 |
+| - | | ws281x_code_o[0] | PIN_M4 |
+
+* SPI slave mode: MODE 0, CPOL=0, CPHA=0, MSB first
 
 ## Commands
 
@@ -23,10 +38,10 @@ WS281X Cube Controller based on MAX10 FPGA.
 | 3rd Param | 1 | D7 | D6 | D5 | D4 | D3 | D2 | D1 | D0 | |
 | 4th Param | 1 | D7 | D6 | D5 | D4 | D3 | D2 | D1 | D0 | |
 
-* 1st Param: T0H Time, range: 1-255, unit: 10 ns
-* 2nd Param: T0L Time, range: 1-255, unit: 10 ns
-* 3rd Param: T1H Time, range: 1-255, unit: 10 ns
-* 4th Param: T1L Time, range: 1-255, unit: 10 ns
+* 1st Param: T0H time, range: 1-255, unit: 10 ns
+* 2nd Param: T0L time, range: 1-255, unit: 10 ns
+* 3rd Param: T1H time, range: 1-255, unit: 10 ns
+* 4th Param: T1L time, range: 1-255, unit: 10 ns
 
 Limits:
 
@@ -42,7 +57,15 @@ Limits:
 | ... | 1 | D7 | D6 | D5 | D4 | D3 | D2 | D1 | D0 | |
 | Nth Param | 1 | D7 | D6 | D5 | D4 | D3 | D2 | D1 | D0 | |
 
-* N = 64, LED Addr Linked List (Same for 8 layers)
+* 1st Param: 2nd LED address, range: 0-63
+* 2nd Param: 3rd LED address, range: 0-63
+* 3rd Param: 4th LED address, range: 0-63
+* ...
+* Nth Param: 1st LED address, range: 0-63
+
+* N = 64
+
+* These configurations will be applied to all 8 layers
 
 ### DATA_WR
 
@@ -53,7 +76,19 @@ Limits:
 | ... | 1 | D7 | D6 | D5 | D4 | D3 | D2 | D1 | D0 | |
 | Nth Param | 1 | D7 | D6 | D5 | D4 | D3 | D2 | D1 | D0 | |
 
-* N = 8 x 8 x 8 x 3 = 1536, LED Color Data (24-bit)
+* 1st Param: 1st LED color byte 2, range: 0-255
+* 2nd Param: 1st LED color byte 1, range: 0-255
+* 3rd Param: 1st LED color byte 0, range: 0-255
+* 4th Param: 2nd LED color byte 2, range: 0-255
+* 5th Param: 2nd LED color byte 1, range: 0-255
+* 6th Param: 2nd LED color byte 0, range: 0-255
+* ...
+* Nth Param: ...
+
+* N = 8 x 8 x 8 x 3 = 1536
+
+* Layer data order: layer 7 first (layer 7 - layer 0)
+* Color byte order: high byte first (byte 2 - byte 0)
 
 ## Preparing