From ca77db1734bc65e2eca0e57bc9c1f4cb67cb4732 Mon Sep 17 00:00:00 2001
From: Zack Buhman <zack@buhman.org>
Date: Sat, 9 Dec 2023 16:58:36 +0800
Subject: [PATCH] maple: add maple_host_bits

---
 main.cpp                           |   1 -
 maple/maple.cpp                    |  50 +++++++++--------------------
 maple/maple_host_bits.h            |  48 +++++++++++++++++++++++++++
 regs/{maple.csv => maple_bits.csv} |   0
 regs/{maple.ods => maple_bits.ods} | Bin
 regs/maple_host_bits.csv           |  30 +++++++++++++++++
 regs/maple_host_bits.ods           | Bin 0 -> 14126 bytes
 7 files changed, 94 insertions(+), 35 deletions(-)
 create mode 100644 maple/maple_host_bits.h
 rename regs/{maple.csv => maple_bits.csv} (100%)
 rename regs/{maple.ods => maple_bits.ods} (100%)
 create mode 100644 regs/maple_host_bits.csv
 create mode 100644 regs/maple_host_bits.ods

diff --git a/main.cpp b/main.cpp
index d3dd88e..7071c90 100644
--- a/main.cpp
+++ b/main.cpp
@@ -84,7 +84,6 @@ void maple_test()
   uint32_t * command_buf = align_32byte(_command_buf);
   uint32_t * receive_address = align_32byte(_receive_address);
 
-  serial_int(mdstar::table_address(reinterpret_cast<uint32_t>(command_buf)));
   maple_init_host_command(command_buf, receive_address);
   maple_dma_start(command_buf);
 
diff --git a/maple/maple.cpp b/maple/maple.cpp
index 77fb592..022d732 100644
--- a/maple/maple.cpp
+++ b/maple/maple.cpp
@@ -7,55 +7,37 @@
 #include "../systembus_bits.h"
 
 #include "maple_bits.h"
+#include "maple_host_bits.h"
 #include "maple_bus_commands.h"
 #include "maple.h"
 
-#define AP__PO__A (0b00 << 6)
-#define AP__PO__B (0b01 << 6)
-#define AP__PO__C (0b10 << 6)
-#define AP__PO__D (0b11 << 6)
-
-#define AP__DE__DEVICE (1 << 5)
-#define AP__DE__EXPANSION_DEVICE (0 << 5)
-#define AP__DE__PORT (0 << 5)
-
-#define AP__LM(reg) ((reg) & 0b11111)
-
-// 2.6.8 "Peripheral Data Transfers"
-// 5 "User Interface"; page 269
-
-#define HOST_INSTRUCTION__END_FLAG (1 << 31)
-#define HOST_INSTRUCTION__PORT_SELECT__A (0b00 << 16)
-#define HOST_INSTRUCTION__PORT_SELECT__B (0b01 << 16)
-#define HOST_INSTRUCTION__PORT_SELECT__C (0b10 << 16)
-#define HOST_INSTRUCTION__PORT_SELECT__D (0b11 << 16)
-#define HOST_INSTRUCTION__TRANSFER_LENGTH(n) (((n) & 0xff) << 0)
-
 template <typename T>
 struct maple_host_command {
   uint32_t host_instruction;
   uint32_t receive_data_storage_address;
-  uint8_t command_code;
-  uint8_t destination_ap;
-  uint8_t source_ap;
-  uint8_t data_size;
-  T data_fields;
+  struct bus_data {
+    uint8_t command_code;
+    uint8_t destination_ap;
+    uint8_t source_ap;
+    uint8_t data_size;
+    T data_fields;
+  } bus_data;
 };
 
 void maple_init_host_command(uint32_t * buf, uint32_t * receive_address)
 {
   auto host_command = reinterpret_cast<maple_host_command<device_request::data_fields> *>(buf);
 
-  host_command->host_instruction = HOST_INSTRUCTION__END_FLAG
-                                 | HOST_INSTRUCTION__PORT_SELECT__A
-                                 | HOST_INSTRUCTION__TRANSFER_LENGTH(0); // 4 bytes
+  host_command->host_instruction = host_instruction::end_flag
+                                 | host_instruction::port_select::a
+                                 | host_instruction::transfer_length(0); // 4 bytes
 
   host_command->receive_data_storage_address = reinterpret_cast<uint32_t>(receive_address);
 
-  host_command->command_code = device_request::command_code;
-  host_command->destination_ap = AP__DE__DEVICE | AP__PO__A;
-  host_command->source_ap = AP__PO__A;
-  host_command->data_size = 0;
+  host_command->bus_data.command_code = device_request::command_code;
+  host_command->bus_data.destination_ap = ap::de::device | ap::port_select::a;
+  host_command->bus_data.source_ap = ap::port_select::a;
+  host_command->bus_data.data_size = 0;
 }
 
 void maple_dma_start(uint32_t * command_buf)
@@ -76,7 +58,7 @@ void maple_dma_start(uint32_t * command_buf)
   // 20nsec * 0xc350 = 1ms
   constexpr uint32_t one_msec = 0xc350;
   maple_if.MSYS = msys::time_out_counter(one_msec)
-              | msys::sending_rate::_2M;
+                | msys::sending_rate::_2M;
 
   maple_if.MDTSEL = mdtsel::trigger_select::software_initiation;
 
diff --git a/maple/maple_host_bits.h b/maple/maple_host_bits.h
new file mode 100644
index 0000000..1949632
--- /dev/null
+++ b/maple/maple_host_bits.h
@@ -0,0 +1,48 @@
+#include <cstdint>
+
+#include "../float_uint32.h"
+
+namespace host_instruction {
+  constexpr uint32_t end_flag = 1 << 31;
+  
+  namespace port_select {
+    constexpr uint32_t a = 0 << 16;
+    constexpr uint32_t b = 1 << 16;
+    constexpr uint32_t c = 2 << 16;
+    constexpr uint32_t d = 3 << 16;
+  }
+  
+  namespace pattern {
+    constexpr uint32_t normal = 0b000 << 8;
+    constexpr uint32_t light_gun_mode = 0b010 << 8;
+    constexpr uint32_t reset = 0b011 << 8;
+    constexpr uint32_t return_from_light_gun_mode = 0b100 << 8;
+    constexpr uint32_t nop = 0b111 << 8;
+  }
+  
+  constexpr uint32_t transfer_length(uint32_t num) { return (num & 0xff) << 0; }
+}
+
+namespace ap {
+  namespace port_select {
+    constexpr uint32_t a = 0b00 << 6;
+    constexpr uint32_t b = 0b01 << 6;
+    constexpr uint32_t c = 0b10 << 6;
+    constexpr uint32_t d = 0b11 << 6;
+  }
+  
+  namespace de {
+    constexpr uint32_t device = 1 << 5;
+    constexpr uint32_t expansion_device = 0 << 5;
+    constexpr uint32_t port = 0 << 5;
+  }
+  
+  namespace lm_bus {
+    constexpr uint32_t _4 = 0b10000 << 0;
+    constexpr uint32_t _3 = 0b01000 << 0;
+    constexpr uint32_t _2 = 0b00100 << 0;
+    constexpr uint32_t _1 = 0b00010 << 0;
+    constexpr uint32_t _0 = 0b00001 << 0;
+  }
+}
+
diff --git a/regs/maple.csv b/regs/maple_bits.csv
similarity index 100%
rename from regs/maple.csv
rename to regs/maple_bits.csv
diff --git a/regs/maple.ods b/regs/maple_bits.ods
similarity index 100%
rename from regs/maple.ods
rename to regs/maple_bits.ods
diff --git a/regs/maple_host_bits.csv b/regs/maple_host_bits.csv
new file mode 100644
index 0000000..febbbe6
--- /dev/null
+++ b/regs/maple_host_bits.csv
@@ -0,0 +1,30 @@
+"register_name","enum_name","bits","bit_name","value","mask","description"
+"host_instruction",,31,"end_flag",1,,
+,,,,,,
+"host_instruction","port_select","17-16","a",0,,
+"host_instruction","port_select","17-16","b",1,,
+"host_instruction","port_select","17-16","c",2,,
+"host_instruction","port_select","17-16","d",3,,
+,,,,,,
+"host_instruction","pattern","10-8","normal","0b000",,
+"host_instruction","pattern","10-8","light_gun_mode","0b010",,
+"host_instruction","pattern","10-8","reset","0b011",,
+"host_instruction","pattern","10-8","return_from_light_gun_mode","0b100",,
+"host_instruction","pattern","10-8","nop","0b111",,
+,,,,,,
+"host_instruction",,"7-0","transfer_length",,"0xff",
+,,,,,,
+"ap","port_select","7-6","a","0b00",,
+"ap","port_select","7-6","b","0b01",,
+"ap","port_select","7-6","c","0b10",,
+"ap","port_select","7-6","d","0b11",,
+,,,,,,
+"ap","de",5,"device",1,,
+"ap","de",5,"expansion_device",0,,
+"ap","de",5,"port",0,,
+,,,,,,
+"ap","lm_bus","4-0","_4","0b10000",,
+"ap","lm_bus","4-0","_3","0b01000",,
+"ap","lm_bus","4-0","_2","0b00100",,
+"ap","lm_bus","4-0","_1","0b00010",,
+"ap","lm_bus","4-0","_0","0b00001",,
diff --git a/regs/maple_host_bits.ods b/regs/maple_host_bits.ods
new file mode 100644
index 0000000000000000000000000000000000000000..f06e2796faf4ffa3331face35501dd95000460eb
GIT binary patch
literal 14126
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
bo`0~?>Pjf^%o_jz5B{@)8=YF-`>X!}dvB>!

literal 0
HcmV?d00001