Xbooxp is a multiboot transfer software originally designed with winXP/2000 in mind, but has since been updated to work in Linux/BSD/Solaris thanks to Jacques Pelletier.
The xboo cables were originally designed by Martin Korth, and they are cheap and easy to build. You can send multiboot images of up to 256kB, and upload speed is fast. This program can send a 256kB multiboot image in about 8.1 - 8.5 seconds. With the delay setting, its a little slower. It also supports BURST BOOT mode.
This is an old project from 2004. I uploaded this to Github and Google Code to get the code out there for hackers to play with it. I no longer support this project due to lack of functioning hardware, but maintenance PRs are still welcome.
Please refer to the xboo cable documentation for wiring information.
Modern PCs no longer have parallel ports (DB25), but you can still use a USB to DB25 converter and connect the GBA link cable to it directly. Here are the recommended parts purchase links:
- USB To DB25 (Female): https://www.aliexpress.com/item/1005005425690098.html
- GBA Link Connect Cable: https://www.aliexpress.com/item/1005006982954065.html
To build one, just cut the GBA link connect cable and wire it accordingly to your USB-DB25 adapter (refer to wiring info in the xboo cable documentation. You will only need to connect three wires, four if you want to use high speed BURST BOOT mode. You can still use BURST BOOT with only three wires, but transfer speeds will be a little slower.
BURST BOOT is a system designed by Martin Korth that allows you to send a multiboot image to replace the old image that you have transferred previously. So you will not need to keep resetting the GBA (turn off/on), saving time. To use this system:
- Add burst boot code in your program.
- Send your multiboot image.
- Once you are done checking it out, send your multiboot image again. Simple as that.
For Linux, just clone this git repo and type make, and the executable binary will be built. It works out of the box with the usual permission tweaks:
git clone https://github.com/vishnu350/xbooxp
cd xbooxp && make
For Windows, builds are no longer supported. The original builds were compiled using Borland C/C++ compilers (now outdated). However, since the source code is very portable, it may still build on modern Windows systems. The original binaries are still included in the legacy directory, and will require the use of io.dll (provided by geekhideout).
Here is what you should see upon running the xbooxp command:
./xbooxp yourfile.mb -argument
The arguments:
-h Use this to upload multiboot file without a valid
header. This does not affect or modify the file.
-d[value] To increase the delay value, use this. Example,
if you want to use delay=1, then type -d1.
Use this only if you are having problems.
-p[port] Set the port address here. If your port address
is 0x278, then type -p278. If no value specified
then 0x378 will be used as default.
-t Set for testing purposes. This will allow you to
send files without actually starting them.
To see the help screen, just type xbooxp, and you will see the above message (or similar).
Eg. to run xbooxp with parallel port address 0x278, delay 2, and you want to upload a multiboot file named matrix.mb without a valid header, do:
./xbooxp matrix.mb -278 -h -d2
xbooxp is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.
xbooxp is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with xbooxp. If not, see http://www.gnu.org/licenses/.
Thanks to:
- Jacques Pelletier, for updating this program to make it work in Linux.
- Alexander aka arundel, for all his help and support. His gbacopy.asm was of great help, but took a while to understand. He also helped with beta testing. Check out his gbacopy for Linux.
- Matt, for his C code for CRC routines.
- Martin Korth's extremely informative GBAtek document.
- Fred's io.dll from geekhideout.
