Installing Games - Revision history

Filmote: /* Updating the Arduboy Cart with the 'Full Enchilada' */

2024-06-22T02:44:04Z

Updating the Arduboy Cart with the 'Full Enchilada'

← Older revision		Revision as of 02:44, 22 June 2024
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 ===

Filmote at 05:05, 16 June 2024

2024-06-16T05:05:42Z

← Older revision		Revision as of 05:05, 16 June 2024
Line 17:		Line 17:
	* as a single <code>.hex</code> file and accompanied by two <code>.bin</code> files. The presence of the two <code>.bin</code> 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 [[What is the Arduboy#Arduboy Variants\|variants]]. Refer to [[#Adding a new game to the Arduboy Cart\|Adding a new game to the Arduboy Cart]] for installing a game's <code>.hex</code> file and accompanying <code>.bin</code> files.		* as a single <code>.hex</code> file and accompanied by two <code>.bin</code> files. The presence of the two <code>.bin</code> 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 [[What is the Arduboy#Arduboy Variants\|variants]]. Refer to [[#Adding a new game to the Arduboy Cart\|Adding a new game to the Arduboy Cart]] for installing a game's <code>.hex</code> file and accompanying <code>.bin</code> files.

	* as an `.arduboy` file. The `.arduboy` 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.		* 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.

Filmote at 05:04, 16 June 2024

2024-06-16T05:04:26Z

← Older revision		Revision as of 05:04, 16 June 2024
Line 13:		Line 13:
	* as a single <code>.hex</code> file. This is a compiled version of the game and is ready to be uploaded to a physical unit immediately. Refer to [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for instructions.		* as a single <code>.hex</code> file. This is a compiled version of the game and is ready to be uploaded to a physical unit immediately. Refer to [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for instructions.

	* as a single <code>.hex</code> file and accompanied by one <code>.bin</code> files. The presence of the <code>.bin</code> 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 [[What is the Arduboy#Arduboy Variants\|variants]]. The <code>.bin</code> 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 <code>fxdata.bin</code> and 'production files' will have a name similar to <code>fxdata-data.bin</code>. Refer to [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for installing a game's <code>.hex</code> file and accompanying 'development file'. Refer to [[#Adding a new game to the Arduboy Cart\|Adding a new game to the Arduboy Cart]] for installing a game's <code>.hex</code> file and accompanying 'production file'.		* as a single <code>.hex</code> file and accompanied by one <code>.bin</code> files. The presence of the <code>.bin</code> 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 [[What is the Arduboy#Arduboy Variants\|variants]]. The <code>.bin</code> 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 <code>fxdata.bin</code> and 'production files' will have a name similar to <code>fxdata-data.bin</code>. Refer to [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for installing a game's <code>.hex</code> file and accompanying 'development file'. Refer to [[#Adding a new game to the Arduboy Cart\|Adding a new game to the Arduboy Cart]] for installing a game's <code>.hex</code> file and accompanying 'production file'.

	* as a single <code>.hex</code> file and accompanied by two <code>.bin</code> files. ~~These~~		* as a single <code>.hex</code> file and accompanied by two <code>.bin</code> files. The presence of the two <code>.bin</code> 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 [[What is the Arduboy#Arduboy Variants\|variants]]. Refer to [[#Adding a new game to the Arduboy Cart\|Adding a new game to the Arduboy Cart]] for installing a game's <code>.hex</code> file and accompanying <code>.bin</code> files.

	* as an `.arduboy` file. The `.arduboy` 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.		* as an `.arduboy` file. The `.arduboy` 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.

Filmote at 05:02, 16 June 2024

2024-06-16T05:02:38Z

← Older revision		Revision as of 05:02, 16 June 2024
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.

Filmote at 05:02, 16 June 2024

2024-06-16T05:02:20Z

← Older revision		Revision as of 05:02, 16 June 2024
Line 11:		Line 11:

	* as source code. Prior to installing the game, you will need to compile it within an Arduboy development environment - such as the Arduino IDE or VS Code - and then upload it to the unit. Refer to sections [[#Installing a Single Game using the Arduino IDE\| Installing a Single Game using the Arduino IDE]], [[#Installing a Single Game using the VS Code IDE\| Installing a Single Game using the VS Code IDE]] or [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for instructions.		* as source code. Prior to installing the game, you will need to compile it within an Arduboy development environment - such as the Arduino IDE or VS Code - and then upload it to the unit. Refer to sections [[#Installing a Single Game using the Arduino IDE\| Installing a Single Game using the Arduino IDE]], [[#Installing a Single Game using the VS Code IDE\| Installing a Single Game using the VS Code IDE]] or [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for instructions.

	* as a single <code>.hex</code> file. This is a compiled version of the game and is ready to be uploaded to a physical unit immediately. Refer to [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for instructions.		* as a single <code>.hex</code> file. This is a compiled version of the game and is ready to be uploaded to a physical unit immediately. Refer to [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for instructions.
	* as a single <code>.hex</code> file and accompanied by one or ~~more~~ <code>.bin</code> files.
			* as a single <code>.hex</code> file and accompanied by one <code>.bin</code> files. The presence of the <code>.bin</code> 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 [[What is the Arduboy#Arduboy Variants\|variants]]. The <code>.bin</code> 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 <code>fxdata.bin</code> and 'production files' will have a name similar to <code>fxdata-data.bin</code>. Refer to [[#Installing a Single Game using the Arduboy Toolset\|Installing a Single Game using the Arduboy Toolset]] for installing a game's <code>.hex</code> file and accompanying 'development file'. Refer to [[#Adding a new game to the Arduboy Cart\|Adding a new game to the Arduboy Cart]] for installing a game's <code>.hex</code> file and accompanying 'production file'.

			* as a single <code>.hex</code> file and accompanied by two <code>.bin</code> files. These

	* as an `.arduboy` file. The `.arduboy` 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.		* as an `.arduboy` file. The `.arduboy` 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.

Line 44:		Line 49:

	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.

			=== Updating the Arduboy Cart with the 'Full Enchilada' ===

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

Filmote at 04:46, 16 June 2024

2024-06-16T04:46:24Z

← Older revision		Revision as of 04:46, 16 June 2024
Line 19:		Line 19:
	== Installing a Single Game ==		== Installing a Single Game ==

	Applies to all Arduboy variants.		Applies to all Arduboy [[What is the Arduboy#Arduboy Variants\|variants]].

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

Filmote at 04:45, 16 June 2024

2024-06-16T04:45:27Z

← Older revision		Revision as of 04:45, 16 June 2024
Line 1:		Line 1:

	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.		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.

Filmote at 04:40, 16 June 2024

2024-06-16T04:40:58Z

← Older revision		Revision as of 04:40, 16 June 2024
Line 1:		Line 1:

	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.		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.

Filmote at 04:40, 16 June 2024

2024-06-16T04:40:46Z

← Older revision		Revision as of 04:40, 16 June 2024
Line 13:		Line 13:
	* as a single <code>.hex</code> file and accompanied by one or more <code>.bin</code> files.		* as a single <code>.hex</code> file and accompanied by one or more <code>.bin</code> files.
	* as an `.arduboy` file. The `.arduboy` 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.		* as an `.arduboy` file. The `.arduboy` 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.

Filmote at 04:40, 16 June 2024

2024-06-16T04:40:25Z

← Older revision		Revision as of 04:40, 16 June 2024
Line 24:		Line 24:

	The Arduino IDE allows Arduboy programs to be compiled and uploaded to the unit automatically.		The Arduino IDE allows Arduboy programs to be compiled and uploaded to the unit automatically.
	~~Compiling~~ a ~~game produces a <code>.hex</code> file and (optionally) one or more <code>.bin</code> files~~.
			Detailed instructions can be found [[Installing a Single Game using the Arduino IDE\|here]].

	=== Installing a Single Game using the VS Code IDE ===		=== Installing a Single Game using the VS Code IDE ===

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

			Detailed instructions can be found [[Installing a Single Game using the VS Code IDE\|here]].

	=== Installing a Single Game using the Arduboy Toolset ===		=== 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.		The Arduboy Toolset provides a convenient, GUI based tool for uploading `.hex` files and (optionally) a single `'bin` file.

			Detailed instructions can be found [[Installing a Single Game using the Arduboy Toolset\|here]].

	== Updating an Arduboy's Cart ==		== Updating an Arduboy's Cart ==

	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.