Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chrisdiana/arduboy-flashcart-loader
Single command index, build and upload for the Arduboy FX
https://github.com/chrisdiana/arduboy-flashcart-loader
arduboy arduboy-uploader
Last synced: about 1 month ago
JSON representation
Single command index, build and upload for the Arduboy FX
- Host: GitHub
- URL: https://github.com/chrisdiana/arduboy-flashcart-loader
- Owner: chrisdiana
- License: mit
- Created: 2021-04-05T14:45:12.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-18T15:35:25.000Z (7 months ago)
- Last Synced: 2024-08-04T08:07:50.462Z (5 months ago)
- Topics: arduboy, arduboy-uploader
- Language: Python
- Homepage:
- Size: 2.62 MB
- Stars: 6
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arduboy Flashcart Loader
Single command index, build and upload for the Arduboy FX. Utilities to make loading new game libraries onto the FX chip a little easier. Thanks to [Mr.Blinky](https://github.com/MrBlinky) for all the great work in putting together the [Arduboy Python Utilities](https://github.com/MrBlinky/Arduboy-Python-Utilities) that this package uses.
## Quick Start
1. Clone the repo
```
$ git clone --recursive [email protected]:chrisdiana/arduboy-flashcart-loader.git
```
2. Install dependencies
```
$ pip install -r requirements.txt
```
3. Setup your game library using the `example-flashcart` directory as a template. Follow the directory structure below:
```
- 01-Action
- - 01-Hopper.hex # game file
- - 01-Hopper.png # game screen file
- - 02-Lasers.hex
- - 02-Lasers.png
- 02-Adventure
- - 01-Arena.hex
- - 01-Arena.png
- Categories # category screens directory
- - 01-Action.png # category screen file
- - 02-Adventure.png # category screen file
- arduboy_loader.png # title screen
- flashcart-image.bin # flash cart image
- flashcart-index.csv # flash card index directory needed to build image
```
4. Connect your Arduboy FX and run the `all` command while passing the directory of your flashcart
```bash
$ ./run.sh all example-flashcart/
```
## Run commands standalone
Generate the flashcart index file
```
$ ./run.sh index example-flashcart/
OR
$ python src/generate_flashcart_bin.py example-flashcart/
```
Generate the flashcart image bin file
```
$ ./run.sh build example-flashcart/
OR
$ python Arduboy-Python-Utilities/flashcart-builder.py example-flashcart/flashcart-index.csv
```
Load the image onto the Arduboy
```
$ ./run.sh write example-flashcart/
OR
$ python Arduboy-Python-Utilities/flashcart-writer.py example-flashcart/flashcart-image.bin
```