The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Device-GBA-0.004
River stage zero No dependents
1 ++
/ gba

NAME

gba - Command-line code uploader for the Gameboy Advance

VERSION

version 0.004

SYNOPSIS

    $ gba --verbose code.gba
    .....Opening GBA file readonly
    .....GBA file length 0x000003a0
    BusPirate(mstr) GBA(slave)
    Looking for GBA 0x72026202
    0x72026202 0x00006202  ; Found GBA
    0x72026202 0x00006102  ; Recognition OK
    0x00020000 0x00006200  ; Transfer of header data complete
    0x72026200 0x00006202  ; Exchange master/slave info again
    0x72026202 0x000063d1  ; Send palette data
    0x739163d1 0x000063d1  ; Send palette data, receive 0x73hh****
    0x739863d1 0x000064a0  ; Send handshake data
    0x736464a0 0x00000084  ; Send length info, receive seed 0x**cc****
    Upload: 100% [=========================================]D 0h00m14s
    Wait for GBA to respond with CRC 0x00750065
    0x00750065 0x00000066  ; GBA ready with CRC
    0x8caa0066 0x00008caa  ; Let's exchange CRC!
    CRC ...hope they match!
    MultiBoot done

INSTALLATION

    cpan Device::GBA

DESCRIPTION

The Nintendo Gameboy Advance can either boot from cartridge or over link cable. The latter is caled multiboot mode and is basically SPI and a homebrew encoding scheme. Unfortunately, the Bus Pirate doesn't have a 100k SPI mode, so we are using 125000 instead. If you encounter problems with booting, use the next lower speed (30000) as bitrate. This utility allows uploading multiboot GBA images with the BusPirate. Don't forget to pass -specs=gba_mb.specs to devkitARM GCC if you want to link a multiboot image. The package's share/ subdirectory contains an example Makefile for cross-compilation. The wiring is as follows:

    GBA     Bus Pirate
    SO  --> MISO
    SI  <-- MOSI
    CLK <-- CLK

Note: This is still work in progress!

OPTIONS

pirate / p

Buspirate COM port/device file

    $ gba -p <COM_port>

verbose / no-verbose

Toggle verbose output. Output is verbose by default

    $ gba --no-verbose

version / v

Shows the current version number

    $ gba --version

help / h

Shows a brief help message

    $ gba --help

GIT REPOSITORY

http://github.com/athreef/Device-GBA

SEE ALSO

Device::GBA powering this utility.

AUTHOR

Ahmad Fatoum <athreef@cpan.org>, http://a3f.at

COPYRIGHT AND LICENSE

Copyright (C) 2018 Ahmad Fatoum

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License v2.0 or later.