Installing Games: Difference between revisions

From Arduboy Wiki
Jump to navigation Jump to search
No edit summary
 
Line 1: Line 1:


The process for installing games on your Arduboy is dependant on the [[What is the Arduboy#Arduboy Variants|variant]] you have. Older Arduboys can only support a single game whereas new FX and Mini variants are equipped with a flash chip that allows it to store many games at once and these are made accessible by a menu when the unit is first turned on.
The process for installing games on your Arduboy is dependant on the [[What is the Arduboy#Arduboy Variants|variant]] you have. Older Arduboys can only support a single game whereas new FX and Mini variants are equipped with a flash chip that allows it to store many games at once and these are made accessible by a menu when the unit is first turned on.
== Distribution Methods ==
== Distribution Methods ==


Line 18: Line 16:


* as an <code>.arduboy</code> file. The <code>.arduboy</code> format is an archive file that contains the program's main <code>.hex</code> file, any supporting <code>.bin</code> files and graphics in a single package for convenience.  Refer to [[#Adding a new game to the Arduboy Cart|Adding a new game to the Arduboy Cart]] for installing an <code>.arduboy</code> file.
* as an <code>.arduboy</code> file. The <code>.arduboy</code> format is an archive file that contains the program's main <code>.hex</code> file, any supporting <code>.bin</code> files and graphics in a single package for convenience.  Refer to [[#Adding a new game to the Arduboy Cart|Adding a new game to the Arduboy Cart]] for installing an <code>.arduboy</code> file.
== Installing a Single Game ==
== Installing a Single Game ==


Line 48: Line 43:


Applies to the Arduboy FX, Arduboy Mini and homegrown variants that have an FX extension.
Applies to the Arduboy FX, Arduboy Mini and homegrown variants that have an FX extension.
The Arduboy cart is actively maintained by the community with recent updates being posted in the community forum post [https://community.arduboy.com/t/arduboy-fx-cart-builder/10395 Arduboy FX Cart Builder].


=== Updating the Arduboy Cart with the 'Full Enchilada' ===
=== Updating the Arduboy Cart with the 'Full Enchilada' ===
Updated carts can be flashed to the Arduboy a number of different ways:
* via the [https://www.bloggingadeadhorse.com/cart/Cart.html Cart Builder] website. Instructions can be found [[Flashing a Cart using Chrome / WebSerial|here]].
* using the [[Arduboy Toolset]]. Instructions can be found [[Flashing a Cart using the Arduboy Toolset|here]].
* using Mr.Blinky's Python Scripts. Instructions can be found [[Flashing a Cart using the Python Scripts|here]].


=== Adding a new game to the Arduboy Cart ===
=== Adding a new game to the Arduboy Cart ===

Latest revision as of 02:44, 22 June 2024

The process for installing games on your Arduboy is dependant on the variant you have. Older Arduboys can only support a single game whereas new FX and Mini variants are equipped with a flash chip that allows it to store many games at once and these are made accessible by a menu when the unit is first turned on.

Distribution Methods

Arduboy games can be distributed multiple ways and the method affects how it can be installed onto a physical unit.

Distribution methods include:

  • as a single .hex file and accompanied by one .bin files. The presence of the .bin file indicates that the game can only be used on an Arduboy FX, Arduboy Mini or a homegrown unit that has an FX chip and cannot be run on earlier variants. The .bin file maybe a 'development file' or a 'production file' and its important to know which type it is prior to attempting to upload it. Although not always the case, 'development files' will typically be named fxdata.bin and 'production files' will have a name similar to fxdata-data.bin. Refer to Installing a Single Game using the Arduboy Toolset for installing a game's .hex file and accompanying 'development file'. Refer to Adding a new game to the Arduboy Cart for installing a game's .hex file and accompanying 'production file'.
  • as a single .hex file and accompanied by two .bin files. The presence of the two .bin files indicate that the game can only be used on an Arduboy FX, Arduboy Mini or a homegrown unit that has an FX chip and cannot be run on earlier variants. Refer to Adding a new game to the Arduboy Cart for installing a game's .hex file and accompanying .bin files.
  • as an .arduboy file. The .arduboy format is an archive file that contains the program's main .hex file, any supporting .bin files and graphics in a single package for convenience. Refer to Adding a new game to the Arduboy Cart for installing an .arduboy file.

Installing a Single Game

Applies to all Arduboy variants.

There are many different ways to install a single game onto the Arduboy.

Installing a Single Game using the Arduino IDE

The Arduino IDE allows Arduboy programs to be compiled and uploaded to the unit automatically.

Detailed instructions can be found here.

Installing a Single Game using the VS Code IDE

The VS Code allows Arduboy programs to be compiled and uploaded to the unit automatically.

Detailed instructions can be found here.

Installing a Single Game using the Arduboy Toolset

The Arduboy Toolset provides a convenient, GUI based tool for uploading `.hex` files and (optionally) a single `'bin` file.

Detailed instructions can be found here.

Updating an Arduboy's Cart

Applies to the Arduboy FX, Arduboy Mini and homegrown variants that have an FX extension.

The Arduboy cart is actively maintained by the community with recent updates being posted in the community forum post Arduboy FX Cart Builder.

Updating the Arduboy Cart with the 'Full Enchilada'

Updated carts can be flashed to the Arduboy a number of different ways:

Adding a new game to the Arduboy Cart