From 419a9571b1d5a0d401f2c891c7d8c923d66ff4e8 Mon Sep 17 00:00:00 2001 From: marian Date: Thu, 15 Oct 2026 23:21:36 +0200 Subject: [PATCH] add support for gba link cable (gamecube accessory dol-011) and multiboot rom upload --- README.md | 2 +- examples/Makefile | 1 + examples/gbalink/.gitignore | 1 + examples/gbalink/Makefile | 30 ++ examples/gbalink/assets/gbarom_mb.gba | Bin 0 -> 55816 bytes examples/gbalink/gbalink.c | 205 ++++++++++++ examples/gbalink/gbarom/Makefile | 168 ++++++++++ examples/gbalink/gbarom/README.md | 2 + examples/gbalink/gbarom/source/main.c | 54 ++++ include/gba_link.h | 165 ++++++++++ include/gba_link_multiboot.h | 167 ++++++++++ include/joybus.h | 24 ++ include/libdragon.h | 2 + src/joybus/gba_link.c | 207 +++++++++++++ src/joybus/gba_link_multiboot.c | 429 ++++++++++++++++++++++++++ src/joybus/joybus_commands.h | 40 ++- src/joybus/libdragon.mk | 2 + 17 files changed, 1492 insertions(+), 7 deletions(-) create mode 100644 examples/gbalink/.gitignore create mode 100644 examples/gbalink/Makefile create mode 100755 examples/gbalink/assets/gbarom_mb.gba create mode 100644 examples/gbalink/gbalink.c create mode 100644 examples/gbalink/gbarom/Makefile create mode 100644 examples/gbalink/gbarom/README.md create mode 100644 examples/gbalink/gbarom/source/main.c create mode 100644 include/gba_link.h create mode 100644 include/gba_link_multiboot.h create mode 100644 src/joybus/gba_link.c create mode 100644 src/joybus/gba_link_multiboot.c diff --git a/README.md b/README.md index 7268912c3e..2ba717dd99 100644 --- a/README.md +++ b/README.md @@ -59,7 +59,7 @@ Seeking • Joypads • GameCube controllers • Mouse • Controller Pak • Rumble Pak • Transfer Pak • Bio Sensor • RTC +Joypads • GameCube controllers • Mouse • Controller Pak • Rumble Pak • Transfer Pak • Bio Sensor • RTC • GBA Link Cable diff --git a/examples/Makefile b/examples/Makefile index 521ad9981b..24ede1f3c7 100644 --- a/examples/Makefile +++ b/examples/Makefile @@ -11,6 +11,7 @@ EXAMPLES += customfont EXAMPLES += eepromfstest EXAMPLES += fontdemo EXAMPLES += fontgallery +EXAMPLES += gbalink EXAMPLES += gldemo EXAMPLES += helloworld EXAMPLES += joypadtest diff --git a/examples/gbalink/.gitignore b/examples/gbalink/.gitignore new file mode 100644 index 0000000000..87ef668156 --- /dev/null +++ b/examples/gbalink/.gitignore @@ -0,0 +1 @@ +filesystem/ \ No newline at end of file diff --git a/examples/gbalink/Makefile b/examples/gbalink/Makefile new file mode 100644 index 0000000000..0046cf33fc --- /dev/null +++ b/examples/gbalink/Makefile @@ -0,0 +1,30 @@ +all: gbalink.z64 +.PHONY: all + +BUILD_DIR = build +# This example uses GBA Link Cable, which is a preview API +LIBDRAGON_PREVIEW = 2 +include $(N64_INST)/include/n64.mk + +OBJS = $(BUILD_DIR)/gbalink.o +assets_gba = $(wildcard assets/*.gba) + +assets_conv = $(addprefix filesystem/,$(notdir $(assets_gba))) + +filesystem/%.gba: assets/%.gba + @mkdir -p $(dir $@) + @echo " [MKASSET] $@" + $(N64_BINDIR)/mkasset -c 2 -w 256 -o filesystem/ $< + +$(BUILD_DIR)/gbalink.dfs: $(assets_conv) + +gbalink.z64: N64_ROM_TITLE = "GBA Link Cable" +gbalink.z64: $(BUILD_DIR)/gbalink.dfs + +$(BUILD_DIR)/gbalink.elf: $(OBJS) + +clean: + rm -rf $(BUILD_DIR) filesystem/ *.z64 +.PHONY: clean + +-include $(wildcard $(BUILD_DIR)/*.d) diff --git a/examples/gbalink/assets/gbarom_mb.gba b/examples/gbalink/assets/gbarom_mb.gba new file mode 100755 index 0000000000000000000000000000000000000000..c54e48617ae0e49552bd483fe7c064209abf42cc GIT binary patch literal 55816 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 Cf|Jw$ literal 0 HcmV?d00001 diff --git a/examples/gbalink/gbalink.c b/examples/gbalink/gbalink.c new file mode 100644 index 0000000000..8c759c374f --- /dev/null +++ b/examples/gbalink/gbalink.c @@ -0,0 +1,205 @@ +#include +#include +#include + + +#define GBA_ROM_PATH "rom:/gbarom_mb.gba" +#define GBA_CHALLENGE 0x64646464 +#define GBA_RESPONSE 0x6BA006BA + +#define CLAMP(x, min, max) ((x) < (min) ? (min) : ((x) > (max) ? (max) : (x))) + +static volatile bool identify_pending = false; +static volatile bool multiboot_pending = false; +static volatile bool multiboot_done = false; +static timer_link_t *progress_timer; +static volatile int gba_port; +static volatile uint32_t gba_controller_held; +static int x, y; + +typedef enum KEYPAD_BITS { + GBA_KEY_A = (1<<0), /*!< keypad A button */ + GBA_KEY_B = (1<<1), /*!< keypad B button */ + GBA_KEY_SELECT = (1<<2), /*!< keypad SELECT button */ + GBA_KEY_START = (1<<3), /*!< keypad START button */ + GBA_KEY_RIGHT = (1<<4), /*!< dpad RIGHT */ + GBA_KEY_LEFT = (1<<5), /*!< dpad LEFT */ + GBA_KEY_UP = (1<<6), /*!< dpad UP */ + GBA_KEY_DOWN = (1<<7), /*!< dpad DOWN */ + GBA_KEY_R = (1<<8), /*!< Right shoulder button */ + GBA_KEY_L = (1<<9), /*!< Left shoulder button */ +} KEYPAD_BITS; + +static void gba_link_multiboot_callback(int port, gba_link_multiboot_status_t status, void *ctx) { + multiboot_done = status == GBA_LINK_MULTIBOOT_OK; + multiboot_pending = false; + if (!multiboot_done) { + printf("Multi Boot FAILED: %d.\n", status); + } else { + printf("Multi Boot done\n"); + } + delete_timer(progress_timer); + timer_close(); +} + +static void print_progress(int ovfl) { + printf("Progress: %d %%\n", gba_link_multiboot_progress(gba_port)); +} + +static void gba_link_multiboot_detect_callback(int port, bool multiboot_ready, void *ctx) { + printf("Port %d: Multi Boot ready: %d\n", port, multiboot_ready); + if (multiboot_ready) { + multiboot_pending = true; + timer_init(); + progress_timer = new_timer(TIMER_TICKS(500*1000), TF_CONTINUOUS, print_progress); + // Send ROM via Multi Boot, GBA logo blinking green to yellow + gba_link_multiboot_start(port, GBA_ROM_PATH, GBA_LINK_MULTIBOOT_LOGO_COLOR_3_GREEN, GBA_LINK_MULTIBOOT_LOGO_SPEED_PLUS_1, gba_link_multiboot_callback, NULL); + printf("Starting GBA Multi Boot on port: %d.\n", port); + } + identify_pending = false; +} + +static void gba_link_read_callback(int port, const uint8_t data[JOYBUS_GBA_LINK_CABLE_DATA_SIZE], uint8_t gba_status, gba_link_io_status_t io_status, void *ctx) { + if (io_status == GBA_LINK_IO_STATUS_OK) { + // Received controller status + gba_controller_held = __builtin_bswap32(*(uint32_t*)data); + //printf("GBA controller: 0x%08lx\n", gba_controller_held); + } +} + +static bool gba_challenge_response(int port) { + uint32_t data = GBA_CHALLENGE;; + uint8_t gba_status; + gba_link_io_status_t io_status = gba_link_write(port, (uint8_t*)&data, &gba_status); + if (io_status != GBA_LINK_IO_STATUS_OK) { + return false; + } + for (int i=0; i<5; i++) { + io_status = gba_link_read(port, (uint8_t*)&data, &gba_status); + if (/*io_status == GBA_LINK_IO_STATUS_OK && */__builtin_bswap32(data) == GBA_RESPONSE) { + return true; + } + } + return false; +} + +int main(void) +{ + debug_init_emulog(); + debug_init_usblog(); + + dfs_init(DFS_DEFAULT_LOCATION); + + asset_init_compression(2); + + console_init(); + console_set_render_mode(RENDER_MANUAL); + console_set_debug(false); + + rdpq_init(); + rdpq_text_register_font(1, rdpq_font_load_builtin(FONT_BUILTIN_DEBUG_VAR)); + + joypad_init(); + + console_clear(); + printf("\n"); + printf("LibDragon GBA Link Cable Subsystem Test\n"); + printf("\n"); + console_render(); + + // Detect if GBA is already listening + for (gba_port = JOYPAD_PORT_2; gba_port <= JOYPAD_PORT_4; gba_port++) { + if (gba_link_is_connected(gba_port)) {// && (gba_link_get_status(gba_port) & JOYBUS_IDENTIFY_STATUS_GBA_SENDING)) { + printf("Found GBA Link Cable on port %d\n", gba_port); + console_render(); + + // Challenge-Response with GBA rom + if (!gba_challenge_response(gba_port)) { + printf("Failed challenge-response\n\n"); + console_render(); + break; + } + + // Wait for player to press A on the GBA + printf("Press A on GBA\n"); + console_render(); + uint32_t data; + uint8_t gba_status; + gba_link_io_status_t io_status; + do { + io_status = gba_link_read(gba_port, (uint8_t*)&data, &gba_status); + } while ((io_status == GBA_LINK_IO_STATUS_OK || io_status == GBA_LINK_IO_STATUS_DATA_NOT_READY) && !(__builtin_bswap32(data) & GBA_KEY_A)); + + if (__builtin_bswap32(data) & GBA_KEY_A) { + // GBA already running, skip multiboot + multiboot_done = true; + printf("Skipping Multi Boot\n"); + console_render(); + break; + } + } + } + + // Upload GBA rom over Multi Boot, if needed + if (!multiboot_done) { + gba_port = JOYPAD_PORT_1; + + printf("Plug the GBA via its Link Cable to controller port 2-4\n"); + printf("Power on the GBA with no game\n"); + printf("(or hold SELECT+START to prevent booting the cartridge game)\n"); + printf("Press A to detect GBA Link Cable and upload a Multi Boot rom\n"); + printf("\n"); + + while (!multiboot_done) { + joypad_poll(); + joypad_buttons_t pressed = joypad_get_buttons_pressed(JOYPAD_PORT_1); + + if (pressed.a && !identify_pending && !multiboot_pending) { + gba_port++; + if (gba_port > JOYPAD_PORT_4) { + gba_port = JOYPAD_PORT_2; + } + printf("Attempting GBA Multi Boot on port %d\n", gba_port); + identify_pending = true; + gba_link_multiboot_detect(gba_port, 3000, gba_link_multiboot_detect_callback, NULL); + } + + console_render(); + } + + // Wait for GBA ROM to be ready + while (!gba_challenge_response(gba_port)) {} + } + + // Once GBA rom is sent via Multi Boot, read GBA controller status over JoyBus + // GBA controls the text position + display_close(); + display_init( RESOLUTION_320x240, DEPTH_16_BPP, 2, GAMMA_NONE, FILTERS_DISABLED ); + x = 160; + y = 120; + while (1) { + // Acquire a free framebuffer for rendering + surface_t *disp = display_get(); + // Attach the framebuffer for use by rdpq + rdpq_attach(disp, NULL); + + // Clear the framebuffer with black + rdpq_clear((color_t){0, 0, 0, 0}); + + // Read from GBA + gba_link_read_async(gba_port, gba_link_read_callback, NULL); + + if (gba_controller_held & GBA_KEY_UP) + y = CLAMP(y - 2, 40, 200); + if (gba_controller_held & GBA_KEY_DOWN) + y = CLAMP(y + 2, 40, 200); + if (gba_controller_held & GBA_KEY_LEFT) + x = CLAMP(x - 2, 20, 220); + if (gba_controller_held & GBA_KEY_RIGHT) + x = CLAMP(x + 2, 20, 220); + + rdpq_text_print(NULL, 1, x, y, "Move me from GBA"); + + rdpq_detach_show(); + } +} diff --git a/examples/gbalink/gbarom/Makefile b/examples/gbalink/gbarom/Makefile new file mode 100644 index 0000000000..99dfbb64e1 --- /dev/null +++ b/examples/gbalink/gbarom/Makefile @@ -0,0 +1,168 @@ +#--------------------------------------------------------------------------------- +# Clear the implicit built in rules +#--------------------------------------------------------------------------------- +.SUFFIXES: +#--------------------------------------------------------------------------------- +ifeq ($(strip $(DEVKITARM)),) +$(error "Please set DEVKITARM in your environment. export DEVKITARM=devkitARM) +endif + +include $(DEVKITARM)/gba_rules + +#--------------------------------------------------------------------------------- +# TARGET is the name of the output, if this ends with _mb a multiboot image is generated +# BUILD is the directory where object files & intermediate files will be placed +# SOURCES is a list of directories containing source code +# DATA is a list of directories containing data files +# INCLUDES is a list of directories containing header files +#--------------------------------------------------------------------------------- +TARGET := $(shell basename $(CURDIR))_mb +BUILD := build +SOURCES := source +DATA := +GRAPHICS := gfx +INCLUDES := + +#--------------------------------------------------------------------------------- +# options for code generation +#--------------------------------------------------------------------------------- +ARCH := -mthumb -mthumb-interwork + +CFLAGS := -g -Wall -O3\ + -mcpu=arm7tdmi -mtune=arm7tdmi\ + -fomit-frame-pointer\ + -ffast-math \ + $(ARCH) + +CFLAGS += $(INCLUDE) + +CXXFLAGS := $(CFLAGS) -fno-rtti -fno-exceptions + +ASFLAGS := $(ARCH) +LDFLAGS = -g $(ARCH) -Wl,-Map,$(notdir $@).map + +#--------------------------------------------------------------------------------- +# any extra libraries we wish to link with the project +#--------------------------------------------------------------------------------- +LIBS := -lgba + +#--------------------------------------------------------------------------------- +# list of directories containing libraries, this must be the top level containing +# include and lib +#--------------------------------------------------------------------------------- +LIBDIRS := $(LIBGBA) + +#--------------------------------------------------------------------------------- +# no real need to edit anything past this point unless you need to add additional +# rules for different file extensions +#--------------------------------------------------------------------------------- +ifneq ($(BUILD),$(notdir $(CURDIR))) +#--------------------------------------------------------------------------------- + +export OUTPUT := $(CURDIR)/$(TARGET) +export VPATH := $(foreach dir,$(SOURCES),$(CURDIR)/$(dir)) \ + $(foreach dir,$(DATA),$(CURDIR)/$(dir)) + +export DEPSDIR := $(CURDIR)/$(BUILD) + +#--------------------------------------------------------------------------------- +# automatically build a list of object files for our project +#--------------------------------------------------------------------------------- +CFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.c))) +CPPFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.cpp))) +SFILES := $(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.s))) +BINFILES := $(foreach dir,$(DATA),$(notdir $(wildcard $(dir)/*.*))) +BMPFILES := $(foreach dir,$(GRAPHICS),$(notdir $(wildcard $(dir)/*.bmp))) + +#--------------------------------------------------------------------------------- +# use CXX for linking C++ projects, CC for standard C +#--------------------------------------------------------------------------------- +ifeq ($(strip $(CPPFILES)),) +#--------------------------------------------------------------------------------- + export LD := $(CC) +#--------------------------------------------------------------------------------- +else +#--------------------------------------------------------------------------------- + export LD := $(CXX) +#--------------------------------------------------------------------------------- +endif +#--------------------------------------------------------------------------------- + +export OFILES := $(addsuffix .o,$(BINFILES)) \ + $(BMPFILES:.bmp=.o) \ + $(CPPFILES:.cpp=.o) $(CFILES:.c=.o) $(SFILES:.s=.o) + +#--------------------------------------------------------------------------------- +# build a list of include paths +#--------------------------------------------------------------------------------- +export INCLUDE := $(foreach dir,$(INCLUDES),-I$(CURDIR)/$(dir)) \ + $(foreach dir,$(LIBDIRS),-I$(dir)/include) \ + -I$(CURDIR)/$(BUILD) + +#--------------------------------------------------------------------------------- +# build a list of library paths +#--------------------------------------------------------------------------------- +export LIBPATHS := $(foreach dir,$(LIBDIRS),-L$(dir)/lib) + +.PHONY: $(BUILD) clean + +#--------------------------------------------------------------------------------- +$(BUILD): + @[ -d $@ ] || mkdir -p $@ + @make --no-print-directory -C $(BUILD) -f $(CURDIR)/Makefile + +all : $(BUILD) +#--------------------------------------------------------------------------------- +clean: + @echo clean ... + @rm -fr $(BUILD) $(TARGET).elf $(TARGET).gba + +#--------------------------------------------------------------------------------- +else + +DEPENDS := $(OFILES:.o=.d) + +#--------------------------------------------------------------------------------- +# main targets +#--------------------------------------------------------------------------------- +$(OUTPUT).gba : $(OUTPUT).elf + +$(OUTPUT).elf : $(OFILES) + + +#--------------------------------------------------------------------------------- +# The bin2o rule should be copied and modified +# for each extension used in the data directories +#--------------------------------------------------------------------------------- + +#--------------------------------------------------------------------------------- +# This rule links in binary data with the .bin extension +#--------------------------------------------------------------------------------- +%.bin.o : %.bin +#--------------------------------------------------------------------------------- + @echo $(notdir $<) + @$(bin2o) + +#--------------------------------------------------------------------------------- +# This rule links in binary data with the .raw extension +#--------------------------------------------------------------------------------- +%.raw.o : %.raw +#--------------------------------------------------------------------------------- + @echo $(notdir $<) + @$(bin2o) + +#--------------------------------------------------------------------------------- +# This rule creates assembly source files using grit +# grit takes an image file and a .grit describing how the file is to be processed +# add additional rules like this for each image extension +# you use in the graphics folders +#--------------------------------------------------------------------------------- +%.s %.h : %.bmp %.grit +#--------------------------------------------------------------------------------- + grit $< -fts -o$* + +-include $(DEPENDS) + +#--------------------------------------------------------------------------------- +endif +#--------------------------------------------------------------------------------- diff --git a/examples/gbalink/gbarom/README.md b/examples/gbalink/gbarom/README.md new file mode 100644 index 0000000000..2c61830966 --- /dev/null +++ b/examples/gbalink/gbarom/README.md @@ -0,0 +1,2 @@ +This folder contains the source for the Multi Boot GBA ROM. +Build it with the devkitPro GBA toolchain. \ No newline at end of file diff --git a/examples/gbalink/gbarom/source/main.c b/examples/gbalink/gbarom/source/main.c new file mode 100644 index 0000000000..a03e7c99bc --- /dev/null +++ b/examples/gbalink/gbarom/source/main.c @@ -0,0 +1,54 @@ +#include +#include + +#define GBA_CHALLENGE 0x64646464 +#define GBA_RESPONSE 0x6BA006BA + +/* Register REG_JSTAT: +* Bit 1 is SET and immediately RESET (?) when the console sends a Write command over Joybus. +* Bit 3 is SET when the GBA writes to REG_JOYTR (indicating that data is ready). +* Bit 3 is RESET when the console sends a Read command over Joybus. +*/ + +/* +* Register REG_HS_CTRL: +* Bit 1 is SET when the console sends a Write command over Joybus. +* Bit 2 is SET when the console sends a Read command over Joybus. +* The GBA acknowledges a Write or Read command by writing a 1 to the respective bit. +*/ +#define JOY_WRITE_ACK 2 +#define JOY_READ_ACK 4 + +int main(void) { + irqInit(); + + consoleDemoInit(); + iprintf("\x1b[3;2HGBA Link Cable Controller\n"); + + // Enable JOY BUS mode + REG_JOYTR = 0; + REG_HS_CTRL = JOY_READ_ACK | JOY_WRITE_ACK; + REG_RCNT = R_JOYBUS; + + while (true) { + // Handle Challenge-Response + if (REG_JOYRE == GBA_CHALLENGE && REG_HS_CTRL & JOY_WRITE_ACK) { + // Received challenge, prepare response and wait for read command + REG_JOYTR = GBA_RESPONSE; + iprintf("\x1b[5;2H Waiting for N64... \n"); + while (!(REG_HS_CTRL & JOY_READ_ACK)) {} + // Acknowledge write and read commands, and clear data + REG_HS_CTRL = JOY_READ_ACK | JOY_WRITE_ACK; + REG_JOYTR = 0; + } + + // Otherwise, always send held keys + u16 keys = (REG_KEYINPUT & 0x03ff) ^ 0x03ff; + REG_JOYTR = (u32) keys; + iprintf("\x1b[5;2H 0x%04x / 0x%08lx\n", keys, (u32) keys); + if(REG_HS_CTRL & JOY_READ_ACK) { + // Acknowledge read command + REG_HS_CTRL = JOY_READ_ACK; + } + } +} diff --git a/include/gba_link.h b/include/gba_link.h new file mode 100644 index 0000000000..25403fa812 --- /dev/null +++ b/include/gba_link.h @@ -0,0 +1,165 @@ +/** + * @file gba_link.h + * @author tfmoe__ + * @brief GBA Link Cable subsystem + * @ingroup gba_link + */ + +#ifndef LIBDRAGON_GBA_LINK_H +#define LIBDRAGON_GBA_LINK_H + +#include +#include + +#include "joybus.h" +#include "preview.h" + +/** + * @defgroup gba_link GBA Link Cable Subsystem + * @ingroup peripherals + * @brief GBA Link Cable interface. + * @author tfmoe__ + * + * The Nintendo GameCube Game Boy Advance Cable (DOL-011) is an accessory to + * connect a GBA to a controller port on the GameCube. It allows in-game + * communication between a GBA game and a GameCube game. The GameCube can + * also leverage the Multi Boot feature to upload a rom to the GBA. + * + * Using a passive adapter, it is possible to connect the GBA Link Cable to + * a N64. + * + * The GBA Link Cable subsystem provides an interface for communicating with + * a GBA game. It also provides an implementation of Multi Boot to upload a + * GBA rom. + * + * @{ + */ + +#ifdef __cplusplus +extern "C" { +#endif + + +/** @brief GBA Link Cable read/write status values */ +typedef enum +{ + /** @brief GBA Link Cable data communcation was successful. */ + GBA_LINK_IO_STATUS_OK = 0, + /** @brief GBA Link Cable device is absent or did not respond. */ + GBA_LINK_IO_STATUS_ABSENT, + /** @brief GBA Link Cable's reported status indicates that GBA was not ready to send data. */ + GBA_LINK_IO_STATUS_DATA_NOT_READY, + /** @brief GBA Link Cable's reported status is unexpected for the current I/O operation. */ + GBA_LINK_IO_STATUS_UNEXPECTED_STATUS +} gba_link_io_status_t; + +/** + * @brief GBA read callback function type. + * + * This function is called upon completion of an async Joybus GBA Link + * read operation initiated by gba_link_read_async(). + * + * @param port The Joybus port the GBA is connected to. + * @param data The data received from the GBA. + * @param gba_status The status received from the GBA. + * @param io_status Indicates whether the operation was successful or not. + * @param ctx User-defined context pointer. + */ +typedef void (*gba_link_read_callback_t)(int port, const uint8_t data[JOYBUS_GBA_LINK_CABLE_DATA_SIZE], uint8_t gba_status, gba_link_io_status_t io_status, void *ctx); + +/** + * @brief GBA write callback function type. + * + * This function is called upon completion of an async Joybus GBA Link + * write operation initiated by gba_link_write_async(). + * + * @param port The Joybus port the GBA is connected to. + * @param gba_status The status received from the GBA. + * @param io_status Indicates whether the operation was successful or not. + * @param ctx User-defined context pointer. + */ +typedef void (*gba_link_write_callback_t)(int port, uint8_t gba_status, gba_link_io_status_t io_status, void *ctx); + +/** + * @brief Whether a GBA Link Cable is plugged in to a Joybus port. + * + * @param port The Joybus port number + * + * @retval true A GBA Link Cable is connected to the Joybus port. + * @retval false No GBA Link Cable is connected to the Joybus port. + */ +LIBDRAGON_PREVIEW_API +bool gba_link_is_connected(int port); + +/** + * @brief Get the last known GBA status for a specific port. + * + * This function returns the last known status for a specific Joybus port. + * + * @note Returns 0 if the given port is not connected to a GBA Link Cable. + * + * @param port The Joybus port number + * + * @return The last known status for the specified port. + */ +LIBDRAGON_PREVIEW_API +uint8_t gba_link_get_status(int port); + +/** + * @brief Asynchronously perform a Joybus GBA Link read command. + * + * @param port The controller port of the GBA Link to read from. + * @param callback A function pointer to call when the operation completes. + * @param ctx A user data pointer to pass into the callback function. + */ +LIBDRAGON_PREVIEW_API +void gba_link_read_async(int port, gba_link_read_callback_t callback, void *ctx); + +/** + * @brief Asynchronously perform a Joybus GBA Link write command. + * + * @param port The controller port of the GBA Link to write to. + * @param[in] data The data to write to the GBA Link. + * @param callback A function pointer to call when the operation completes. + * @param ctx A user data pointer to pass into the callback function. + */ +LIBDRAGON_PREVIEW_API +void gba_link_write_async(int port, const uint8_t *data, gba_link_write_callback_t callback, void *ctx); + +/** + * @brief Synchronously perform a Joybus GBA Link read command. + * + * @param port The controller port of the GBA Link to read from. + * @param[out] data The 4 bytes of data that was read from the GBA. + * @param[out] gba_status The status of the GBA as returned by it. + * + * @retval #GBA_LINK_IO_STATUS_OK The data was read successfully. + * @retval #GBA_LINK_IO_STATUS_ABSENT The data was not read successfully because the device is absent. + * @retval #GBA_LINK_IO_STATUS_DATA_NOT_READY The data was not read successfully because the device is not ready. + * @retval #GBA_LINK_IO_STATUS_UNEXPECTED_STATUS The data was not read successfully because the device is in an invalid state. + */ +LIBDRAGON_PREVIEW_API +gba_link_io_status_t gba_link_read(int port, uint8_t *data, uint8_t* gba_status); + +/** + * @brief Synchronously perform a Joybus GBA Link write command. + * + * @param port The controller port of the GBA Link to write to. + * @param[in] data The 4 bytes of data to write to the GBA. + * @param[out] gba_status The status of the GBA as returned by it. + * + * @retval #GBA_LINK_IO_STATUS_OK The data was written successfully. + * @retval #GBA_LINK_IO_STATUS_ABSENT The data was not written successfully because the device is absent. + * @retval #GBA_LINK_IO_STATUS_UNEXPECTED_STATUS The data was not written successfully because the device is in an invalid state. + */ +LIBDRAGON_PREVIEW_API +gba_link_io_status_t gba_link_write(int port, const uint8_t *data, uint8_t* gba_status); + + +#ifdef __cplusplus +} +#endif + +/** @} */ /* gba_link */ + +#endif /* LIBDRAGON_GBA_LINK_H */ diff --git a/include/gba_link_multiboot.h b/include/gba_link_multiboot.h new file mode 100644 index 0000000000..d6ab7c4cb0 --- /dev/null +++ b/include/gba_link_multiboot.h @@ -0,0 +1,167 @@ +/** + * @file gba_link_multiboot.h + * @author tfmoe__ + * @brief GBA Link Cable support for Multi Boot + * @ingroup gba_link + */ + +#ifndef LIBDRAGON_GBA_LINK_MULTIBOOT_H +#define LIBDRAGON_GBA_LINK_MULTIBOOT_H + +#include + +#include "preview.h" + +/** + * @addtogroup gba_link + * @{ + */ + +#ifdef __cplusplus +extern "C" { +#endif + + +/** @brief GBA Multi Boot status values */ +typedef enum +{ + /** @brief GBA Multi Boot was successful. */ + GBA_LINK_MULTIBOOT_OK = 0, + /** @brief GBA Multi Boot failed because of an issue in I/O operations. */ + GBA_LINK_MULTIBOOT_BAD_IO, + /** @brief GBA Multi Boot failed because the GBA reported a status inconsistent with I/O operations. */ + GBA_LINK_MULTIBOOT_BAD_STATUS, + /** @brief GBA Multi Boot failed because the GBA reported a dummy byte inconsistent with uploaded data. */ + GBA_LINK_MULTIBOOT_BAD_DUMMY_BYTE, + /** @brief GBA Multi Boot failed because of an issue while reading file. */ + GBA_LINK_MULTIBOOT_BAD_FILE +} gba_link_multiboot_status_t; + +/** @brief GBA Multi Boot logo base color */ +typedef enum { + /** @brief Pink base color. + * @note Transitions to blue when combined with a positive speed. + * @note Transitions from blue when combined with a negative speed. + */ + GBA_LINK_MULTIBOOT_LOGO_COLOR_0_PINK = 0, + /** @brief Blue base color. + * @note Transitions to cyan when combined with a positive speed. + * @note Transitions from cyan when combined with a negative speed. + */ + GBA_LINK_MULTIBOOT_LOGO_COLOR_1_BLUE, + /** @brief Cyan base color. + * @note Transitions to green when combined with a positive speed. + * @note Transitions from green when combined with a negative speed. + */ + GBA_LINK_MULTIBOOT_LOGO_COLOR_2_CYAN, + /** @brief Green base color. + * @note Transitions to yellow when combined with a positive speed. + * @note Transitions from yellow when combined with a negative speed. + */ + GBA_LINK_MULTIBOOT_LOGO_COLOR_3_GREEN, + /** @brief Yellow base color. + * @note Transitions to red when combined with a positive speed. + * @note Transitions from red when combined with a negative speed. + */ + GBA_LINK_MULTIBOOT_LOGO_COLOR_4_YELLOW, + /** @brief Red base color. + * @note Transitions to pink when combined with a positive speed. + * @note Transitions from pink when combined with a negative speed. + */ + GBA_LINK_MULTIBOOT_LOGO_COLOR_5_RED, + /** @brief Pink base color. + * @note Transitions to white when combined with a positive speed. + * @note Transitions from white when combined with a negative speed. + */ + GBA_LINK_MULTIBOOT_LOGO_COLOR_6_PINK, +} gba_link_multiboot_logo_color_t; + +/** @brief GBA Multi Boot logo speed +* +* Null speed show base color only. +* Positive speeds animate the logo, transition from the base color. +* Negative speeds animate the logo, transition to the base color. +*/ +typedef enum { + GBA_LINK_MULTIBOOT_LOGO_SPEED_MINUS_4 = -4, + GBA_LINK_MULTIBOOT_LOGO_SPEED_MINUS_3, + GBA_LINK_MULTIBOOT_LOGO_SPEED_MINUS_2, + GBA_LINK_MULTIBOOT_LOGO_SPEED_MINUS_1, + GBA_LINK_MULTIBOOT_LOGO_SPEED_0, + GBA_LINK_MULTIBOOT_LOGO_SPEED_PLUS_1, + GBA_LINK_MULTIBOOT_LOGO_SPEED_PLUS_2, + GBA_LINK_MULTIBOOT_LOGO_SPEED_PLUS_3, + GBA_LINK_MULTIBOOT_LOGO_SPEED_PLUS_4, +} gba_link_multiboot_logo_speed_t; + +/** + * @brief GBA Multi Boot callback function type. + * + * This function is called upon completion of a Multi Boot rom upload operation + * initiated by gba_link_multiboot_start(). + * + * @param port The Joybus port the GBA is connected to. + * @param status Multiboot execution status + * @param ctx User-defined context pointer. + */ +typedef void (*gba_link_multiboot_callback_t)(int port, gba_link_multiboot_status_t status, void *ctx); + +/** + * @brief Starts the process of asynchronously uploading a rom via GBA Link Cable. + * The GBA on the given port must be ready for Multi Boot. + * + * @param port The Joybus port the GBA is connected to. + * @param filename Path to the GBA rom file to upload. + * @param logo_color Color setting for the GBA logo displayed during upload. + * @param logo_speed Speed setting for the GBA logo displayed during upload. + * @param callback A function pointer to call when the operation completes. + * @param ctx A user data pointer to pass into the callback function. + */ +LIBDRAGON_PREVIEW_API +void gba_link_multiboot_start(int port, const char* filename, gba_link_multiboot_logo_color_t logo_color, gba_link_multiboot_logo_speed_t logo_speed, gba_link_multiboot_callback_t callback, void *ctx); + + +/** + * @brief GBA Multi Boot detection callback function type. + * + * This function is called upon completion of an async detection operation + * initiated by gba_link_multiboot_detect(). + * + * @param port The Joybus port on which GBA detection happened. + * @param multiboot_ready Wheteher a GBA Link Cable is connected to the given port and ready for Multi Boot. + * @param ctx User-defined context pointer. + */ +typedef void (*gba_link_multiboot_detect_callback_t)(int port, bool multiboot_ready, void *ctx); + +/** + * @brief Asynchronously detects a GBA Link Cable ready for Multi Boot on the given port. + * + * Repeatedly emits reset and identify commands for a given time, checking the GBA status + * for Multi Boot readiness. + * + * @param port The Joybus port on which to detect GBA Link Cable. + * @param timeout Time (in ms) after which detection is aborted if no GBA Link Cable was identified. + * @param callback A function pointer to call when the operation completes. + * @param ctx A user data pointer to pass into the callback function. + */ +LIBDRAGON_PREVIEW_API +void gba_link_multiboot_detect(int port, int timeout, gba_link_multiboot_detect_callback_t callback, void *ctx); + +/** + * @brief Get the progress of a Multi Boot upload operation on the given port. + * + * @param port The Joybus port the GBA is connected to. + * + * @return The progess (in percent), or 0 if there is no Multi Boot operation happening. + */ +LIBDRAGON_PREVIEW_API +uint8_t gba_link_multiboot_progress(int port); + + +#ifdef __cplusplus +} +#endif + +/** @} */ /* gba_link */ + +#endif /* LIBDRAGON_GBA_LINK_MULTIBOOT_H */ diff --git a/include/joybus.h b/include/joybus.h index 932d80f193..79f9079235 100644 --- a/include/joybus.h +++ b/include/joybus.h @@ -76,6 +76,10 @@ extern "C" { * @brief Size of a Joybus N64 accessory read/write payload in bytes. */ #define JOYBUS_ACCESSORY_DATA_SIZE 32 +/** + * @brief Size of a Joybus GBA Link Cable read/write payload in bytes. + */ +#define JOYBUS_GBA_LINK_CABLE_DATA_SIZE 4 /** @} */ /* JOYBUS_PAYLOAD_SIZES */ /** @@ -245,6 +249,26 @@ typedef uint16_t joybus_identifier_t; * @brief Joybus identify status bit for EEPROM devices that indicates a write is in-progress. */ #define JOYBUS_IDENTIFY_STATUS_EEPROM_BUSY 0x80 +/** + * @brief Joybus identify status byte mask for GBA Link Cable status. + */ +#define JOYBUS_IDENTIFY_STATUS_GBA_MASK 0x3A +/** + * @brief Joybus identify status byte mask for GBA Link Cable GPIO flag 1. + */ +#define JOYBUS_IDENTIFY_STATUS_GBA_GPIO1 0x20 +/** + * @brief Joybus identify status byte mask for GBA Link Cable GPIO flag 0. + */ +#define JOYBUS_IDENTIFY_STATUS_GBA_GPIO0 0x10 +/** + * @brief Joybus identify status byte mask for GBA Link Cable sending flag. + */ +#define JOYBUS_IDENTIFY_STATUS_GBA_SENDING 0x08 +/** + * @brief Joybus identify status byte mask for GBA Link Cable receiving flag. + */ +#define JOYBUS_IDENTIFY_STATUS_GBA_RECEIVING 0x02 /** @} */ /** @brief Joybus detection events enumeration */ diff --git a/include/libdragon.h b/include/libdragon.h index 88e115906e..d427832714 100644 --- a/include/libdragon.h +++ b/include/libdragon.h @@ -40,6 +40,8 @@ #include "controller.h" #include "rtc.h" #include "bio_sensor.h" +#include "gba_link.h" +#include "gba_link_multiboot.h" #include "mempak.h" #include "cpak.h" #include "cpakfs.h" diff --git a/src/joybus/gba_link.c b/src/joybus/gba_link.c new file mode 100644 index 0000000000..37928c1880 --- /dev/null +++ b/src/joybus/gba_link.c @@ -0,0 +1,207 @@ +/** + * @file gba_link.c + * @author tfmoe__ + * @brief GBA Link Cable Subsystem + * @ingroup gba_link + */ + +#include +#include + +#include "gba_link.h" +#include "joybus_commands.h" +#include "joypad.h" + +/** + * @addtogroup gba_link + * @{ + */ + + +bool gba_link_is_connected(int port) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + return joybus_get_identifier(port, NULL) == JOYBUS_IDENTIFIER_GBA_LINK_CABLE; +} + +uint8_t gba_link_get_status(int port) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + uint8_t status; + if (joybus_get_identifier(port, &status) != JOYBUS_IDENTIFIER_GBA_LINK_CABLE) { + return 0; + } + return status; +} + +/** + * @brief Async read command context + */ +typedef struct +{ + int port; + gba_link_read_callback_t callback; + void *ctx; +} gba_link_cable_read_context_t; + +static void gba_link_read_callback(uint64_t *out_dwords, void *ctx) +{ + const uint8_t *out_bytes = (void *)out_dwords; + gba_link_cable_read_context_t* context = (void*)ctx; + joypad_port_t port = context->port; + + const joybus_cmd_gba_link_cable_read_port_t *cmdr = + (void *)&out_bytes[port + JOYBUS_COMMAND_METADATA_SIZE]; + + gba_link_io_status_t io_status = GBA_LINK_IO_STATUS_OK; + // Check for joybus error (no device) + if ((out_bytes[port+1] & 0x80) != 0) { + io_status = GBA_LINK_IO_STATUS_ABSENT; + } + // Check GBA status + if ((cmdr->recv.status & JOYBUS_IDENTIFY_STATUS_GBA_SENDING) == 0) { + io_status = GBA_LINK_IO_STATUS_DATA_NOT_READY; + } + + gba_link_read_callback_t callback = context->callback; + if (callback != NULL) { + // Command data may be misaligned, so we copy it to an aligned word + uint32_t copy; + memcpy(©, cmdr->recv.data, sizeof(cmdr->recv.data)); + callback(port, (uint8_t*)©, cmdr->recv.status, io_status, (void*)context->ctx); + } + free(context); +} + +void gba_link_read_async( + int port, + gba_link_read_callback_t callback, + void *ctx +) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + uint8_t input[JOYBUS_BLOCK_SIZE] = {0}; + joybus_cmd_gba_link_cable_read_port_t cmd = { .send = { + .command = JOYBUS_COMMAND_ID_GBA_LINK_CABLE_READ, + } }; + size_t i = port; + // Set the command metadata + input[i++] = sizeof(cmd.send); + input[i++] = sizeof(cmd.recv); + // Micro-optimization: Minimize copy length + const size_t recv_offset = offsetof(typeof(cmd), recv); + memcpy(&input[i], &cmd.send, recv_offset); + i += sizeof(cmd); + // Close out the Joybus operation block + input[i] = 0xFE; + input[sizeof(input) - 1] = 0x01; + // Execute the Joybus operation asynchronously + gba_link_cable_read_context_t* gba_link_read_context = calloc(1, sizeof(gba_link_cable_read_context_t)); + gba_link_read_context->port = port; + gba_link_read_context->callback = callback; + gba_link_read_context->ctx = ctx; + joybus_exec_async(input, gba_link_read_callback, (void*)gba_link_read_context); +} + +/** + * @brief Async write command context + */ +typedef struct +{ + int port; + gba_link_write_callback_t callback; + void *ctx; +} gba_link_cable_write_context_t; + +static void gba_link_write_callback(uint64_t *out_dwords, void *ctx) +{ + const uint8_t *out_bytes = (void *)out_dwords; + gba_link_cable_write_context_t* context = (void*)ctx; + joypad_port_t port = context->port; + + const joybus_cmd_gba_link_cable_write_port_t *cmdw = + (void *)&out_bytes[port + JOYBUS_COMMAND_METADATA_SIZE]; + + gba_link_io_status_t io_status = GBA_LINK_IO_STATUS_OK; + // Check for joybus error (no device) + if ((out_bytes[port+1] & 0x80) != 0) { + io_status = GBA_LINK_IO_STATUS_ABSENT; + } + // Check GBA status + if ((cmdw->recv.status & JOYBUS_IDENTIFY_STATUS_GBA_RECEIVING) == 0) { + io_status = GBA_LINK_IO_STATUS_UNEXPECTED_STATUS; + } + + gba_link_write_callback_t callback = context->callback; + if (callback != NULL) + callback(port, cmdw->recv.status, io_status, (void*)context->ctx); + free(context); +} + +void gba_link_write_async( + int port, + const uint8_t *data, + gba_link_write_callback_t callback, + void *ctx +) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + uint8_t input[JOYBUS_BLOCK_SIZE] = {0}; + joybus_cmd_gba_link_cable_write_port_t cmd = { .send = { + .command = JOYBUS_COMMAND_ID_GBA_LINK_CABLE_WRITE, + } }; + size_t i = port; + // Set the command metadata + input[i++] = sizeof(cmd.send); + input[i++] = sizeof(cmd.recv); + // Micro-optimization: Minimize copy length + const size_t data_offset = offsetof(typeof(cmd.send), data); + memcpy(&input[i], &cmd.send, data_offset); + memcpy(&input[i + data_offset], data, sizeof(cmd.send.data)); + i += sizeof(cmd); + // Close out the Joybus operation block + input[i] = 0xFE; + input[sizeof(input) - 1] = 0x01; + // Execute the Joybus operation asynchronously + gba_link_cable_write_context_t* gba_link_write_context = calloc(1, sizeof(gba_link_cable_write_context_t)); + gba_link_write_context->port = port; + gba_link_write_context->callback = callback; + gba_link_write_context->ctx = ctx; + joybus_exec_async(input, gba_link_write_callback, (void*)gba_link_write_context); +} + +gba_link_io_status_t gba_link_read(int port, uint8_t *data, uint8_t* gba_status) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + joybus_cmd_gba_link_cable_read_port_t cmd = { .send = { + .command = JOYBUS_COMMAND_ID_GBA_LINK_CABLE_READ, + } }; + // Execute the command + joybus_exec_cmd_struct(port, cmd); + // Copy the data from the command receive buffer + memcpy(data, cmd.recv.data, sizeof(cmd.recv.data)); + *gba_status = cmd.recv.status; + if ((*gba_status & JOYBUS_IDENTIFY_STATUS_GBA_SENDING) == 0) { + return GBA_LINK_IO_STATUS_DATA_NOT_READY; + } + return GBA_LINK_IO_STATUS_OK; +} + +gba_link_io_status_t gba_link_write(int port, const uint8_t *data, uint8_t* gba_status) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + joybus_cmd_gba_link_cable_write_port_t cmd = { .send = { + .command = JOYBUS_COMMAND_ID_GBA_LINK_CABLE_WRITE, + } }; + // Copy the data to the command send buffer + memcpy(cmd.send.data, data, sizeof(cmd.send.data)); + // Execute the command + joybus_exec_cmd_struct(port, cmd); + *gba_status = cmd.recv.status; + if ((*gba_status & JOYBUS_IDENTIFY_STATUS_GBA_RECEIVING) == 0) { + return GBA_LINK_IO_STATUS_UNEXPECTED_STATUS; + } + return GBA_LINK_IO_STATUS_OK; +} + +/** @} */ /* gba_link */ diff --git a/src/joybus/gba_link_multiboot.c b/src/joybus/gba_link_multiboot.c new file mode 100644 index 0000000000..d43d25d986 --- /dev/null +++ b/src/joybus/gba_link_multiboot.c @@ -0,0 +1,429 @@ +/** + * @file gba_link_multiboot.c + * @author tfmoe__ + * @brief GBA Link Cable support for Multi Boot + * @ingroup gba_link + */ + +#include +#include + +#include "asset.h" +#include "interrupt.h" +#include "gba_link.h" +#include "gba_link_multiboot.h" +#include "joybus_commands.h" +#include "joypad.h" +#include "timer.h" + +/** + * @addtogroup gba_link + * @{ + */ + + +/** @brief Delay between two attempts to detect GBA Link ready for Multi Boot */ +#define IDENTIFY_RETRY_DELAY_US TIMER_TICKS(5000) + +/** @brief Payload length must be rounded up to the nearest 8-byte boundary */ +#define ROUND_UP_8(val) (((val) + 7) & ~7) + +// Keys extracted from secret string " by Kawasedo" +/** @brief Key: " by " */ +#define MAGIC_BY 0x20627920 +/** @brief Key: "Kawa" */ +#define MAGIC_KAWA 0x4b617761 +/** @brief Key: "sedo" */ +#define MAGIC_SEDO 0x7365646f + +/** @brief Calculate key B from payload length and logo settings */ +static uint32_t calc_key(uint32_t length, gba_link_multiboot_logo_speed_t speed, gba_link_multiboot_logo_color_t color) { + // Compute payload length in 8-byte blocks, past the minimum 512 bytes + length = (length - 0x200) >> 3; + // Compute logo settings + uint32_t logo = speed < 0 + ? (color << 3 | (3 - speed)) + : (speed > 0 + ? (color << 3 | (speed - 1)) + : (color | 0x38) + ); + // Mangle payload length + uint32_t mangled = (length & 0x4000) << 2 | (length & 0x3f80) << 1 | (length & 0x7f); + // Combine mangled length with logo settings + uint32_t key = (logo << 17) | mangled; + // Checksum + uint8_t checksum = ((key >> 16) + (key >> 8) + key) & 0x7f; + // Combine key with checksum and fixed bits + key = (checksum << 24) | 0x80808080 | key; + // XOR with the correct key + uint32_t xorkey = (key & 0x200) ? MAGIC_SEDO : MAGIC_KAWA; + return __builtin_bswap32(key) ^ xorkey; +} + +/** @brief Update the running CRC with latest payload word */ +static uint32_t update_crc(uint32_t crc, uint32_t val) { + for (int i = 0; i < 0x20; i++) { + if ((crc ^ val) & 1) { + crc >>= 1; + crc ^= 0xa1c1; + } else { + crc >>= 1; + } + val >>= 1; + } + return crc; +} + +/** @brief Cipher payload word and update session key */ +static uint32_t cipher_data(uint32_t data, int i, uint32_t* sessionkey) { + *sessionkey = (*sessionkey * __builtin_bswap32(MAGIC_KAWA)) + 1; + data ^= *sessionkey; + data ^= ((~(i + (0x20<<20))) + 1); + data ^= __builtin_bswap32(MAGIC_BY); + return data; +} + + +/** @brief Internal state for Multi Boot */ +typedef enum { + GBA_MULTIBOOT_IDLE = 0, + GBA_MULTIBOOT_CLEARTEXT, + GBA_MULTIBOOT_CIPHERTEXT, + GBA_MULTIBOOT_CRC, + GBA_MULTIBOOT_CHECK, + GBA_MULTIBOOT_DONE, +} multiboot_state_t; + +/** + * @brief Multi Boot context + */ +typedef struct +{ + FILE* file; + int length; + gba_link_multiboot_logo_color_t logo_color; + gba_link_multiboot_logo_speed_t logo_speed; + multiboot_state_t state; + uint32_t crc; + uint32_t dummy[8]; + uint32_t sessionkey; + int sent; + gba_link_multiboot_callback_t callback; + void *ctx; +} multiboot_context_t; + +/** @brief Per-port Multi Boot contexts */ +static multiboot_context_t multiboot_contexts[JOYPAD_PORT_COUNT]; + +/** @brief Terminate Multi Boot, execute callback with status, close file and clear context */ +static void terminate_multiboot(int port, gba_link_multiboot_status_t status, multiboot_context_t* context) { + gba_link_multiboot_callback_t callback = context->callback; + if (callback != NULL) + callback(port, status, (void*)context->ctx); + fclose(context->file); + memset(context, 0, sizeof(multiboot_context_t)); +} + +static void gba_link_write_callback(int port, uint8_t gba_status, gba_link_io_status_t io_status, void *ctx); + +static void gba_link_read_callback(int port, const uint8_t data[JOYBUS_GBA_LINK_CABLE_DATA_SIZE], uint8_t gba_status, gba_link_io_status_t io_status, void *ctx) { + multiboot_context_t* context = (void*) ctx; + // Handle I/O errors + if (io_status != GBA_LINK_IO_STATUS_OK) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_IO, context); + return; + } + switch (context->state) { + case GBA_MULTIBOOT_IDLE: { + // Check GBA status + if (gba_status != (JOYBUS_IDENTIFY_STATUS_GBA_GPIO0 | JOYBUS_IDENTIFY_STATUS_GBA_SENDING)) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_STATUS, context); + return; + } + // Compute session key from received data + context->sessionkey = *(uint32_t*)data; + context->sessionkey = context->sessionkey ^ MAGIC_SEDO; + context->sessionkey = __builtin_bswap32(context->sessionkey); + // Compute host key from payload length and palette configuration + uint32_t calc = calc_key(ROUND_UP_8(context->length), context->logo_speed, context->logo_color); + context->crc = 0x15a0; + context->sent = 0; + context->state = GBA_MULTIBOOT_CLEARTEXT; + gba_link_write_async(port, (uint8_t*) &calc, gba_link_write_callback, ctx); + break; + } + case GBA_MULTIBOOT_CLEARTEXT: + case GBA_MULTIBOOT_CIPHERTEXT: + case GBA_MULTIBOOT_CRC: + break; + case GBA_MULTIBOOT_CHECK: { + uint32_t d = __builtin_bswap32(*(uint32_t*)data); + if (d != context->dummy[4] && d != context->dummy[5] && d != context->dummy[6]) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_DUMMY_BYTE, context); + return; + } + context->state = GBA_MULTIBOOT_DONE; + terminate_multiboot(port, GBA_LINK_MULTIBOOT_OK, context); + break; + } + case GBA_MULTIBOOT_DONE: { + break; + } + } +} + +static void gba_link_write_callback(int port, uint8_t gba_status, gba_link_io_status_t io_status, void *ctx) { + multiboot_context_t* context = (void*) ctx; + // Handle I/O errors + if (io_status != GBA_LINK_IO_STATUS_OK) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_IO, context); + return; + } + switch (context->state) { + case GBA_MULTIBOOT_IDLE: + break; + case GBA_MULTIBOOT_CLEARTEXT: { + // Check GBA status + if (context->sent > 0 && !(gba_status & JOYBUS_IDENTIFY_STATUS_GBA_GPIO1)) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_STATUS, context); + return; + } + if ((gba_status & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0) != (~(context->sent<<2) & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0)) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_STATUS, context); + return; + } + uint8_t buf[JOYBUS_GBA_LINK_CABLE_DATA_SIZE]; + size_t nread; + if ((nread = fread(buf, sizeof(buf[0]), sizeof(buf), context->file)) != 0) { + gba_link_write_async(port, buf, gba_link_write_callback, ctx); + context->sent += 4; + if (context->sent == 0xc0) { + context->state = GBA_MULTIBOOT_CIPHERTEXT; + } + } else { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_FILE, context); + return; + } + break; + } + case GBA_MULTIBOOT_CIPHERTEXT: { + if ((gba_status & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0) != (~(context->sent<<2) & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0)) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_STATUS, context); + return; + } + // ROM data must be ciphered for the remaining of the payload + // CRC is updated for each packet sent + uint32_t d = 0; // If rounded-length is larger than file length, pad with zeroes + if (context->sent < context->length) { + uint8_t buf[JOYBUS_GBA_LINK_CABLE_DATA_SIZE]; + size_t nread; + if ((nread = fread(buf, sizeof(buf[0]), sizeof(buf), context->file)) != 0) { + d = __builtin_bswap32(*(uint32_t*)buf); + } else { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_FILE, context); + return; + } + } + uint32_t cipherText = __builtin_bswap32(cipher_data(d, context->sent, &context->sessionkey)); + context->crc = update_crc(context->crc, d); + // Collect dummy bytes to check against at the end of Multi Boot + if (context->sent == 0x1f8) { + context->dummy[0] = d; + context->dummy[2] = __builtin_bswap32(cipherText); + } else if (context->sent == 0x1fc) { + context->dummy[1] = d; + context->dummy[3] = __builtin_bswap32(cipherText); + context->dummy[4] = context->dummy[2] * context->dummy[3]; + context->dummy[5] = context->dummy[0] * context->dummy[1]; + context->dummy[6] = context->dummy[0] * context->dummy[3]; + } + gba_link_write_async(port, (uint8_t*) &cipherText, gba_link_write_callback, ctx); + context->sent += 4; + if (context->sent == ROUND_UP_8(context->length)) { + context->state = GBA_MULTIBOOT_CRC; + } + break; + } + case GBA_MULTIBOOT_CRC: { + if ((gba_status & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0) != (~(context->sent<<2) & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0)) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_STATUS, context); + return; + } + // Finalize and send CRC + context->crc |= (ROUND_UP_8(context->length) << 16); + context->crc = __builtin_bswap32(cipher_data(context->crc, context->sent, &context->sessionkey)); + gba_link_write_async(port, (uint8_t*) &context->crc, gba_link_write_callback, ctx); + context->state = GBA_MULTIBOOT_CHECK; + break; + } + case GBA_MULTIBOOT_CHECK: { + if ((gba_status & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0) != (~((context->sent+4)<<2) & JOYBUS_IDENTIFY_STATUS_GBA_GPIO0)) { + terminate_multiboot(port, GBA_LINK_MULTIBOOT_BAD_STATUS, context); + return; + } + gba_link_read_async(port, gba_link_read_callback, ctx); + break; + } + case GBA_MULTIBOOT_DONE: + break; + } +} + +void gba_link_multiboot_start( + int port, + const char *file_name, + gba_link_multiboot_logo_color_t logo_color, + gba_link_multiboot_logo_speed_t logo_speed, + gba_link_multiboot_callback_t callback, + void *ctx +) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + memset(&multiboot_contexts[port], 0, sizeof(multiboot_context_t)); + multiboot_contexts[port].callback = callback; + multiboot_contexts[port].ctx = ctx; + multiboot_contexts[port].file = asset_fopen(file_name, &multiboot_contexts[port].length); + multiboot_contexts[port].logo_color = logo_color; + multiboot_contexts[port].logo_speed = logo_speed; + gba_link_read_async(port, gba_link_read_callback, (void*)&multiboot_contexts[port]); +} + + +/** + * @brief Async detection context + */ +typedef struct +{ + int port; + bool pending; + uint8_t progress; + gba_link_multiboot_detect_callback_t callback; + timer_link_t *retry_timer; + timer_link_t *abort_timer; + void *ctx; +} gba_link_multiboot_detect_context_t; + +/** @brief Per-port detection contexts */ +static gba_link_multiboot_detect_context_t gba_link_multiboot_detect_contexts[JOYPAD_PORT_COUNT]; + +static void gba_link_multiboot_identify_callback(uint64_t *out_dwords, void *ctx); + +static void queue_joybus_input_reset_async(gba_link_multiboot_detect_context_t* context) { + joybus_cmd_reset_port_t cmd = { .send = { + .command = JOYBUS_COMMAND_ID_RESET, + } }; + // Allocate the Joybus operation block input and output buffers + uint8_t input[JOYBUS_BLOCK_SIZE] = {0}; + // Skip commands on ports before the desired port offset + size_t i = context->port; + // Set the command metadata + input[i++] = sizeof(cmd.send); + input[i++] = sizeof(cmd.recv); + // Copy the send_data into the input buffer + memcpy( &input[i], (void *)&cmd.send, sizeof(cmd.send) ); + i += sizeof(cmd.send) + sizeof(cmd.recv); + // Close out the Joybus operation block + input[i] = 0xFE; + input[sizeof(input) - 1] = 0x01; + joybus_exec_async(input, NULL, NULL); +} + +static void queue_joybus_input_identify_async(gba_link_multiboot_detect_context_t* context) { + joybus_cmd_identify_port_t cmd = { .send = { + .command = JOYBUS_COMMAND_ID_IDENTIFY, + } }; + // Allocate the Joybus operation block input and output buffers + uint8_t input[JOYBUS_BLOCK_SIZE] = {0}; + // Skip commands on ports before the desired port offset + size_t i = context->port; + // Set the command metadata + input[i++] = sizeof(cmd.send); + input[i++] = sizeof(cmd.recv); + // Copy the send_data into the input buffer + memcpy( &input[i], (void *)&cmd.send, sizeof(cmd.send) ); + i += sizeof(cmd.send) + sizeof(cmd.recv); + // Close out the Joybus operation block + input[i] = 0xFE; + input[sizeof(input) - 1] = 0x01; + joybus_exec_async(input, gba_link_multiboot_identify_callback, (void*)context); +} + +static void retry_identify(int ovfl, void *ctx) { + gba_link_multiboot_detect_context_t* context = (void*)ctx; + delete_timer(context->retry_timer); + timer_close(); + context->retry_timer = NULL; + queue_joybus_input_reset_async(context); + queue_joybus_input_identify_async(context); +} + +static void abort_identify(int ovfl, void *ctx) { + gba_link_multiboot_detect_context_t* context = (void*)ctx; + delete_timer(context->abort_timer); + timer_close(); + context->abort_timer = NULL; + context->pending = false; +} + +static void gba_link_multiboot_identify_callback(uint64_t *out_dwords, void *ctx) { + const uint8_t *out_bytes = (void *)out_dwords; + gba_link_multiboot_detect_context_t* context = (void*)ctx; + size_t i = context->port; + const joybus_cmd_identify_port_t *cmd = (void *)&out_bytes[i + JOYBUS_COMMAND_METADATA_SIZE]; + bool multiboot_ready = false; + if ((out_bytes[i+1] & 0x80) == 0 + && cmd->recv.identifier == JOYBUS_IDENTIFIER_GBA_LINK_CABLE + && cmd->recv.status == (JOYBUS_IDENTIFY_STATUS_GBA_GPIO0 | JOYBUS_IDENTIFY_STATUS_GBA_SENDING) + ) { + multiboot_ready = true; + context->pending = false; + } + + if (!context->pending) { + if (context->abort_timer != NULL) { + delete_timer(context->abort_timer); + timer_close(); + } + gba_link_multiboot_detect_callback_t callback = context->callback; + if (callback != NULL) + callback(context->port, multiboot_ready, (void*)context->ctx); + memset(context, 0, sizeof(gba_link_multiboot_detect_context_t)); + } else { + timer_init(); + context->retry_timer = new_timer_context(IDENTIFY_RETRY_DELAY_US, TF_ONE_SHOT, retry_identify, context); + } +} + +void gba_link_multiboot_detect(int port, int timeout, gba_link_multiboot_detect_callback_t callback, void *ctx) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + // Disabled during reset + if( exception_reset_time() > 0 ) { return; } + // Already in-progress + if (gba_link_multiboot_detect_contexts[port].pending) { return; } + + memset(&gba_link_multiboot_detect_contexts[port], 0, sizeof(gba_link_multiboot_detect_context_t)); + gba_link_multiboot_detect_contexts[port].port = port; + gba_link_multiboot_detect_contexts[port].pending = true; + gba_link_multiboot_detect_contexts[port].progress = 0; + gba_link_multiboot_detect_contexts[port].callback = callback; + gba_link_multiboot_detect_contexts[port].retry_timer = NULL; + gba_link_multiboot_detect_contexts[port].ctx = ctx; + // Set abort timer + timer_init(); + gba_link_multiboot_detect_contexts[port].abort_timer = new_timer_context(TIMER_TICKS(timeout * 1000), TF_ONE_SHOT, abort_identify, (void*)&gba_link_multiboot_detect_contexts[port]); + queue_joybus_input_reset_async(&gba_link_multiboot_detect_contexts[port]); + queue_joybus_input_identify_async(&gba_link_multiboot_detect_contexts[port]); +} + +uint8_t gba_link_multiboot_progress(int port) +{ + assert((port >= 0) && (port < JOYPAD_PORT_COUNT)); + if (multiboot_contexts[port].state == GBA_MULTIBOOT_IDLE) { + return 0; + } + return (100 * multiboot_contexts[port].sent) / multiboot_contexts[port].length; +} + + +/** @} */ /* gba_link */ diff --git a/src/joybus/joybus_commands.h b/src/joybus/joybus_commands.h index 1057c26a29..c360684e99 100644 --- a/src/joybus/joybus_commands.h +++ b/src/joybus/joybus_commands.h @@ -172,11 +172,25 @@ typedef joybus_cmd_n64_accessory_read_port_t joybus_cmd_64gb_link_cable_read_por /** * @brief "GBA Link Cable Read" Joybus command structure. * - * Identical to the "N64 Accessory Read" command but with a different command ID. - * * @see #JOYBUS_COMMAND_ID_GBA_LINK_CABLE_READ */ -typedef joybus_cmd_n64_accessory_read_port_t joybus_cmd_gba_link_cable_read_port_t; +typedef struct __attribute__((packed)) joybus_cmd_gba_link_cable_read_port_s +{ + /** @brief "GBA Link Cable Read" command send data */ + struct __attribute__((packed)) + { + /** @brief Joybus command ID (#JOYBUS_COMMAND_ID_GBA_LINK_CABLE_READ) */ + uint8_t command; + } send; + /** @brief "GBA Link Cable Read" command receive data */ + struct __attribute__((packed)) + { + /** @brief 4-byte payload of data read from the GBA. */ + uint8_t data[JOYBUS_GBA_LINK_CABLE_DATA_SIZE]; + /** @brief GBA status (lower 8 bits of JOYSTAT register). */ + uint8_t status; + } recv; +} joybus_cmd_gba_link_cable_read_port_t; /** * @brief "N64 Accessory Write" Joybus command structure. @@ -216,11 +230,25 @@ typedef joybus_cmd_n64_accessory_write_port_t joybus_cmd_64gb_link_cable_write_p /** * @brief "GBA Link Cable Write" Joybus command structure. * - * Identical to the "N64 Accessory Write" command but with a different command ID. - * * @see #JOYBUS_COMMAND_ID_GBA_LINK_CABLE_WRITE */ -typedef joybus_cmd_n64_accessory_write_port_t joybus_cmd_gba_link_cable_write_port_t; +typedef struct __attribute__((packed)) joybus_cmd_gba_link_cable_write_port_s +{ + /** @brief "GBA Link Cable Write" command send data */ + struct __attribute__((packed)) + { + /** @brief Joybus command ID (#JOYBUS_COMMAND_ID_GBA_LINK_CABLE_WRITE) */ + uint8_t command; + /** @brief 4-byte payload of data to write to the GBA. */ + uint8_t data[JOYBUS_GBA_LINK_CABLE_DATA_SIZE]; + } send; + /** @brief "GBA Link Cable Write" command receive data */ + struct __attribute__((packed)) + { + /** @brief GBA status (lower 8 bits of JOYSTAT register). */ + uint8_t status; + } recv; +} joybus_cmd_gba_link_cable_write_port_t; /** * @brief "Identify" Joybus command structure. diff --git a/src/joybus/libdragon.mk b/src/joybus/libdragon.mk index 8b324114e4..b3208429e6 100644 --- a/src/joybus/libdragon.mk +++ b/src/joybus/libdragon.mk @@ -8,6 +8,8 @@ LIBDRAGON_OBJS += \ $(BUILD_DIR)/joybus/cpakfs_fsck.o \ $(BUILD_DIR)/joybus/eeprom.o \ $(BUILD_DIR)/joybus/eepromfs.o \ + $(BUILD_DIR)/joybus/gba_link.o \ + $(BUILD_DIR)/joybus/gba_link_multiboot.o \ $(BUILD_DIR)/joybus/joybus_accessory.o \ $(BUILD_DIR)/joybus/joybus_rtc.o \ $(BUILD_DIR)/joybus/joybus.o \