Foenix F256 / Wildbits/K2 Wiki - User contributions [en]

Software for 6502

2026-01-04T00:39:01Z

Draconian: /* Game Jam #04 - November-December 2025 */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it. For extra help on how to run .bin files and almost every possible scheme that has to be used to run program, you can consult this video that's also part of [[Getting Started]], this one: https://www.youtube.com/watch?v=0ShFv89KGDs

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

===== Curated SD card collection of games, demos, utilities =====
Here is a download link to a zip file meant to be extracted into the root of an SD card: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection

Best to wipe out your SD card and start anew with the contents of this extracted to root. Micah's file manager doesn't like long lists of files so it really is best to not overdo it. I tried to minimize the files in root, but I couldn't for everything.

Open the readme.txt file with moreorless to see some instructions about the collection. Best to run /- fm first, then open the readme.txt from it

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256 f/term
|Terminal emulator for F256K and Jr with classic (flat) memory load
|Micah
| - fterm.pgZ or use f/manager
|https://github.com/WartyMN/F256-terminal/blob/main/release/fterm.pgZ
|-
|FoenixTarot
|Tarot card readings in SuperBasic
|Mike
|basic
|https://github.com/mcassera/FoenixTarot/tree/main
|-
|Forthf256
|Forth implementation
|Vasyl
|pgz in its forth/ folder
|https://github.com/VasylTsv/ForthX16
|-
|WildBits Graphic Toolkit
|(fmr. F256-GraphicToolkit) Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit/releases
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|badapple
|A 80x60 textmode port of Bad Apple, uses the VS1053b for quality mp3 audio. Needs a Jr2 or K2!
|Mu0n
|pgz*
|*unzip badapple.zip into the root of your SD card. If done right, the 3 files within will be in the demos/ folder. The program expects its data file there when it runs. https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/badapple.zip
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256Archon
|Splash screen intro, plays MIDI using the SAM2695, requires a K2 or Jr2
|Mu0n
|pgz
|https://github.com/Mu0n/F256Archon/releases
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/xmas24_k2.pgz revised version that can run on wave 2 Jr2 and K2 as well
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|mariobros
|Tilemap and platformer test based on Mario Bros. (1983)
|beethead
|pgz
|https://github.com/noyen1973/mariobros
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|FusionDrive
|An outrun type game that also plays a MIDI soundtrack
|Mu0n
|pgz
|wip v0.2, can use a NES pad #1 to move around, or left/right arrow keys currently https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jewelkeeper
|Sokoban port
|beethead
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/jewelkeeper.pgz<nowiki/>You can now specify a level file when loading the game <code>/- jewelkeeper.pgz <levels.txt></code>. Find more levels at https://www.sourcecode.se/sokoban/levels.php. Keep in mind the maximum level dimension is 20x15, anything larger will be ignored
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://discord.com/channels/691915291721990194/1230670413361844244/1317256215566487593 1.0 Beta 19 Demo]
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Shanghai/Mahjongg
|A clone of Shanghai. Also known as Mahjongg
|mgr42
|pgz or KUP
mouse needed
|https://github.com/rmsk2/f256_mahjong
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|-
|Tetris
|Good old 80's game
|Daniel Tremblay (Grenouye)
|pgz
atari joystick or keyboard
|https://github.com/dtremblay/c256-tetris/tree/f256k
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|}

== Game Jam #02 - October 25th-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it. Optionally uses a MIDI in controller plugged in.
|https://github.com/Mu0n/F256KsimpleCdoodles/releases/download/v1.2/BachHero.pgz
|-
|f256_snake
|
|mgr42
|pgz. Use cursor keys, Atari joystick or SNES pad to play
|https://github.com/rmsk2/f256_snake
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Ultima_3
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}

== Game Jam #03 - April 18th-April 27th 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Arcade Shanghai v1.2
|Shanghai clone
|contrerasd
|basic, keep the .bas program in root, the rest in the provided ashanghai/ folder
|https://github.com/econtrerasd/ashanghai/releases
|-
|Bawk Bawk Cluck Cluck
|Chicken themed platformer
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamApr2025
|-
|BitLadder
|Shoot 'Em Up
|Mu0n
|pgz. For full sound compatibility, a Jr2 or K2 is needed.
Uses 4 sound chips! (PSG, SID, OPL3, MIDI)
|https://mu0n.itch.io/bitladder
|-
|F256_Commando
|Commando port
|SprySloth
|pgz
|https://github.com/cmassat/F256_Commando
|-
|F256_LodeRunner
|Lode Runner port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Loderunner/releases
|-
|Mahjong
|Shangai clone
|mgr42
|pgz
|https://github.com/rmsk2/f256_mahjong/releases
|-
|Quarth
|Block placement arcade game
|Grenouye
|pgz
|https://grenouye.itch.io/f256-quarth
|-
|Skee(ster)-Ball
|
|Mike
|pgz
|https://github.com/mcassera/skeeball256/tree/main
|}

== Game Jam #04 - November-December 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Fallitaire
|A cozy fall-themed twist on Pyramid Solitaire, built for the Foenix F256K2 Game Jam!
|Programmer Vs World
|bas
|https://programmervsworld.itch.io/fallitaire
|-
|H.E.R.O.
|Port of the classic game H.E.R.O.
|Cibee
|pgz
|https://c1bee.itch.io/hero
|-
|Leaderboard
|Golf game
|xDraconian
|pgz
|https://discord.com/channels/691915291721990194/1424187774642290799/1456104940186501132
|-
|Pitfall
|Port of the classic Pitfall game from Activision
|MinstrelDragon
|pgz
|https://minstrel.itch.io/pitfall-foenix-f256x
|-
|Return of the Falcon
|
|Callisto
|TBD
|
|-
|Swicheroo
|An Alternate Puzzle Game
|jbaker8935
|pgz
|https://jbaker8935.itch.io/switcheroo
|-
|Track Day
|v1.0 top down race game vs computer controlled opponents
|MikeC
|pgz
|https://mcassera.itch.io/track-day-racing
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cozyMIDI
|Plays a SMF with the SAM2695 or VS1053b
|Mu0n
|pgz
|cozyMIDI v2.4 can open and play type 0 and type 1 standard MIDI files (SMF)
needs a Jr2 or K2
with a 2x core at https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos

run operation 1: just as itself, it will force you to pick a midi file in the 'midi/' folder /- cozymidi

run operation 2: in f/manager, if you put this as <code>midiplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .mid files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/cozymidi.pgz
|-
|digestMidi
|converts .mid to .dim
|Mu0n
|pgz
|.mid files are slow to load, parse and prepare for a playback. This tool comes in to convert them into a .dim format that strips out unnecessary MIDI commands and sets it up for timer0 time delays. Works with type 0 and type 1 standard midi files. This tools does the conversion and lets you hear the result.
Find the latest version here: https://github.com/Mu0n/F256MiscGoodies/tree/main/apps
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|F256amp
|mp3, ogg, wav, wma file playback
|Mu0n
|pgz
|(aka audioplayer.pgz) v2.3 Needs a Jr.2 or K2 since it uses the VS1053b chip.
For a starter collection of .mp3 and other audio files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick an audio file. it expects a <code>media/mp3/</code> folder, but it can live without it and peek into the root instead.

run operation 2: with an argument, it will auto-play it: /- f256amp yourmp3file.mp3

run operation 3: in f/manager, if you put this as <code>audioplayer.pgz</code> in the '_apps/' folder. This lets f/manager automatically open up .mp3, .wav, .ogg, .wma that you press enter on.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/f256amp.pgz
|-
|FireJam
|all chips, music playing with MIDI in
|Mu0n
|pgz
|v1.2 MIDI in and out capable, it will still partially work with a Jr. (PSG, and SID if you have them), a K (PSG, SID, OPL3) and the newest wave 2 Jr2 and K2 (PSG, SID, OPL3, SAM, VS1053b).
Best to use with a MIDI in controller, but it'll be controllable with arrows and space to make notes individually, or the F keys to start beats. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jrtracker
|Tracker based in basic and uses the PSG
(considered obsolete, use tracker2)
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|Musik
|Music piece demo using MIDI
|Mike
|pgz
|https://github.com/mcassera/Musik/blob/main/Musik.PGZ<nowiki/>Musikalisches Würfelspiel
Requires a Jr2 or K2 since it uses MIDI
|-
|opl3snooper
|playback of VGM files (that use opl2 and opl3) and MIDI in
|Mu0n
|pgz
|v1.0 mainly plays back vgm files, but you can pause it and snoop around the channel instruments and play up to 18 note polyphony with MIDI in. expects a collection in media/vgm/, or it will browse from the root if it can't find.
It can load a .spl (Simple PLaylist) text file, which is one file per line, including their respective paths.
Requires a Jr2 or K2 with a 2x core to use the extra bank of SRAM.
For a starter collection of .vgm files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick a midi file in the 'media/vgm/' folder

run operation 2: in f/manager (v1.1b9 and up), if you put this as <code>vgmplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .vgm files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3snooper.pgz
|-
|opl3tweak
|uses MIDI in, plays 18 channels polyphony in real time to the YMF262 OPL3. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3tweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload''''' '''''"yourmusicfile", $01000'''''
followed by running this program with '''''/- playvgm.pgx'''''
|-
|sidtweak
|uses MIDI in, plays 6 channels polyphony in real time to the dual SID. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sidtweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|rawsidplayer
|plays raw PSID files from the HVSC collection, converted by zigreSID
|Mu0n
|pgz
|(formely psidplayer) v0.2 find rawsidplayer.pgz and a starter .rsd file (raw sid dumps). For a starter collection of .rsd files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
extract sid.zip into a folder /sid/ in the root of your SD card, that's where psidplayer.pgz will first look to let you pick a file. failing that, it will fall back to the root folder and let you navigate.

program link:

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/rawsidplayer.pgz
|-
|tracker2 v1.5
|Like jrtracker.bas, but using both PSGs
|contrerasd
|basic
|https://github.com/econtrerasd/Tracker2/releases
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz/flash
|https://github.com/rmsk2/f256_dcopy
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|f256_reset
|A small utility that lets you reset the machine through this piece of flash software
|mgr42
|flash
|https://github.com/rmsk2/f256_reset
|
|-
|fcart
|A program that allows to write data to flash expansion cartridges
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/cartflash
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|flashselect
|Allows to select a program to start from a flash cartridge via a menu
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/flashselect
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|midiStuff
|Test program for a F256K2 or F256Jr2 that sends MIDI data to the internal sam2695 dream chip that produces MIDI based audio. Also test a keyboard controller plugged in the MIDI in port.
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/blob/main/README.md#midistuff
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|-
|pgz2flash
|A program for your Linux, Windows or MacOS machine to turn any PGZ or SuperBASIC program into a KUP which can be run from cartridge or onboard flash memory
|mgr42
|Executable for modern computers
|https://github.com/rmsk2/pgz2flash
|
|-
|sidTester
|Simple superbasic program that tests out all 3 voices of the SID1 on the Jr (if populated), K, Jr2 and K2. Ported by Mu0n, made by andy on HackJunk.com https://hackjunk.com/2017/11/07/commodore-64-sid-tester/
|andy
|basic
|https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/sidtester.bas
|
|-
|testsuite.bas
|a series of tests for your F256, video modes and sound chips
|econtrerasd
|basic
|run from the root, https://raw.githubusercontent.com/Mu0n/F256MiscGoodies/refs/heads/main/apps/testsuite.bas
|
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active. Works with the K and Jr. ESP32 Feather 'huzzah' board. Not meant to be used with the K2 and Jr2 Wiznet chip.
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|Raúl SQ basic repo
|F256 SuperBASIC Trigonometry
|Raúl SQ
|basic
|https://github.com/raul-sq/FoenixF256K2
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|}

Software for 6502

2026-01-04T00:34:52Z

Draconian: /* Game Jam #04 - November-December 2025 */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it. For extra help on how to run .bin files and almost every possible scheme that has to be used to run program, you can consult this video that's also part of [[Getting Started]], this one: https://www.youtube.com/watch?v=0ShFv89KGDs

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

===== Curated SD card collection of games, demos, utilities =====
Here is a download link to a zip file meant to be extracted into the root of an SD card: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection

Best to wipe out your SD card and start anew with the contents of this extracted to root. Micah's file manager doesn't like long lists of files so it really is best to not overdo it. I tried to minimize the files in root, but I couldn't for everything.

Open the readme.txt file with moreorless to see some instructions about the collection. Best to run /- fm first, then open the readme.txt from it

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256 f/term
|Terminal emulator for F256K and Jr with classic (flat) memory load
|Micah
| - fterm.pgZ or use f/manager
|https://github.com/WartyMN/F256-terminal/blob/main/release/fterm.pgZ
|-
|FoenixTarot
|Tarot card readings in SuperBasic
|Mike
|basic
|https://github.com/mcassera/FoenixTarot/tree/main
|-
|Forthf256
|Forth implementation
|Vasyl
|pgz in its forth/ folder
|https://github.com/VasylTsv/ForthX16
|-
|WildBits Graphic Toolkit
|(fmr. F256-GraphicToolkit) Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit/releases
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|badapple
|A 80x60 textmode port of Bad Apple, uses the VS1053b for quality mp3 audio. Needs a Jr2 or K2!
|Mu0n
|pgz*
|*unzip badapple.zip into the root of your SD card. If done right, the 3 files within will be in the demos/ folder. The program expects its data file there when it runs. https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/badapple.zip
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256Archon
|Splash screen intro, plays MIDI using the SAM2695, requires a K2 or Jr2
|Mu0n
|pgz
|https://github.com/Mu0n/F256Archon/releases
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/xmas24_k2.pgz revised version that can run on wave 2 Jr2 and K2 as well
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|mariobros
|Tilemap and platformer test based on Mario Bros. (1983)
|beethead
|pgz
|https://github.com/noyen1973/mariobros
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|FusionDrive
|An outrun type game that also plays a MIDI soundtrack
|Mu0n
|pgz
|wip v0.2, can use a NES pad #1 to move around, or left/right arrow keys currently https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jewelkeeper
|Sokoban port
|beethead
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/jewelkeeper.pgz<nowiki/>You can now specify a level file when loading the game <code>/- jewelkeeper.pgz <levels.txt></code>. Find more levels at https://www.sourcecode.se/sokoban/levels.php. Keep in mind the maximum level dimension is 20x15, anything larger will be ignored
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://discord.com/channels/691915291721990194/1230670413361844244/1317256215566487593 1.0 Beta 19 Demo]
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Shanghai/Mahjongg
|A clone of Shanghai. Also known as Mahjongg
|mgr42
|pgz or KUP
mouse needed
|https://github.com/rmsk2/f256_mahjong
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|-
|Tetris
|Good old 80's game
|Daniel Tremblay (Grenouye)
|pgz
atari joystick or keyboard
|https://github.com/dtremblay/c256-tetris/tree/f256k
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|}

== Game Jam #02 - October 25th-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it. Optionally uses a MIDI in controller plugged in.
|https://github.com/Mu0n/F256KsimpleCdoodles/releases/download/v1.2/BachHero.pgz
|-
|f256_snake
|
|mgr42
|pgz. Use cursor keys, Atari joystick or SNES pad to play
|https://github.com/rmsk2/f256_snake
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Ultima_3
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}

== Game Jam #03 - April 18th-April 27th 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Arcade Shanghai v1.2
|Shanghai clone
|contrerasd
|basic, keep the .bas program in root, the rest in the provided ashanghai/ folder
|https://github.com/econtrerasd/ashanghai/releases
|-
|Bawk Bawk Cluck Cluck
|Chicken themed platformer
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamApr2025
|-
|BitLadder
|Shoot 'Em Up
|Mu0n
|pgz. For full sound compatibility, a Jr2 or K2 is needed.
Uses 4 sound chips! (PSG, SID, OPL3, MIDI)
|https://mu0n.itch.io/bitladder
|-
|F256_Commando
|Commando port
|SprySloth
|pgz
|https://github.com/cmassat/F256_Commando
|-
|F256_LodeRunner
|Lode Runner port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Loderunner/releases
|-
|Mahjong
|Shangai clone
|mgr42
|pgz
|https://github.com/rmsk2/f256_mahjong/releases
|-
|Quarth
|Block placement arcade game
|Grenouye
|pgz
|https://grenouye.itch.io/f256-quarth
|-
|Skee(ster)-Ball
|
|Mike
|pgz
|https://github.com/mcassera/skeeball256/tree/main
|}

== Game Jam #04 - November-December 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Fallitaire
|A cozy fall-themed twist on Pyramid Solitaire, built for the Foenix F256K2 Game Jam!
|Programmer Vs World
|bas
|https://programmervsworld.itch.io/fallitaire
|-
|H.E.R.O.
|Port of the classic game H.E.R.O.
|Cibee
|pgz
|https://c1bee.itch.io/hero
|-
|Leaderboard
|Golf game
|xDraconian
|pgz
|https://discord.com/channels/691915291721990194/1424187774642290799/1456104940186501132
|-
|Pitfall
|Port of the classic Pitfall game from Activision
|MinstrelDragon
|pgz
|https://minstrel.itch.io/pitfall-foenix-f256x
|-
|Swicheroo
|An Alternate Puzzle Game
|jbaker8935
|pgz
|https://jbaker8935.itch.io/switcheroo
|-
|Track Day
|v1.0 top down race game vs computer controlled opponents
|MikeC
|pgz
|https://mcassera.itch.io/track-day-racing
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cozyMIDI
|Plays a SMF with the SAM2695 or VS1053b
|Mu0n
|pgz
|cozyMIDI v2.4 can open and play type 0 and type 1 standard MIDI files (SMF)
needs a Jr2 or K2
with a 2x core at https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos

run operation 1: just as itself, it will force you to pick a midi file in the 'midi/' folder /- cozymidi

run operation 2: in f/manager, if you put this as <code>midiplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .mid files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/cozymidi.pgz
|-
|digestMidi
|converts .mid to .dim
|Mu0n
|pgz
|.mid files are slow to load, parse and prepare for a playback. This tool comes in to convert them into a .dim format that strips out unnecessary MIDI commands and sets it up for timer0 time delays. Works with type 0 and type 1 standard midi files. This tools does the conversion and lets you hear the result.
Find the latest version here: https://github.com/Mu0n/F256MiscGoodies/tree/main/apps
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|F256amp
|mp3, ogg, wav, wma file playback
|Mu0n
|pgz
|(aka audioplayer.pgz) v2.3 Needs a Jr.2 or K2 since it uses the VS1053b chip.
For a starter collection of .mp3 and other audio files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick an audio file. it expects a <code>media/mp3/</code> folder, but it can live without it and peek into the root instead.

run operation 2: with an argument, it will auto-play it: /- f256amp yourmp3file.mp3

run operation 3: in f/manager, if you put this as <code>audioplayer.pgz</code> in the '_apps/' folder. This lets f/manager automatically open up .mp3, .wav, .ogg, .wma that you press enter on.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/f256amp.pgz
|-
|FireJam
|all chips, music playing with MIDI in
|Mu0n
|pgz
|v1.2 MIDI in and out capable, it will still partially work with a Jr. (PSG, and SID if you have them), a K (PSG, SID, OPL3) and the newest wave 2 Jr2 and K2 (PSG, SID, OPL3, SAM, VS1053b).
Best to use with a MIDI in controller, but it'll be controllable with arrows and space to make notes individually, or the F keys to start beats. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jrtracker
|Tracker based in basic and uses the PSG
(considered obsolete, use tracker2)
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|Musik
|Music piece demo using MIDI
|Mike
|pgz
|https://github.com/mcassera/Musik/blob/main/Musik.PGZ<nowiki/>Musikalisches Würfelspiel
Requires a Jr2 or K2 since it uses MIDI
|-
|opl3snooper
|playback of VGM files (that use opl2 and opl3) and MIDI in
|Mu0n
|pgz
|v1.0 mainly plays back vgm files, but you can pause it and snoop around the channel instruments and play up to 18 note polyphony with MIDI in. expects a collection in media/vgm/, or it will browse from the root if it can't find.
It can load a .spl (Simple PLaylist) text file, which is one file per line, including their respective paths.
Requires a Jr2 or K2 with a 2x core to use the extra bank of SRAM.
For a starter collection of .vgm files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick a midi file in the 'media/vgm/' folder

run operation 2: in f/manager (v1.1b9 and up), if you put this as <code>vgmplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .vgm files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3snooper.pgz
|-
|opl3tweak
|uses MIDI in, plays 18 channels polyphony in real time to the YMF262 OPL3. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3tweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload''''' '''''"yourmusicfile", $01000'''''
followed by running this program with '''''/- playvgm.pgx'''''
|-
|sidtweak
|uses MIDI in, plays 6 channels polyphony in real time to the dual SID. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sidtweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|rawsidplayer
|plays raw PSID files from the HVSC collection, converted by zigreSID
|Mu0n
|pgz
|(formely psidplayer) v0.2 find rawsidplayer.pgz and a starter .rsd file (raw sid dumps). For a starter collection of .rsd files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
extract sid.zip into a folder /sid/ in the root of your SD card, that's where psidplayer.pgz will first look to let you pick a file. failing that, it will fall back to the root folder and let you navigate.

program link:

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/rawsidplayer.pgz
|-
|tracker2 v1.5
|Like jrtracker.bas, but using both PSGs
|contrerasd
|basic
|https://github.com/econtrerasd/Tracker2/releases
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz/flash
|https://github.com/rmsk2/f256_dcopy
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|f256_reset
|A small utility that lets you reset the machine through this piece of flash software
|mgr42
|flash
|https://github.com/rmsk2/f256_reset
|
|-
|fcart
|A program that allows to write data to flash expansion cartridges
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/cartflash
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|flashselect
|Allows to select a program to start from a flash cartridge via a menu
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/flashselect
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|midiStuff
|Test program for a F256K2 or F256Jr2 that sends MIDI data to the internal sam2695 dream chip that produces MIDI based audio. Also test a keyboard controller plugged in the MIDI in port.
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/blob/main/README.md#midistuff
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|-
|pgz2flash
|A program for your Linux, Windows or MacOS machine to turn any PGZ or SuperBASIC program into a KUP which can be run from cartridge or onboard flash memory
|mgr42
|Executable for modern computers
|https://github.com/rmsk2/pgz2flash
|
|-
|sidTester
|Simple superbasic program that tests out all 3 voices of the SID1 on the Jr (if populated), K, Jr2 and K2. Ported by Mu0n, made by andy on HackJunk.com https://hackjunk.com/2017/11/07/commodore-64-sid-tester/
|andy
|basic
|https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/sidtester.bas
|
|-
|testsuite.bas
|a series of tests for your F256, video modes and sound chips
|econtrerasd
|basic
|run from the root, https://raw.githubusercontent.com/Mu0n/F256MiscGoodies/refs/heads/main/apps/testsuite.bas
|
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active. Works with the K and Jr. ESP32 Feather 'huzzah' board. Not meant to be used with the K2 and Jr2 Wiznet chip.
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|Raúl SQ basic repo
|F256 SuperBASIC Trigonometry
|Raúl SQ
|basic
|https://github.com/raul-sq/FoenixF256K2
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|}

Software for 6502

2026-01-04T00:30:29Z

Draconian: /* Game Jam #04 - November-December 2025 */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it. For extra help on how to run .bin files and almost every possible scheme that has to be used to run program, you can consult this video that's also part of [[Getting Started]], this one: https://www.youtube.com/watch?v=0ShFv89KGDs

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

===== Curated SD card collection of games, demos, utilities =====
Here is a download link to a zip file meant to be extracted into the root of an SD card: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection

Best to wipe out your SD card and start anew with the contents of this extracted to root. Micah's file manager doesn't like long lists of files so it really is best to not overdo it. I tried to minimize the files in root, but I couldn't for everything.

Open the readme.txt file with moreorless to see some instructions about the collection. Best to run /- fm first, then open the readme.txt from it

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256 f/term
|Terminal emulator for F256K and Jr with classic (flat) memory load
|Micah
| - fterm.pgZ or use f/manager
|https://github.com/WartyMN/F256-terminal/blob/main/release/fterm.pgZ
|-
|FoenixTarot
|Tarot card readings in SuperBasic
|Mike
|basic
|https://github.com/mcassera/FoenixTarot/tree/main
|-
|Forthf256
|Forth implementation
|Vasyl
|pgz in its forth/ folder
|https://github.com/VasylTsv/ForthX16
|-
|WildBits Graphic Toolkit
|(fmr. F256-GraphicToolkit) Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit/releases
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|badapple
|A 80x60 textmode port of Bad Apple, uses the VS1053b for quality mp3 audio. Needs a Jr2 or K2!
|Mu0n
|pgz*
|*unzip badapple.zip into the root of your SD card. If done right, the 3 files within will be in the demos/ folder. The program expects its data file there when it runs. https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/badapple.zip
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256Archon
|Splash screen intro, plays MIDI using the SAM2695, requires a K2 or Jr2
|Mu0n
|pgz
|https://github.com/Mu0n/F256Archon/releases
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/xmas24_k2.pgz revised version that can run on wave 2 Jr2 and K2 as well
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|mariobros
|Tilemap and platformer test based on Mario Bros. (1983)
|beethead
|pgz
|https://github.com/noyen1973/mariobros
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|FusionDrive
|An outrun type game that also plays a MIDI soundtrack
|Mu0n
|pgz
|wip v0.2, can use a NES pad #1 to move around, or left/right arrow keys currently https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jewelkeeper
|Sokoban port
|beethead
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/jewelkeeper.pgz<nowiki/>You can now specify a level file when loading the game <code>/- jewelkeeper.pgz <levels.txt></code>. Find more levels at https://www.sourcecode.se/sokoban/levels.php. Keep in mind the maximum level dimension is 20x15, anything larger will be ignored
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://discord.com/channels/691915291721990194/1230670413361844244/1317256215566487593 1.0 Beta 19 Demo]
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Shanghai/Mahjongg
|A clone of Shanghai. Also known as Mahjongg
|mgr42
|pgz or KUP
mouse needed
|https://github.com/rmsk2/f256_mahjong
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|-
|Tetris
|Good old 80's game
|Daniel Tremblay (Grenouye)
|pgz
atari joystick or keyboard
|https://github.com/dtremblay/c256-tetris/tree/f256k
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|}

== Game Jam #02 - October 25th-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it. Optionally uses a MIDI in controller plugged in.
|https://github.com/Mu0n/F256KsimpleCdoodles/releases/download/v1.2/BachHero.pgz
|-
|f256_snake
|
|mgr42
|pgz. Use cursor keys, Atari joystick or SNES pad to play
|https://github.com/rmsk2/f256_snake
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Ultima_3
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}

== Game Jam #03 - April 18th-April 27th 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Arcade Shanghai v1.2
|Shanghai clone
|contrerasd
|basic, keep the .bas program in root, the rest in the provided ashanghai/ folder
|https://github.com/econtrerasd/ashanghai/releases
|-
|Bawk Bawk Cluck Cluck
|Chicken themed platformer
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamApr2025
|-
|BitLadder
|Shoot 'Em Up
|Mu0n
|pgz. For full sound compatibility, a Jr2 or K2 is needed.
Uses 4 sound chips! (PSG, SID, OPL3, MIDI)
|https://mu0n.itch.io/bitladder
|-
|F256_Commando
|Commando port
|SprySloth
|pgz
|https://github.com/cmassat/F256_Commando
|-
|F256_LodeRunner
|Lode Runner port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Loderunner/releases
|-
|Mahjong
|Shangai clone
|mgr42
|pgz
|https://github.com/rmsk2/f256_mahjong/releases
|-
|Quarth
|Block placement arcade game
|Grenouye
|pgz
|https://grenouye.itch.io/f256-quarth
|-
|Skee(ster)-Ball
|
|Mike
|pgz
|https://github.com/mcassera/skeeball256/tree/main
|}

== Game Jam #04 - November-December 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|H.E.R.O.
|Port of the classic game H.E.R.O.
|Cibee
|pgz
|https://c1bee.itch.io/hero
|-
|Leaderboard
|Golf game
|xDraconian
|pgz
|https://discord.com/channels/691915291721990194/1424187774642290799/1456104940186501132
|-
|Pitfall
|Port of the classic Pitfall game from Activision
|MinstrelDragon
|pgz
|https://minstrel.itch.io/pitfall-foenix-f256x
|-
|Track Day
|v1.0 top down race game vs computer controlled opponents
|MikeC
|pgz
|https://mcassera.itch.io/track-day-racing
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cozyMIDI
|Plays a SMF with the SAM2695 or VS1053b
|Mu0n
|pgz
|cozyMIDI v2.4 can open and play type 0 and type 1 standard MIDI files (SMF)
needs a Jr2 or K2
with a 2x core at https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos

run operation 1: just as itself, it will force you to pick a midi file in the 'midi/' folder /- cozymidi

run operation 2: in f/manager, if you put this as <code>midiplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .mid files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/cozymidi.pgz
|-
|digestMidi
|converts .mid to .dim
|Mu0n
|pgz
|.mid files are slow to load, parse and prepare for a playback. This tool comes in to convert them into a .dim format that strips out unnecessary MIDI commands and sets it up for timer0 time delays. Works with type 0 and type 1 standard midi files. This tools does the conversion and lets you hear the result.
Find the latest version here: https://github.com/Mu0n/F256MiscGoodies/tree/main/apps
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|F256amp
|mp3, ogg, wav, wma file playback
|Mu0n
|pgz
|(aka audioplayer.pgz) v2.3 Needs a Jr.2 or K2 since it uses the VS1053b chip.
For a starter collection of .mp3 and other audio files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick an audio file. it expects a <code>media/mp3/</code> folder, but it can live without it and peek into the root instead.

run operation 2: with an argument, it will auto-play it: /- f256amp yourmp3file.mp3

run operation 3: in f/manager, if you put this as <code>audioplayer.pgz</code> in the '_apps/' folder. This lets f/manager automatically open up .mp3, .wav, .ogg, .wma that you press enter on.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/f256amp.pgz
|-
|FireJam
|all chips, music playing with MIDI in
|Mu0n
|pgz
|v1.2 MIDI in and out capable, it will still partially work with a Jr. (PSG, and SID if you have them), a K (PSG, SID, OPL3) and the newest wave 2 Jr2 and K2 (PSG, SID, OPL3, SAM, VS1053b).
Best to use with a MIDI in controller, but it'll be controllable with arrows and space to make notes individually, or the F keys to start beats. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jrtracker
|Tracker based in basic and uses the PSG
(considered obsolete, use tracker2)
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|Musik
|Music piece demo using MIDI
|Mike
|pgz
|https://github.com/mcassera/Musik/blob/main/Musik.PGZ<nowiki/>Musikalisches Würfelspiel
Requires a Jr2 or K2 since it uses MIDI
|-
|opl3snooper
|playback of VGM files (that use opl2 and opl3) and MIDI in
|Mu0n
|pgz
|v1.0 mainly plays back vgm files, but you can pause it and snoop around the channel instruments and play up to 18 note polyphony with MIDI in. expects a collection in media/vgm/, or it will browse from the root if it can't find.
It can load a .spl (Simple PLaylist) text file, which is one file per line, including their respective paths.
Requires a Jr2 or K2 with a 2x core to use the extra bank of SRAM.
For a starter collection of .vgm files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick a midi file in the 'media/vgm/' folder

run operation 2: in f/manager (v1.1b9 and up), if you put this as <code>vgmplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .vgm files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3snooper.pgz
|-
|opl3tweak
|uses MIDI in, plays 18 channels polyphony in real time to the YMF262 OPL3. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3tweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload''''' '''''"yourmusicfile", $01000'''''
followed by running this program with '''''/- playvgm.pgx'''''
|-
|sidtweak
|uses MIDI in, plays 6 channels polyphony in real time to the dual SID. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sidtweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|rawsidplayer
|plays raw PSID files from the HVSC collection, converted by zigreSID
|Mu0n
|pgz
|(formely psidplayer) v0.2 find rawsidplayer.pgz and a starter .rsd file (raw sid dumps). For a starter collection of .rsd files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
extract sid.zip into a folder /sid/ in the root of your SD card, that's where psidplayer.pgz will first look to let you pick a file. failing that, it will fall back to the root folder and let you navigate.

program link:

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/rawsidplayer.pgz
|-
|tracker2 v1.5
|Like jrtracker.bas, but using both PSGs
|contrerasd
|basic
|https://github.com/econtrerasd/Tracker2/releases
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz/flash
|https://github.com/rmsk2/f256_dcopy
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|f256_reset
|A small utility that lets you reset the machine through this piece of flash software
|mgr42
|flash
|https://github.com/rmsk2/f256_reset
|
|-
|fcart
|A program that allows to write data to flash expansion cartridges
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/cartflash
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|flashselect
|Allows to select a program to start from a flash cartridge via a menu
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/flashselect
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|midiStuff
|Test program for a F256K2 or F256Jr2 that sends MIDI data to the internal sam2695 dream chip that produces MIDI based audio. Also test a keyboard controller plugged in the MIDI in port.
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/blob/main/README.md#midistuff
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|-
|pgz2flash
|A program for your Linux, Windows or MacOS machine to turn any PGZ or SuperBASIC program into a KUP which can be run from cartridge or onboard flash memory
|mgr42
|Executable for modern computers
|https://github.com/rmsk2/pgz2flash
|
|-
|sidTester
|Simple superbasic program that tests out all 3 voices of the SID1 on the Jr (if populated), K, Jr2 and K2. Ported by Mu0n, made by andy on HackJunk.com https://hackjunk.com/2017/11/07/commodore-64-sid-tester/
|andy
|basic
|https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/sidtester.bas
|
|-
|testsuite.bas
|a series of tests for your F256, video modes and sound chips
|econtrerasd
|basic
|run from the root, https://raw.githubusercontent.com/Mu0n/F256MiscGoodies/refs/heads/main/apps/testsuite.bas
|
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active. Works with the K and Jr. ESP32 Feather 'huzzah' board. Not meant to be used with the K2 and Jr2 Wiznet chip.
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|Raúl SQ basic repo
|F256 SuperBASIC Trigonometry
|Raúl SQ
|basic
|https://github.com/raul-sq/FoenixF256K2
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|}

Software for 6502

2026-01-04T00:29:01Z

Draconian: /* Game Jam #04 - November-December 2025 */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it. For extra help on how to run .bin files and almost every possible scheme that has to be used to run program, you can consult this video that's also part of [[Getting Started]], this one: https://www.youtube.com/watch?v=0ShFv89KGDs

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

===== Curated SD card collection of games, demos, utilities =====
Here is a download link to a zip file meant to be extracted into the root of an SD card: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection

Best to wipe out your SD card and start anew with the contents of this extracted to root. Micah's file manager doesn't like long lists of files so it really is best to not overdo it. I tried to minimize the files in root, but I couldn't for everything.

Open the readme.txt file with moreorless to see some instructions about the collection. Best to run /- fm first, then open the readme.txt from it

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256 f/term
|Terminal emulator for F256K and Jr with classic (flat) memory load
|Micah
| - fterm.pgZ or use f/manager
|https://github.com/WartyMN/F256-terminal/blob/main/release/fterm.pgZ
|-
|FoenixTarot
|Tarot card readings in SuperBasic
|Mike
|basic
|https://github.com/mcassera/FoenixTarot/tree/main
|-
|Forthf256
|Forth implementation
|Vasyl
|pgz in its forth/ folder
|https://github.com/VasylTsv/ForthX16
|-
|WildBits Graphic Toolkit
|(fmr. F256-GraphicToolkit) Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit/releases
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|badapple
|A 80x60 textmode port of Bad Apple, uses the VS1053b for quality mp3 audio. Needs a Jr2 or K2!
|Mu0n
|pgz*
|*unzip badapple.zip into the root of your SD card. If done right, the 3 files within will be in the demos/ folder. The program expects its data file there when it runs. https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/badapple.zip
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256Archon
|Splash screen intro, plays MIDI using the SAM2695, requires a K2 or Jr2
|Mu0n
|pgz
|https://github.com/Mu0n/F256Archon/releases
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/xmas24_k2.pgz revised version that can run on wave 2 Jr2 and K2 as well
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|mariobros
|Tilemap and platformer test based on Mario Bros. (1983)
|beethead
|pgz
|https://github.com/noyen1973/mariobros
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|FusionDrive
|An outrun type game that also plays a MIDI soundtrack
|Mu0n
|pgz
|wip v0.2, can use a NES pad #1 to move around, or left/right arrow keys currently https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jewelkeeper
|Sokoban port
|beethead
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/jewelkeeper.pgz<nowiki/>You can now specify a level file when loading the game <code>/- jewelkeeper.pgz <levels.txt></code>. Find more levels at https://www.sourcecode.se/sokoban/levels.php. Keep in mind the maximum level dimension is 20x15, anything larger will be ignored
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://discord.com/channels/691915291721990194/1230670413361844244/1317256215566487593 1.0 Beta 19 Demo]
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Shanghai/Mahjongg
|A clone of Shanghai. Also known as Mahjongg
|mgr42
|pgz or KUP
mouse needed
|https://github.com/rmsk2/f256_mahjong
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|-
|Tetris
|Good old 80's game
|Daniel Tremblay (Grenouye)
|pgz
atari joystick or keyboard
|https://github.com/dtremblay/c256-tetris/tree/f256k
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|}

== Game Jam #02 - October 25th-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it. Optionally uses a MIDI in controller plugged in.
|https://github.com/Mu0n/F256KsimpleCdoodles/releases/download/v1.2/BachHero.pgz
|-
|f256_snake
|
|mgr42
|pgz. Use cursor keys, Atari joystick or SNES pad to play
|https://github.com/rmsk2/f256_snake
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Ultima_3
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}

== Game Jam #03 - April 18th-April 27th 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Arcade Shanghai v1.2
|Shanghai clone
|contrerasd
|basic, keep the .bas program in root, the rest in the provided ashanghai/ folder
|https://github.com/econtrerasd/ashanghai/releases
|-
|Bawk Bawk Cluck Cluck
|Chicken themed platformer
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamApr2025
|-
|BitLadder
|Shoot 'Em Up
|Mu0n
|pgz. For full sound compatibility, a Jr2 or K2 is needed.
Uses 4 sound chips! (PSG, SID, OPL3, MIDI)
|https://mu0n.itch.io/bitladder
|-
|F256_Commando
|Commando port
|SprySloth
|pgz
|https://github.com/cmassat/F256_Commando
|-
|F256_LodeRunner
|Lode Runner port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Loderunner/releases
|-
|Mahjong
|Shangai clone
|mgr42
|pgz
|https://github.com/rmsk2/f256_mahjong/releases
|-
|Quarth
|Block placement arcade game
|Grenouye
|pgz
|https://grenouye.itch.io/f256-quarth
|-
|Skee(ster)-Ball
|
|Mike
|pgz
|https://github.com/mcassera/skeeball256/tree/main
|}

== Game Jam #04 - November-December 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|H.E.R.O.
|Port of the classic game H.E.R.O.
|Cibee
|pgz
|https://c1bee.itch.io/hero
|-
|Leaderboard
|Golf game
|xDraconian
|pgz
|https://discord.com/channels/691915291721990194/1424187774642290799/1456104940186501132
|-
|Pitfall
|Port of the classic Pitfall game from Activision
|MinstrelDragon
|pgz
|
|-
|Track Day
|v1.0 top down race game vs computer controlled opponents
|MikeC
|pgz
|https://mcassera.itch.io/track-day-racing
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cozyMIDI
|Plays a SMF with the SAM2695 or VS1053b
|Mu0n
|pgz
|cozyMIDI v2.4 can open and play type 0 and type 1 standard MIDI files (SMF)
needs a Jr2 or K2
with a 2x core at https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos

run operation 1: just as itself, it will force you to pick a midi file in the 'midi/' folder /- cozymidi

run operation 2: in f/manager, if you put this as <code>midiplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .mid files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/cozymidi.pgz
|-
|digestMidi
|converts .mid to .dim
|Mu0n
|pgz
|.mid files are slow to load, parse and prepare for a playback. This tool comes in to convert them into a .dim format that strips out unnecessary MIDI commands and sets it up for timer0 time delays. Works with type 0 and type 1 standard midi files. This tools does the conversion and lets you hear the result.
Find the latest version here: https://github.com/Mu0n/F256MiscGoodies/tree/main/apps
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|F256amp
|mp3, ogg, wav, wma file playback
|Mu0n
|pgz
|(aka audioplayer.pgz) v2.3 Needs a Jr.2 or K2 since it uses the VS1053b chip.
For a starter collection of .mp3 and other audio files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick an audio file. it expects a <code>media/mp3/</code> folder, but it can live without it and peek into the root instead.

run operation 2: with an argument, it will auto-play it: /- f256amp yourmp3file.mp3

run operation 3: in f/manager, if you put this as <code>audioplayer.pgz</code> in the '_apps/' folder. This lets f/manager automatically open up .mp3, .wav, .ogg, .wma that you press enter on.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/f256amp.pgz
|-
|FireJam
|all chips, music playing with MIDI in
|Mu0n
|pgz
|v1.2 MIDI in and out capable, it will still partially work with a Jr. (PSG, and SID if you have them), a K (PSG, SID, OPL3) and the newest wave 2 Jr2 and K2 (PSG, SID, OPL3, SAM, VS1053b).
Best to use with a MIDI in controller, but it'll be controllable with arrows and space to make notes individually, or the F keys to start beats. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jrtracker
|Tracker based in basic and uses the PSG
(considered obsolete, use tracker2)
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|Musik
|Music piece demo using MIDI
|Mike
|pgz
|https://github.com/mcassera/Musik/blob/main/Musik.PGZ<nowiki/>Musikalisches Würfelspiel
Requires a Jr2 or K2 since it uses MIDI
|-
|opl3snooper
|playback of VGM files (that use opl2 and opl3) and MIDI in
|Mu0n
|pgz
|v1.0 mainly plays back vgm files, but you can pause it and snoop around the channel instruments and play up to 18 note polyphony with MIDI in. expects a collection in media/vgm/, or it will browse from the root if it can't find.
It can load a .spl (Simple PLaylist) text file, which is one file per line, including their respective paths.
Requires a Jr2 or K2 with a 2x core to use the extra bank of SRAM.
For a starter collection of .vgm files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick a midi file in the 'media/vgm/' folder

run operation 2: in f/manager (v1.1b9 and up), if you put this as <code>vgmplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .vgm files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3snooper.pgz
|-
|opl3tweak
|uses MIDI in, plays 18 channels polyphony in real time to the YMF262 OPL3. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3tweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload''''' '''''"yourmusicfile", $01000'''''
followed by running this program with '''''/- playvgm.pgx'''''
|-
|sidtweak
|uses MIDI in, plays 6 channels polyphony in real time to the dual SID. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sidtweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|rawsidplayer
|plays raw PSID files from the HVSC collection, converted by zigreSID
|Mu0n
|pgz
|(formely psidplayer) v0.2 find rawsidplayer.pgz and a starter .rsd file (raw sid dumps). For a starter collection of .rsd files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
extract sid.zip into a folder /sid/ in the root of your SD card, that's where psidplayer.pgz will first look to let you pick a file. failing that, it will fall back to the root folder and let you navigate.

program link:

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/rawsidplayer.pgz
|-
|tracker2 v1.5
|Like jrtracker.bas, but using both PSGs
|contrerasd
|basic
|https://github.com/econtrerasd/Tracker2/releases
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz/flash
|https://github.com/rmsk2/f256_dcopy
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|f256_reset
|A small utility that lets you reset the machine through this piece of flash software
|mgr42
|flash
|https://github.com/rmsk2/f256_reset
|
|-
|fcart
|A program that allows to write data to flash expansion cartridges
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/cartflash
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|flashselect
|Allows to select a program to start from a flash cartridge via a menu
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/flashselect
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|midiStuff
|Test program for a F256K2 or F256Jr2 that sends MIDI data to the internal sam2695 dream chip that produces MIDI based audio. Also test a keyboard controller plugged in the MIDI in port.
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/blob/main/README.md#midistuff
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|-
|pgz2flash
|A program for your Linux, Windows or MacOS machine to turn any PGZ or SuperBASIC program into a KUP which can be run from cartridge or onboard flash memory
|mgr42
|Executable for modern computers
|https://github.com/rmsk2/pgz2flash
|
|-
|sidTester
|Simple superbasic program that tests out all 3 voices of the SID1 on the Jr (if populated), K, Jr2 and K2. Ported by Mu0n, made by andy on HackJunk.com https://hackjunk.com/2017/11/07/commodore-64-sid-tester/
|andy
|basic
|https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/sidtester.bas
|
|-
|testsuite.bas
|a series of tests for your F256, video modes and sound chips
|econtrerasd
|basic
|run from the root, https://raw.githubusercontent.com/Mu0n/F256MiscGoodies/refs/heads/main/apps/testsuite.bas
|
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active. Works with the K and Jr. ESP32 Feather 'huzzah' board. Not meant to be used with the K2 and Jr2 Wiznet chip.
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|Raúl SQ basic repo
|F256 SuperBASIC Trigonometry
|Raúl SQ
|basic
|https://github.com/raul-sq/FoenixF256K2
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|}

Software for 6502

2026-01-04T00:27:11Z

Draconian: /* Game Jam #04 - November-December 2025 */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it. For extra help on how to run .bin files and almost every possible scheme that has to be used to run program, you can consult this video that's also part of [[Getting Started]], this one: https://www.youtube.com/watch?v=0ShFv89KGDs

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

===== Curated SD card collection of games, demos, utilities =====
Here is a download link to a zip file meant to be extracted into the root of an SD card: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection

Best to wipe out your SD card and start anew with the contents of this extracted to root. Micah's file manager doesn't like long lists of files so it really is best to not overdo it. I tried to minimize the files in root, but I couldn't for everything.

Open the readme.txt file with moreorless to see some instructions about the collection. Best to run /- fm first, then open the readme.txt from it

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256 f/term
|Terminal emulator for F256K and Jr with classic (flat) memory load
|Micah
| - fterm.pgZ or use f/manager
|https://github.com/WartyMN/F256-terminal/blob/main/release/fterm.pgZ
|-
|FoenixTarot
|Tarot card readings in SuperBasic
|Mike
|basic
|https://github.com/mcassera/FoenixTarot/tree/main
|-
|Forthf256
|Forth implementation
|Vasyl
|pgz in its forth/ folder
|https://github.com/VasylTsv/ForthX16
|-
|WildBits Graphic Toolkit
|(fmr. F256-GraphicToolkit) Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit/releases
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|badapple
|A 80x60 textmode port of Bad Apple, uses the VS1053b for quality mp3 audio. Needs a Jr2 or K2!
|Mu0n
|pgz*
|*unzip badapple.zip into the root of your SD card. If done right, the 3 files within will be in the demos/ folder. The program expects its data file there when it runs. https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/badapple.zip
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256Archon
|Splash screen intro, plays MIDI using the SAM2695, requires a K2 or Jr2
|Mu0n
|pgz
|https://github.com/Mu0n/F256Archon/releases
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/xmas24_k2.pgz revised version that can run on wave 2 Jr2 and K2 as well
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|mariobros
|Tilemap and platformer test based on Mario Bros. (1983)
|beethead
|pgz
|https://github.com/noyen1973/mariobros
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|FusionDrive
|An outrun type game that also plays a MIDI soundtrack
|Mu0n
|pgz
|wip v0.2, can use a NES pad #1 to move around, or left/right arrow keys currently https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jewelkeeper
|Sokoban port
|beethead
|pgz
|https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/jewelkeeper.pgz<nowiki/>You can now specify a level file when loading the game <code>/- jewelkeeper.pgz <levels.txt></code>. Find more levels at https://www.sourcecode.se/sokoban/levels.php. Keep in mind the maximum level dimension is 20x15, anything larger will be ignored
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://discord.com/channels/691915291721990194/1230670413361844244/1317256215566487593 1.0 Beta 19 Demo]
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Shanghai/Mahjongg
|A clone of Shanghai. Also known as Mahjongg
|mgr42
|pgz or KUP
mouse needed
|https://github.com/rmsk2/f256_mahjong
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|-
|Tetris
|Good old 80's game
|Daniel Tremblay (Grenouye)
|pgz
atari joystick or keyboard
|https://github.com/dtremblay/c256-tetris/tree/f256k
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|}

== Game Jam #02 - October 25th-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it. Optionally uses a MIDI in controller plugged in.
|https://github.com/Mu0n/F256KsimpleCdoodles/releases/download/v1.2/BachHero.pgz
|-
|f256_snake
|
|mgr42
|pgz. Use cursor keys, Atari joystick or SNES pad to play
|https://github.com/rmsk2/f256_snake
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Ultima_3
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}

== Game Jam #03 - April 18th-April 27th 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Arcade Shanghai v1.2
|Shanghai clone
|contrerasd
|basic, keep the .bas program in root, the rest in the provided ashanghai/ folder
|https://github.com/econtrerasd/ashanghai/releases
|-
|Bawk Bawk Cluck Cluck
|Chicken themed platformer
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamApr2025
|-
|BitLadder
|Shoot 'Em Up
|Mu0n
|pgz. For full sound compatibility, a Jr2 or K2 is needed.
Uses 4 sound chips! (PSG, SID, OPL3, MIDI)
|https://mu0n.itch.io/bitladder
|-
|F256_Commando
|Commando port
|SprySloth
|pgz
|https://github.com/cmassat/F256_Commando
|-
|F256_LodeRunner
|Lode Runner port
|Minstrel Dragon
|pgz
|https://github.com/minstreldragon/F256_Loderunner/releases
|-
|Mahjong
|Shangai clone
|mgr42
|pgz
|https://github.com/rmsk2/f256_mahjong/releases
|-
|Quarth
|Block placement arcade game
|Grenouye
|pgz
|https://grenouye.itch.io/f256-quarth
|-
|Skee(ster)-Ball
|
|Mike
|pgz
|https://github.com/mcassera/skeeball256/tree/main
|}

== Game Jam #04 - November-December 2025 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|H.E.R.O.
|Port of the classic game H.E.R.O.
|Cibee
|pgz
|
|-
|Leaderboard
|Golf game
|xDraconian
|pgz
|https://discord.com/channels/691915291721990194/1424187774642290799/1456104940186501132
|-
|Pitfall
|Port of the classic Pitfall game from Activision
|MinstrelDragon
|pgz
|
|-
|Track Day
|v1.0 top down race game vs computer controlled opponents
|MikeC
|pgz
|https://mcassera.itch.io/track-day-racing
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cozyMIDI
|Plays a SMF with the SAM2695 or VS1053b
|Mu0n
|pgz
|cozyMIDI v2.4 can open and play type 0 and type 1 standard MIDI files (SMF)
needs a Jr2 or K2
with a 2x core at https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos

run operation 1: just as itself, it will force you to pick a midi file in the 'midi/' folder /- cozymidi

run operation 2: in f/manager, if you put this as <code>midiplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .mid files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/cozymidi.pgz
|-
|digestMidi
|converts .mid to .dim
|Mu0n
|pgz
|.mid files are slow to load, parse and prepare for a playback. This tool comes in to convert them into a .dim format that strips out unnecessary MIDI commands and sets it up for timer0 time delays. Works with type 0 and type 1 standard midi files. This tools does the conversion and lets you hear the result.
Find the latest version here: https://github.com/Mu0n/F256MiscGoodies/tree/main/apps
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|F256amp
|mp3, ogg, wav, wma file playback
|Mu0n
|pgz
|(aka audioplayer.pgz) v2.3 Needs a Jr.2 or K2 since it uses the VS1053b chip.
For a starter collection of .mp3 and other audio files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick an audio file. it expects a <code>media/mp3/</code> folder, but it can live without it and peek into the root instead.

run operation 2: with an argument, it will auto-play it: /- f256amp yourmp3file.mp3

run operation 3: in f/manager, if you put this as <code>audioplayer.pgz</code> in the '_apps/' folder. This lets f/manager automatically open up .mp3, .wav, .ogg, .wma that you press enter on.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/f256amp.pgz
|-
|FireJam
|all chips, music playing with MIDI in
|Mu0n
|pgz
|v1.2 MIDI in and out capable, it will still partially work with a Jr. (PSG, and SID if you have them), a K (PSG, SID, OPL3) and the newest wave 2 Jr2 and K2 (PSG, SID, OPL3, SAM, VS1053b).
Best to use with a MIDI in controller, but it'll be controllable with arrows and space to make notes individually, or the F keys to start beats. https://github.com/Mu0n/F256KsimpleCdoodles/tree/main/NoFussDemos
|-
|jrtracker
|Tracker based in basic and uses the PSG
(considered obsolete, use tracker2)
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|Musik
|Music piece demo using MIDI
|Mike
|pgz
|https://github.com/mcassera/Musik/blob/main/Musik.PGZ<nowiki/>Musikalisches Würfelspiel
Requires a Jr2 or K2 since it uses MIDI
|-
|opl3snooper
|playback of VGM files (that use opl2 and opl3) and MIDI in
|Mu0n
|pgz
|v1.0 mainly plays back vgm files, but you can pause it and snoop around the channel instruments and play up to 18 note polyphony with MIDI in. expects a collection in media/vgm/, or it will browse from the root if it can't find.
It can load a .spl (Simple PLaylist) text file, which is one file per line, including their respective paths.
Requires a Jr2 or K2 with a 2x core to use the extra bank of SRAM.
For a starter collection of .vgm files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
run operation 1: just as itself, it will force you to pick a midi file in the 'media/vgm/' folder

run operation 2: in f/manager (v1.1b9 and up), if you put this as <code>vgmplayer.pgz</code>in the '_apps/' folder, f/manager will open midi file with it when you launch .vgm files.

Program link: https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3snooper.pgz
|-
|opl3tweak
|uses MIDI in, plays 18 channels polyphony in real time to the YMF262 OPL3. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/opl3tweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload''''' '''''"yourmusicfile", $01000'''''
followed by running this program with '''''/- playvgm.pgx'''''
|-
|sidtweak
|uses MIDI in, plays 6 channels polyphony in real time to the dual SID. Fish for random register values.
|Mu0n
|pgz
|v0.1. Can't save or load instrument definitions yet. Needs a K2 with a MIDI in currently. https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sidtweak.pgz
Arrows to move around, + and - keys to incr/decr values or type in a hex value directly under the highlighted position.
|-
|rawsidplayer
|plays raw PSID files from the HVSC collection, converted by zigreSID
|Mu0n
|pgz
|(formely psidplayer) v0.2 find rawsidplayer.pgz and a starter .rsd file (raw sid dumps). For a starter collection of .rsd files, check the SD curated collection here: https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection
extract sid.zip into a folder /sid/ in the root of your SD card, that's where psidplayer.pgz will first look to let you pick a file. failing that, it will fall back to the root folder and let you navigate.

program link:

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/rawsidplayer.pgz
|-
|tracker2 v1.5
|Like jrtracker.bas, but using both PSGs
|contrerasd
|basic
|https://github.com/econtrerasd/Tracker2/releases
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz/flash
|https://github.com/rmsk2/f256_dcopy
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|f256_reset
|A small utility that lets you reset the machine through this piece of flash software
|mgr42
|flash
|https://github.com/rmsk2/f256_reset
|
|-
|fcart
|A program that allows to write data to flash expansion cartridges
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/cartflash
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|flashselect
|Allows to select a program to start from a flash cartridge via a menu
|mgr42
|pgz, on-board and cartridge flash
|https://github.com/rmsk2/flashselect
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|midiStuff
|Test program for a F256K2 or F256Jr2 that sends MIDI data to the internal sam2695 dream chip that produces MIDI based audio. Also test a keyboard controller plugged in the MIDI in port.
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/blob/main/README.md#midistuff
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|-
|pgz2flash
|A program for your Linux, Windows or MacOS machine to turn any PGZ or SuperBASIC program into a KUP which can be run from cartridge or onboard flash memory
|mgr42
|Executable for modern computers
|https://github.com/rmsk2/pgz2flash
|
|-
|sidTester
|Simple superbasic program that tests out all 3 voices of the SID1 on the Jr (if populated), K, Jr2 and K2. Ported by Mu0n, made by andy on HackJunk.com https://hackjunk.com/2017/11/07/commodore-64-sid-tester/
|andy
|basic
|https://github.com/Mu0n/F256MiscGoodies/blob/main/apps/sidtester.bas
|
|-
|testsuite.bas
|a series of tests for your F256, video modes and sound chips
|econtrerasd
|basic
|run from the root, https://raw.githubusercontent.com/Mu0n/F256MiscGoodies/refs/heads/main/apps/testsuite.bas
|
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active. Works with the K and Jr. ESP32 Feather 'huzzah' board. Not meant to be used with the K2 and Jr2 Wiznet chip.
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|Raúl SQ basic repo
|F256 SuperBASIC Trigonometry
|Raúl SQ
|basic
|https://github.com/raul-sq/FoenixF256K2
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|}

Software for 6502

2024-11-04T22:29:46Z

Draconian: /* Game Jam #02 - October 25h-November 1st 2024 */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Game Jam #02 - October 25h-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it
|https://github.com/Mu0n/F256KsimpleCdoodles/releases
|-
|f256_snake
|
|mgr42
|pgz
|https://github.com/rmsk2/f256_snake/releases/tag/V1.0
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

Software for 6502

2024-11-04T22:28:30Z

Draconian: /* Game Jam #02 - October 25h-November 1st 2024 */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Game Jam #02 - October 25h-November 1st 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bach's MIDI Hero
|Free MIDI/PSG play + note play tutorial
|Mu0n
|pgz
|the MIDI feature requires a F256K2 or F256Jr2; a legacy PSG option also allows F256K and F256Jr to still hear it
https://github.com/Mu0n/F256KsimpleCdoodles/releases
|-
|f256_snake
|
|mgr42
|pgz
|https://github.com/rmsk2/f256_snake/releases/tag/V1.0
|-
|fnxsnake
|
|silk-neon
|pgz
|https://github.com/ksiondag/fnxsnake
|-
|The Hallow
|
|beethead
|pgz
|https://github.com/noyen1973/FoenixGameJamOct2024
|-
|Halloween Birthday
|
|SprySloth
|pgz
|https://github.com/cmassat/GameJam2024_F256K
|-
|Haunted Mansion
|
|digarok
|superbasic
|https://github.com/digarok/fnxgamejam-haunted-mansion
|-
|Kooyan
|
|Grenouye
|pgz
|https://github.com/dtremblay/kooyan.git
|-
|Spooky Run
|
|dwsJason
|pgz
|https://github.com/dwsJason/spooky
|-
|Trick or Treat
|
|Mike
|pgz
|https://github.com/mcassera/TrickOrTreat
|-
|Ultima III - Exodus
|port
|Minstrel Dragon
|pgz
|
|-
|Warlock
|remake of 68000 game
|xDraconian
|pgz
atari joystick
DOWN=change_level
UP=jump
UP-LEFT=leap
UP-RIGHT=leap
|https://github.com/scttgs0/Foenix_GameJam_Oct2024
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K asm doodles
|Some asm examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleASMdoodles
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|Mu0n's F256K C doodles
|Some C examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KsimpleCdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

Software for 6502

2024-08-17T04:16:04Z

Draconian: /* Games */ Track & Field

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|-
|Track & Field
|Olympic Game by Konami (WIP)
|Scott (xDraconian)
|pgz
atari joystick or keyboard
|
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

Software for 6502

2024-08-01T04:43:29Z

Draconian: /* Games */ added Planetary Defense

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers<nowiki/>https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|-
|pdefense
|Planetary Defense (WIP)
|Scott (xDraconian)
|pgx
mouse
atari joystick
|https://github.com/scttgs0/PlanetaryDefense
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

Software for 6502

2024-07-31T03:00:13Z

Draconian: /* Games */ added livewire

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|-
|livewire
|Livewire (WIP)
Tempest-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Livewire
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

Software for 6502

2024-07-28T05:11:55Z

Draconian: /* Games */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|fillerup
|Fill 'er Up (WIP)
Qix-like game
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

Software for 6502

2024-07-26T23:54:26Z

Draconian: /* Games */ Added Fill 'er Up

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|-
|F256-Trek
|Updated Trek, with modern F256 Graphics
|econtrerasd
|basic
|[https://github.com/econtrerasd/Trek-F256/releases/tag/v1.0 https://github.com/econtrerasd/Trek-F256/releases]
|-
|fillerup
|Fill 'er Up (WIP)
Clone of Qix
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/Fill-er-up
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

Software for 6502

2024-07-06T15:56:53Z

Draconian: /* Games */

Note that when an hex address is given, it's meant to instruct as to which address to bload or to send (ie foenixmgr python script) the program (ie a .bin file) to before running it.

Many download links are posts in the main [https://discord.gg/9vjUEGgcUS Foenix Retro Systems discord server] which will require you to join in order to get to them.

A [[Getting Started#Demos Archive|Demo Archive]] was put together in September 2023 to get ready to show to youtubers, some of these are linked once more, in this page.

There's also the Foenix Marketplace website maintained by EMWhite with its own collection of articles and software http://apps.emwhite.org/foenixmarketplace/.

== Applications ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|F256-GraphicToolkit
|Sprite editor, Tilemap editor, Font editor + misc tools
|econtrerasd
|basic
|https://github.com/econtrerasd/F256-GraphicToolkit
|}

== Demos ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|balls
|Draw a good quantity of multiplexed sprites, fast. Balls bouncing around
|celton
|pgz
|https://github.com/FoenixRetro/demos/blob/main/MultiplexedSprites.md
|-
|F256 Mandelbrot
|Draws Mandelbrot set fast (5 mins) using coprocessor math. Allows to zoom into the set.
|mgr42
|uses basic loader
|https://github.com/rmsk2/F256_Mandelbrot
|-
|f256_life
|An implementation of Conway's game of life
|mgr42
|pgz
|https://github.com/rmsk2/f256_life
|-
|F256ShowCase
|Shows sliding tiling graphics, moves with joystick
|eriktier
|$0000
|https://github.com/pig-games/F256Showcase
|-
|fnxmas23
|PSG mod music, scrolling text, sound effects, must see demo!
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/934618943400837130/1188633998663098398 if you have Dec23 FPGA load or newer
https://discordapp.com/channels/691915291721990194/934618943400837130/1188633118194794527 if you have an older FPGA load
|-
|foenixmas23
|Xmas 2023 demo with SID music from the classic 1983 C64 xmas demo
|EMWhite
|uses basic loader
|http://apps.emwhite.org/shared-files/815/?foenixmas23.zip
|-
|livingworlds
|Living Worlds, a port of a color cycling by Mark Ferrari, ported here on the F256 by haydenkale
|haydenkale
|$0000
|https://github.com/clandrew/livingworlds/tree/e4532e0d530b76ccb90368fdf5ad10bfa2deeb12
|-
|mandel
|Will draw a mandelbrot set in 3 hours, more useful as a stability test than a useful fractal program
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#fractal
|-
|wormhole
|Shows a fast wireframe animation of a wormhole
|haydenkale
|pgz or bin at $0000
|https://github.com/clandrew/wormhole?tab=readme-ov-file
|}

== Games ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|Bombsweeper
|Bomb sweeper port
|beethead
|pgz
|https://discord.com/channels/691915291721990194/855689509520932885/1196352934083035156
|-
|bbombers
|Boulder Bombers (Alpha-2) Clone of Canyon Bombers
|Scott (xDraconian)
|pgx
atari joystick
|https://github.com/scttgs0/BoulderBombers/releases/tag/alpha_2
|-
|Cosmic
|Shoot 'em up
|beethead
|pgz
|https://discordapp.com/channels/691915291721990194/1054250238308790342/1175982979537969214
|-
|F256 two to the power of eleven
|Port of the puzzle game of 2048
|mgr42
|pgz
|https://github.com/rmsk2/F256_2048<nowiki/>
|-
|Jr Wördl
|port of Wordle
|AgeAgeEye
|basic
|https://github.com/ageageeye/Superbasic-F256Jr-examples
|-
|kartdemo
|Kart racing game
|SprySloth
|pgz
|https://discord.com/channels/691915291721990194/1225217654487253094/1228246780840513556
|-
|Maze-Munch
|Pac-Man clone
|SprySloth
|pgz
|https://github.com/cmassat/Maze-Munch
|-
|Ski-Jr
|Ski game downhill
|digarok
|basic
|https://github.com/digarok/superbasic-traveler/blob/main/ski-jr.bas
|-
|Lair of the Lich King
|Rogue like dungeon crawler. Demo has 3 levels; full has 25+
|Micah
| - lkdemo/lk.pgz
|[https://cdn.discordapp.com/attachments/855689509520932885/1206778663526469632/lk_f256_1.0b19_demo.zip?ex=65dd3f36&is=65caca36&hm=30911e1c516874ce80a4e56bfa847ea933da1f37918eb44ced33dddc9e91197e& 1.0 Beta 19 Demo]
|}

== Game Jam #01 - April 6th/7th 2024 ==
{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|15puzzle
|Number sort puzzle
|mgr42
|pgz
|https://github.com/rmsk2/f256_15puzzle/releases<nowiki/>
|-
|frisbee
|Frisbee throw past sport game
|dwsJason
|pgz
|https://github.com/dwsJason/f256/blob/develop/merlin32/frisbee/frisbee.pgz
|-
|Impasse
|Shoot 'em up
|digarok
|pgz
|https://discord.com/channels/691915291721990194/1225481966200029286/1227075699895046235
|-
|soccur
|mutliplayer game of soccer
|beethead
|pgz
|executable:https://discord.com/channels/691915291721990194/1225481966200029286/1226808228948611184
source code:
https://discord.com/channels/691915291721990194/1225481966200029286/1226812472069980232
|-
|Trek
|port of classic Star Trek game
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/1225481966200029286/1226727849944289341
|-
|Typing Star
|typing reaction game
|haydenkale
|pgz
|https://github.com/clandrew/typestar
|-
|Flight Simulator
|flying simulator
|sduensin
|pgz
|https://cdn.discordapp.com/attachments/1225481966200029286/1227764847819620454/shotel.pgz
|-
|}

== Music ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|EdInHisLib
|SID+OPL3 simultaneously
|beethead, ported from xantax
|pgz
|F256 port: https://discordapp.com/channels/691915291721990194/1054249926521016392/1184413356598231120
original: <nowiki>https://csdb.dk/release/?id=170898</nowiki>. Not 100% accurate but close.
|-
|jrtracker
|Tracker based in basic and uses the PSG
|contrerasd
|basic
|https://ptb.discord.com/channels/691915291721990194/1008139105386889346/1188292876984143983
|-
|tracker2
|Same tracker, but using both PSGs
|contrerasd
|basic
|https://discord.com/channels/691915291721990194/975117322836656138/1210809081577865257
|-
|modo
|MOD player using the PSG
|dwsJason and digarok
|pgz
|https://discordapp.com/channels/691915291721990194/855689509520932885/1190723114661859429
|-
|piano
|Plays some PSG notes with the keyboard
|Mu0n
|basic
|https://github.com/Mu0n/F256KbasicBASICdoodles?tab=readme-ov-file#pulse-sound-generator-piano
|-
|playvgm
|plays a headless vgm file with OPL3
|G33kyAndIKnowIt
|pgx
|https://github.com/natebarney/playvgm-f256k
some example music files can be gotten from this post:
[https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 https://discord.com/channels/6][https://discord.com/channels/691915291721990194/975117322836656138/1220366429640065074 91915291721990194/975117322836656138/1220366429640065074]

1) open a normal .vgm into a hex editor <nowiki/>and cut out the header bytes from 0x00 to 0x<nowiki/>FF

2) run by first using superbasic's '''''bload'''''<nowiki/> '''''"yourmusicfile", $01000'''''
followed by run<nowiki/>ning<nowiki/> this program with '''''/- playvgm.pgx'''''
|}

== Uti<nowiki/>lities ==

{| class="wikitable"
|+
!Program
!Descrip<nowiki/>tion
!Author
!Notes on running
!Link
|-
|wget<nowiki/>
|<nowiki/>fetches a file from a http address if you have a network connection active
|gadget
|<nowiki/>pgz/flash
|https://github.com/ghackwrench/F256_wget
|
|-
|dcopy
|A tool to copy files from one drive to another or to/from your PC via RS-232 and a nullmodem cable
|mgr42
|pgz
|https://github.com/rmsk2/f256_dcopy
|
|-
|fonts
|A variety of fonts using the standard F256 character set arrangement. Load with the F256 file manager (f/manager), or your own code.
|Micah
|(not a program)
|[https://github.com/WartyMN/Foenix-Fonts/tree/main https://github.com/WartyMN/Foenix-Fonts]
|
|-
|f/manager
|A general file utility, launcher, and memory viewing program. Dual-panel file/memory browsers; copy between disks, between folders on same disk, and from memory to disk and vice versa; delete, rename, and duplicate files; view files as hex or text (with word-wrap); launch applications and known file types; set the RTC clock; search in RAM and flash. Works with internal SD card and IEC devices such as FNX1591 and Commodore 1541. Can be installed in primary flash position ahead of SuperBASIC or DOS, or at a higher location. Can also be run from disk with "- fm.pgz".
|Micah
|pgZ/flash
|https://github.com/WartyMN/F256-FileManager/releases
|
|-
|flashcart
|Allows to wipe a block of flash or write a program to a flash cart, from this basic program from the F256Jr/K
|redfool.
|basic
|https://github.com/Red-Fool/F256_FlashCart/tree/main
|
|-
|basic2text
|A simple utility for translating Commodore BASIC (all variants) from its native tokenized file format to a text format that can be opened with SuperBASIC. Does not perform any code translation: all adaptation is up to you.
|Micah
|pgZ
|https://github.com/WartyMN/F256-BasText/releases/latest
|
|-
|moreorless
|A text editor for the Foenix 256 line of computers
|mgr42
|pgz
|https://github.com/rmsk2/moreorless/releases/
|
|}

== Sample Code ==

{| class="wikitable"
|+
!Program
!Description
!Author
!Notes on running
!Link
|-
|cc65 example
|c example code
|gadget
|read github
|https://github.com/ghackwrench/F256_Jr_Kernel_DOS
|-
|digarok basic stuff
|Lots of basic examples
|digarok
|read github
|https://github.com/digarok/superbasic-traveler/tree/main
|-
|Mu0n's F256K basic doodles
|Some basic examples
|Mu0n
|read github
|https://github.com/Mu0n/F256KbasicBASICdoodles
|-
|tcp example
|connects to a server and gets typed in text echoed back to you
|gadget
|$2000
|https://github.com/ghackwrench/F256_example_tcp
|-
|Assembly examples
|Sample programs for several features of the Foenix F256K and Jr.
|mgr42
|read github
|https://github.com/rmsk2/Hello_Foenix256_Jr/blob/main/testprogs.md
|}

File Formats

2024-01-12T22:19:38Z

Draconian: /* PGX */

The F256 line has three file formats, each with slightly different properties and use cases. Additionally, pure binary files are often used by developers. The machine will be in a slightly different state, depending on how the program was started. We will cover this in the following sections.

== Binary ==
The binary file format is not a format as such. It is an image that is loaded directly into the F256's memory by a utility program running on the PC or Mac, and the F256 is then reset. Such an image must include properly initialized interrupt vectors, especially the RESET vector.

Running such an image requires knowledge of its starting address and a properly configured USB connection between the PC or Mac and the F256. Also, a jumper on the F256 Jr. motherboard must be moved to the "Boot-to-RAM" position. This is not necessary on the F256K.

Binary images should only be used by the developer while developing, as it is a very user-unfriendly method of distributing software, requiring tethering to a PC or Mac.

== KUP - Kernel User Program ==
KUPs are very simple and can contain 40 KiB code/data when run from flash, or 32 KiB when run from disk. Contained in their header is an entry point address, and the slot number of where they should be mapped into, the first possible slot being #1 ($2000).

DOS expands on the KUP header defined by the MicroKernel in a backwards compatible way.

The header is very simple:

<pre>
Byte 0 signature: $F2
Byte 1 signature: $56
Byte 2 the size of program in 8k blocks
Byte 3 the starting slot of the program (i.e. where to map it)
Bytes 4-5 the start address of the program
Byte 6 header structure version (indicates version of header, current 0 or 1)
Bytes 7-9 reserved
Bytes 10-? zero-terminated name of the program.
Bytes ?-? zero-terminated string describing the arguments. (in version >= 1)
Bytes ?-? zero-terminated string describing the program's function. (in version >= 1)
</pre>

Example of a header block definition:

<pre>
EXEC = __STARTUP_LOAD__
SLOT = __STARTUP_LOAD__ >> 13
COUNT = __END_LOAD__ >> 13 ; Assumes code starts at $2000.

.byte $f2,$56 ; signature
.byte <COUNT ; block count
.byte <SLOT ; start slot
.word EXEC ; exec addr
.byte 1 ; CHANGED, structure version
.byte 0 ; reserved
.byte 0 ; reserved
.byte 0 ; reserved
.asciiz "cwrite" ; name
.asciiz " "
.asciiz "App to program the Flash Cartridge"

.segment "END"
</pre>

The MicroKernel ignores the "argument" and "function" header entries. These are printed by DOS' <code>lsf</code> command, and only if the header version is greater or equal to 1.

When instructed to start a named KUP, the kernel will search through memory to find a match. First the expansion memory is searched, this could be either RAM or ROM. Then the on-board flash memory is searched. If DIP switch #1 is in the "on" position, the kernel will search memory banks 1-5 before the expansion blocks.

This sequence is also performed when the kernel starts up, for instance when the machine is reset or is first powered on.

Testing a KUP is therefore as easy as uploading it to a block of memory, and is an excellent choice for testing a program that interacts with the kernel. Though you should remember that this program will stay in memory as long as the machine is powered on, and may also survive a short power cut. Such a program should therefore, when testing, destroy its own header by overwriting the first two bytes with some values that are not the magic signature, to avoid being started again and again.

A KUP residing in flash does not "return" in the common sense of the word. If it has to terminate, it can either reset the machine, or use `RunNamed` to start another KUP.

On the other hand, when running a KUP from disk, it is able to return to DOS in a controlled manner. Distributing software intended to be run from disk as KUP is usually discouraged, as the program can only be started from DOS and not from SuperBASIC. It can, however, be appropriate for small utility programs mostly intended for maintenance tasks and so forth. When distributing software, you should prefer using one of the PGX or PGZ formats.

A KUP loaded from disk may exit back to DOS by issuing an RTS instruction. Additionally, the carry may be set if the machine should be reset, or carry clear to continue running DOS. Be aware that you must leave the MMU configuration in the state you found it for this to work properly. You should also keep away from the $0200-$07FF range completely.

When a KUP is started from flash, LUT #3 slots 0-5 is mapped to RAM banks 0-5, *except* where the KUP's header specifies where into should be mapped.

A KUP started from disk has LUT #3 slots 0-4 mapped to RAM, some of which will be the program itself.

In both cases the kernel is intact and available for use straight away.

== PGX ==
This format is a simple, single segment executable, which can be loaded as low as $0200. A PGX is loaded using <code>pexec</code>. <code>pexec</code> treats PGX and PGZ in exactly the same way, and information on how PGZ is handled also applies to PGX.

PGX is similar in scale to MS-DOS’s COM format, or the Commodore PRG format. It consists of a single segment of data to be loaded to
a specific address, where that address is also the starting address.

PGX starts with a header to identify the file and the starting address:

* The first three bytes are the ASCII codes for “PGX”.
* The fourth byte is the CPU and version identification byte. Bits 0 through 3 represent the CPU code, and bits 4 through 7 represent the version of PGX supported. At the moment, there is just version 0. The CPU code can be 1 for the WDC65816, or 3 for the 65c02.
* The next four bytes (that is, bytes 4 through 7) are the address of the destination, in little-endian format (least significant byte first). This address is both the address of the location in which to load the first byte of the data and is also the starting address for the file.

All bytes after the header are the contents of the file to be loaded into memory.

== PGZ ==
This is a more advanced multi-segment executable. It can be loaded as low as $0200. It is loaded using <code>pexec</code>.

When <code>pexec</code> loads a program, the program must not load itself into RAM banks 6 & 7, as these are used by the kernel, and the kernel is doing the actual loading. If the program does not need the kernel, it may of course utilize these banks once it is running. <code>pexec</code> is otherwise able to load code and data into anywhere in physical memory.

When the program starts, the state of the MMU LUTs is very similar to when a KUP starts. LUT #3 is active and slots 0-4 are mapped to RAM banks 0-4. The program's entry point must be in this region. Slots 6 and 7 are mapped to the kernel, which is intact and usable right away. Slot 5 is currently undefined.

Testing a PGZ can be done by using FoenixMgr and the <code>xdev</code> firmware component. It can of course also be copied to a disk or SD card, and manually run it on the machine.

A PGZ cannot "return" to another program, it can either start a KUP (if the kernel is intact) or reset the machine.

The first byte of the file is a file signature and also a version tag. If the first byte is an upper case Z, the file is a 24-bit PGZ file (i.e. all addresses and sizes specified in the file are 24-bits). If the file is a lower case Z, the file is a 32-bit PGZ file (all address and sizes are 32-bits in
length). Note that all addresses and sizes are in little endian format (that is, least significant
byte first).

After the initial byte, the remainder of the PGZ file consists of segments, one after the other. Each segment consists of two or three fields:

{| class="wikitable"
!Field!!Size!!Description
|-
|address||3 ('''Z''') or 4 ('''z''') bytes||The target address for this segment
|-
|size||3 ('''Z''') or 4 ('''z''') bytes||The number of bytes in the data field
|-
|data||'''size''' bytes||The data to be loaded (optional)
|}

For a particular segment, if the size field is 0, there will be no bytes in the data field, and the segment specifies the starting address of the entire program. At least one such segment must be present in the PGZ file for it to be executable. If more than one is present, the last one will
be the one used to specify the starting address.

 ''Original Information Source:'' https://github.com/FoenixRetro/Documentation/blob/main/f256/programming-file-formats.md

File Formats

2024-01-12T22:18:51Z

Draconian: PGX - fix CPU code and little-endian format

The F256 line has three file formats, each with slightly different properties and use cases. Additionally, pure binary files are often used by developers. The machine will be in a slightly different state, depending on how the program was started. We will cover this in the following sections.

== Binary ==
The binary file format is not a format as such. It is an image that is loaded directly into the F256's memory by a utility program running on the PC or Mac, and the F256 is then reset. Such an image must include properly initialized interrupt vectors, especially the RESET vector.

Running such an image requires knowledge of its starting address and a properly configured USB connection between the PC or Mac and the F256. Also, a jumper on the F256 Jr. motherboard must be moved to the "Boot-to-RAM" position. This is not necessary on the F256K.

Binary images should only be used by the developer while developing, as it is a very user-unfriendly method of distributing software, requiring tethering to a PC or Mac.

== KUP - Kernel User Program ==
KUPs are very simple and can contain 40 KiB code/data when run from flash, or 32 KiB when run from disk. Contained in their header is an entry point address, and the slot number of where they should be mapped into, the first possible slot being #1 ($2000).

DOS expands on the KUP header defined by the MicroKernel in a backwards compatible way.

The header is very simple:

<pre>
Byte 0 signature: $F2
Byte 1 signature: $56
Byte 2 the size of program in 8k blocks
Byte 3 the starting slot of the program (i.e. where to map it)
Bytes 4-5 the start address of the program
Byte 6 header structure version (indicates version of header, current 0 or 1)
Bytes 7-9 reserved
Bytes 10-? zero-terminated name of the program.
Bytes ?-? zero-terminated string describing the arguments. (in version >= 1)
Bytes ?-? zero-terminated string describing the program's function. (in version >= 1)
</pre>

Example of a header block definition:

<pre>
EXEC = __STARTUP_LOAD__
SLOT = __STARTUP_LOAD__ >> 13
COUNT = __END_LOAD__ >> 13 ; Assumes code starts at $2000.

.byte $f2,$56 ; signature
.byte <COUNT ; block count
.byte <SLOT ; start slot
.word EXEC ; exec addr
.byte 1 ; CHANGED, structure version
.byte 0 ; reserved
.byte 0 ; reserved
.byte 0 ; reserved
.asciiz "cwrite" ; name
.asciiz " "
.asciiz "App to program the Flash Cartridge"

.segment "END"
</pre>

The MicroKernel ignores the "argument" and "function" header entries. These are printed by DOS' <code>lsf</code> command, and only if the header version is greater or equal to 1.

When instructed to start a named KUP, the kernel will search through memory to find a match. First the expansion memory is searched, this could be either RAM or ROM. Then the on-board flash memory is searched. If DIP switch #1 is in the "on" position, the kernel will search memory banks 1-5 before the expansion blocks.

This sequence is also performed when the kernel starts up, for instance when the machine is reset or is first powered on.

Testing a KUP is therefore as easy as uploading it to a block of memory, and is an excellent choice for testing a program that interacts with the kernel. Though you should remember that this program will stay in memory as long as the machine is powered on, and may also survive a short power cut. Such a program should therefore, when testing, destroy its own header by overwriting the first two bytes with some values that are not the magic signature, to avoid being started again and again.

A KUP residing in flash does not "return" in the common sense of the word. If it has to terminate, it can either reset the machine, or use `RunNamed` to start another KUP.

On the other hand, when running a KUP from disk, it is able to return to DOS in a controlled manner. Distributing software intended to be run from disk as KUP is usually discouraged, as the program can only be started from DOS and not from SuperBASIC. It can, however, be appropriate for small utility programs mostly intended for maintenance tasks and so forth. When distributing software, you should prefer using one of the PGX or PGZ formats.

A KUP loaded from disk may exit back to DOS by issuing an RTS instruction. Additionally, the carry may be set if the machine should be reset, or carry clear to continue running DOS. Be aware that you must leave the MMU configuration in the state you found it for this to work properly. You should also keep away from the $0200-$07FF range completely.

When a KUP is started from flash, LUT #3 slots 0-5 is mapped to RAM banks 0-5, *except* where the KUP's header specifies where into should be mapped.

A KUP started from disk has LUT #3 slots 0-4 mapped to RAM, some of which will be the program itself.

In both cases the kernel is intact and available for use straight away.

== PGX ==
This format is a simple, single segment executable, which can be loaded as low as $0200. A PGX is loaded using <code>pexec</code>. <code>pexec</code> treats PGX and PGZ in exactly the same way, and information on how PGZ is handled also applies to PGX.

PGX is similar in scale to MS-DOS’s COM format, or the Commodore PRG format. It consists of a single segment of data to be loaded to
a specific address, where that address is also the starting address.

PGX starts with a header to identify the file and the starting address:

* The first three bytes are the ASCII codes for “PGX”.
* The fourth byte is the CPU and version identification byte. Bits 0 through 3 represent the CPU code, and bits 4 through 7 represent the version of PGX supported. At the moment, there is just version 0. The CPU code can be 1 for the WDC65816, or 3 for the 65c02.
* The next four bytes (that is, bytes 4 through 7) are the address of the destination, in little-endian format (most significant byte first). This address is both the address of the location in which to load the first byte of the data and is also the starting address for the file.

All bytes after the header are the contents of the file to be loaded into memory.

== PGZ ==
This is a more advanced multi-segment executable. It can be loaded as low as $0200. It is loaded using <code>pexec</code>.

When <code>pexec</code> loads a program, the program must not load itself into RAM banks 6 & 7, as these are used by the kernel, and the kernel is doing the actual loading. If the program does not need the kernel, it may of course utilize these banks once it is running. <code>pexec</code> is otherwise able to load code and data into anywhere in physical memory.

When the program starts, the state of the MMU LUTs is very similar to when a KUP starts. LUT #3 is active and slots 0-4 are mapped to RAM banks 0-4. The program's entry point must be in this region. Slots 6 and 7 are mapped to the kernel, which is intact and usable right away. Slot 5 is currently undefined.

Testing a PGZ can be done by using FoenixMgr and the <code>xdev</code> firmware component. It can of course also be copied to a disk or SD card, and manually run it on the machine.

A PGZ cannot "return" to another program, it can either start a KUP (if the kernel is intact) or reset the machine.

The first byte of the file is a file signature and also a version tag. If the first byte is an upper case Z, the file is a 24-bit PGZ file (i.e. all addresses and sizes specified in the file are 24-bits). If the file is a lower case Z, the file is a 32-bit PGZ file (all address and sizes are 32-bits in
length). Note that all addresses and sizes are in little endian format (that is, least significant
byte first).

After the initial byte, the remainder of the PGZ file consists of segments, one after the other. Each segment consists of two or three fields:

{| class="wikitable"
!Field!!Size!!Description
|-
|address||3 ('''Z''') or 4 ('''z''') bytes||The target address for this segment
|-
|size||3 ('''Z''') or 4 ('''z''') bytes||The number of bytes in the data field
|-
|data||'''size''' bytes||The data to be loaded (optional)
|}

For a particular segment, if the size field is 0, there will be no bytes in the data field, and the segment specifies the starting address of the entire program. At least one such segment must be present in the PGZ file for it to be executable. If more than one is present, the last one will
be the one used to specify the starting address.

 ''Original Information Source:'' https://github.com/FoenixRetro/Documentation/blob/main/f256/programming-file-formats.md

Memory Management

2023-12-25T19:22:11Z

Draconian: changed to Expansion to be consistent

The F256 line comes with 512 KB of RAM and 512 KB of flash memory. Up to 256 KB additional Memory, either RAM or Flash, can be added through the [[Expansion Port]].

=== Physical Memory Layout ===

The address bus is 21 bits wide, allowing a total of 221 = 2 MB to be addressed.

{| class="wikitable"
!Address!!Purpose
|-
|$00:0000 - $07:FFFF||RAM
|-
|$80:0000 - $0F:FFFF||Flash
|-
|$10:0000 - $13:FFFF||Expansion Memory
|-
|$14:0000 - $1F:FFFF||Reserved
|}

=== Memory Management Unit (MMU) ===

While the address bus is generally 21 bits wide, the CPU address bus of the 65c02 and the FNX6809 is only 16 bits wide. Even though the 65816 does have a 24 bit wide address bus, it is currently not used. However, this might change with a future update.

To allow the addressing of the whole address space, 4 Memory Management Units (MMU) are provided, that translate the CPU logical address space to physical addresses.

To achieve this, each MMU has 8 slots, each representing an 8 KB block of the CPU addressable memory space.

The physical address space is also divided into 8 KB blocks, dividing the available 2 MB into 256 blocks.

To map a block of physical addresses into CPU address space, the block number is written into the according slot register of the MMU.

{| class="wikitable"
!Slot!!CPU Address Space!!Slot Register Address
|-
|0||$0000 - $1FFF|| $0008
|-
|1||$2000 - $3FFF|| $0009
|-
|2||$4000 - $5FFF|| $000A
|-
|3||$6000 - $7FFF|| $000B
|-
|4||$8000 - $9FFF|| $000C
|-
|5||$A000 - $BFFF|| $000D
|-
|6||$C000 - $DFFF|| $000E
|-
|7||$E000 - $FFFF|| $000F
|}

Only one MMU is active at any one time. To select the active MMU, the lower two bits of address $0001 are used.

Editing of MMUs is also controlled by $0001: Bits 4 and 5 determine which MMU is to be edited, while bit 7 has to be set to 1 to enable editing.
When editing is enable, the block number of a physical memory area can be written to the slot register address to map that area to the address in CPU address space. If editing is not enabled (bit 7 of $0001 is 0), the slot register addresses act as ordinary memory with no side effect.

=== Memory Block Tables ===
The following table shows which block number has to be written into a slot register to make the each 8 KB block of memory available to the CPU.

{| class="wikitable" style="border: none; background: none;"
! colspan=2 scope=col| RAM
| rowspan=66 style="border: none; background: none;" |
! colspan=2 scope=col| Flash
| rowspan=66 style="border: none; background: none;" |
! colspan=2 scope=col| Expansion
|-
! scope=col | Block Number
! scope=col | Physical Address

! scope=col | Block Number
! scope=col | Physical Address

! scope=col | Block Number
! scope=col | Physical Address
|-
|$00||$00:0000 - $00:FFFF||$40||$08:0000 - $08:1FFF||$80||$10:0000 - $10:1FFF
|-
|$01||$00:2000 - $00:3FFF||$41||$08:2000 - $08:3FFF||$81||$10:2000 - $10:3FFF
|-
|$02||$00:4000 - $00:5FFF||$42||$08:4000 - $08:5FFF||$82||$10:4000 - $10:5FFF
|-
|$03||$00:6000 - $00:7FFF||$43||$08:6000 - $08:7FFF||$83||$10:6000 - $10:7FFF
|-
|$04||$00:8000 - $00:9FFF||$44||$08:8000 - $08:9FFF||$84||$10:8000 - $10:9FFF
|-
|$05||$00:A000 - $00:BFFF||$45||$08:A000 - $08:BFFF||$85||$10:A000 - $10:BFFF
|-
|$06||$00:C000 - $00:DFFF||$46||$08:C000 - $08:DFFF||$86||$10:C000 - $10:DFFF
|-
|$07||$00:E000 - $00:FFFF||$47||$08:E000 - $08:FFFF||$87||$10:E000 - $10:FFFF
|-
|$08||$01:0000 - $01:1FFF||$48||$09:0000 - $09:1FFF||$88||$11:0000 - $11:1FFF
|-
|$09||$01:2000 - $01:3FFF||$49||$09:2000 - $09:3FFF||$89||$11:2000 - $11:3FFF
|-
|$0A||$01:4000 - $01:5FFF||$4A||$09:4000 - $09:5FFF||$8A||$11:4000 - $11:5FFF
|-
|$0B||$01:6000 - $01:7FFF||$4B||$09:6000 - $09:7FFF||$8B||$11:6000 - $11:7FFF
|-
|$0C||$01:8000 - $01:9FFF||$4C||$09:8000 - $09:9FFF||$8C||$11:8000 - $11:9FFF
|-
|$0D||$01:A000 - $01:BFFF||$4D||$09:A000 - $09:BFFF||$8D||$11:A000 - $11:BFFF
|-
|$0E||$01:C000 - $01:DFFF||$4E||$09:C000 - $09:DFFF||$8E||$11:C000 - $11:DFFF
|-
|$0F||$01:E000 - $01:FFFF||$4F||$09:E000 - $09:FFFF||$8F||$11:E000 - $11:FFFF
|-
|$10||$02:0000 - $02:1FFF||$50||$0A:0000 - $0A:1FFF||$90||$12:0000 - $12:1FFF
|-
|$11||$02:2000 - $02:3FFF||$51||$0A:2000 - $0A:3FFF||$91||$12:2000 - $12:3FFF
|-
|$12||$02:4000 - $02:5FFF||$52||$0A:4000 - $0A:5FFF||$92||$12:4000 - $12:5FFF
|-
|$13||$02:6000 - $02:7FFF||$53||$0A:6000 - $0A:7FFF||$93||$12:6000 - $12:7FFF
|-
|$14||$02:8000 - $02:9FFF||$54||$0A:8000 - $0A:9FFF||$94||$12:8000 - $12:9FFF
|-
|$15||$02:A000 - $02:BFFF||$55||$0A:A000 - $0A:BFFF||$95||$12:A000 - $12:BFFF
|-
|$16||$02:C000 - $02:DFFF||$56||$0A:C000 - $0A:DFFF||$96||$12:C000 - $12:DFFF
|-
|$17||$02:E000 - $02:FFFF||$57||$0A:E000 - $0A:FFFF||$97||$12:E000 - $12:FFFF
|-
|$18||$03:0000 - $03:1FFF||$58||$0B:0000 - $0B:1FFF||$98||$13:0000 - $13:1FFF
|-
|$19||$03:2000 - $03:3FFF||$59||$0B:2000 - $0B:3FFF||$99||$13:2000 - $13:3FFF
|-
|$1A||$03:4000 - $03:5FFF||$5A||$0B:4000 - $0B:5FFF||$9A||$13:4000 - $13:5FFF
|-
|$1B||$03:6000 - $03:7FFF||$5B||$0B:6000 - $0B:7FFF||$9B||$13:6000 - $13:7FFF
|-
|$1C||$03:8000 - $03:9FFF||$5C||$0B:8000 - $0B:9FFF||$9C||$13:8000 - $13:9FFF
|-
|$1D||$03:A000 - $03:BFFF||$5D||$0B:A000 - $0B:BFFF||$9D||$13:A000 - $13:BFFF
|-
|$1E||$03:C000 - $03:DFFF||$5E||$0B:C000 - $0B:DFFF||$9E||$13:C000 - $13:DFFF
|-
|$1F||$03:E000 - $03:FFFF||$5F||$0B:E000 - $0B:FFFF||$9F||$13:E000 - $13:FFFF
|-
|$20||$04:0000 - $04:1FFF||$60||$0C:0000 - $0C:1FFF
|-
|$21||$04:2000 - $04:3FFF||$61||$0C:2000 - $0C:3FFF
|-
|$22||$04:4000 - $04:5FFF||$62||$0C:4000 - $0C:5FFF
|-
|$23||$04:6000 - $04:7FFF||$63||$0C:6000 - $0C:7FFF
|-
|$24||$04:8000 - $04:9FFF||$64||$0C:8000 - $0C:9FFF
|-
|$25||$04:A000 - $04:BFFF||$65||$0C:A000 - $0C:BFFF
|-
|$26||$04:C000 - $04:DFFF||$66||$0C:C000 - $0C:DFFF
|-
|$27||$04:E000 - $04:FFFF||$67||$0C:E000 - $0C:FFFF
|-
|$28||$05:0000 - $05:1FFF||$68||$0D:0000 - $0D:1FFF
|-
|$29||$05:2000 - $05:3FFF||$69||$0D:2000 - $0D:3FFF
|-
|$2A||$05:4000 - $05:5FFF||$6A||$0D:4000 - $0D:5FFF
|-
|$2B||$05:6000 - $05:7FFF||$6B||$0D:6000 - $0D:7FFF
|-
|$2C||$05:8000 - $05:9FFF||$6C||$0D:8000 - $0D:9FFF
|-
|$2D||$05:A000 - $05:BFFF||$6D||$0D:A000 - $0D:BFFF
|-
|$2E||$05:C000 - $05:DFFF||$6E||$0D:C000 - $0D:DFFF
|-
|$2F||$05:E000 - $05:FFFF||$6F||$0D:E000 - $0D:FFFF
|-
|$30||$06:0000 - $06:1FFF||$70||$0E:0000 - $0E:1FFF
|-
|$31||$06:2000 - $06:3FFF||$71||$0E:2000 - $0E:3FFF
|-
|$32||$06:4000 - $06:5FFF||$72||$0E:4000 - $0E:5FFF
|-
|$33||$06:6000 - $06:7FFF||$73||$0E:6000 - $0E:7FFF
|-
|$34||$06:8000 - $06:9FFF||$74||$0E:8000 - $0E:9FFF
|-
|$35||$06:A000 - $06:BFFF||$75||$0E:A000 - $0E:BFFF
|-
|$36||$06:C000 - $06:DFFF||$76||$0E:C000 - $0E:DFFF
|-
|$37||$06:E000 - $06:FFFF||$77||$0E:E000 - $0E:FFFF
|-
|$38||$07:0000 - $07:1FFF||$78||$0F:0000 - $0F:1FFF
|-
|$39||$07:2000 - $07:3FFF||$79||$0F:2000 - $0F:3FFF
|-
|$3A||$07:4000 - $07:5FFF||$7A||$0F:4000 - $0F:5FFF
|-
|$3B||$07:6000 - $07:7FFF||$7B||$0F:6000 - $0F:7FFF
|-
|$3C||$07:8000 - $07:9FFF||$7C||$0F:8000 - $0F:9FFF
|-
|$3D||$07:A000 - $07:BFFF||$7D||$0F:A000 - $0F:BFFF
|-
|$3E||$07:C000 - $07:DFFF||$7E||$0F:C000 - $0F:DFFF
|-
|$3F||$07:E000 - $07:FFFF||$7F||$0F:E000 - $0F:FFFF
|}

File Formats

2023-12-22T19:53:28Z

Draconian: update the KUP header sample

The F256 line has three file formats, each with slightly different properties and use cases. Additionally, pure binary files are often used by developers. The machine will be in a slightly different state, depending on how the program was started. We will cover this in the following sections.

== Binary ==
The binary file format is not a format as such. It is an image that is loaded directly into the F256's memory by a utility program running on the PC or Mac, and the F256 is then reset. Such an image must include properly initialized interrupt vectors, especially the RESET vector.

Running such an image requires knowledge of its starting address and a properly configured USB connection between the PC or Mac and the F256. Also, a jumper on the F256 Jr. motherboard must be moved to the "Boot-to-RAM" position. This is not necessary on the F256K.

Binary images should only be used by the developer while developing, as it is a very user-unfriendly method of distributing software, requiring tethering to a PC or Mac.

== KUP - Kernel User Program ==
KUPs are very simple and can contain 40 KiB code/data when run from flash, or 32 KiB when run from disk. Contained in their header is an entry point address, and the slot number of where they should be mapped into, the first possible slot being #1 ($2000).

DOS expands on the KUP header defined by the MicroKernel in a backwards compatible way.

The header is very simple:

<pre>
Byte 0 signature: $F2
Byte 1 signature: $56
Byte 2 the size of program in 8k blocks
Byte 3 the starting slot of the program (i.e. where to map it)
Bytes 4-5 the start address of the program
Byte 6 header structure version (indicates version of header, current 0 or 1)
Bytes 7-9 reserved
Bytes 10-? zero-terminated name of the program.
Bytes ?-? zero-terminated string describing the arguments. (in version >= 1)
Bytes ?-? zero-terminated string describing the program's function. (in version >= 1)
</pre>

Example of a header block definition:

<pre>
EXEC = __STARTUP_LOAD__
SLOT = __STARTUP_LOAD__ >> 13
COUNT = __END_LOAD__ >> 13 ; Assumes code starts at $2000.

.byte $f2,$56 ; signature
.byte <COUNT ; block count
.byte <SLOT ; start slot
.word EXEC ; exec addr
.byte 1 ; CHANGED, structure version
.byte 0 ; reserved
.byte 0 ; reserved
.byte 0 ; reserved
.asciiz "cwrite" ; name
.asciiz " "
.asciiz "App to program the Flash Cartridge"

.segment "END"
</pre>

The MicroKernel ignores the "argument" and "function" header entries. These are printed by DOS' <code>lsf</code> command, and only if the header version is greater or equal to 1.

When instructed to start a named KUP, the kernel will search through memory to find a match. First the expansion memory is searched, this could be either RAM or ROM. Then the on-board flash memory is searched. If DIP switch #1 is in the "on" position, the kernel will search memory banks 1-5 before the expansion blocks.

This sequence is also performed when the kernel starts up, for instance when the machine is reset or is first powered on.

Testing a KUP is therefore as easy as uploading it to a block of memory, and is an excellent choice for testing a program that interacts with the kernel. Though you should remember that this program will stay in memory as long as the machine is powered on, and may also survive a short power cut. Such a program should therefore, when testing, destroy its own header by overwriting the first two bytes with some values that are not the magic signature, to avoid being started again and again.

A KUP residing in flash does not "return" in the common sense of the word. If it has to terminate, it can either reset the machine, or use `RunNamed` to start another KUP.

On the other hand, when running a KUP from disk, it is able to return to DOS in a controlled manner. Distributing software intended to be run from disk as KUP is usually discouraged, as the program can only be started from DOS and not from SuperBASIC. It can, however, be appropriate for small utility programs mostly intended for maintenance tasks and so forth. When distributing software, you should prefer using one of the PGX or PGZ formats.

A KUP loaded from disk may exit back to DOS by issuing an RTS instruction. Additionally, the carry may be set if the machine should be reset, or carry clear to continue running DOS. Be aware that you must leave the MMU configuration in the state you found it for this to work properly. You should also keep away from the $0200-$07FF range completely.

When a KUP is started from flash, LUT #3 slots 0-5 is mapped to RAM banks 0-5, *except* where the KUP's header specifies where into should be mapped.

A KUP started from disk has LUT #3 slots 0-4 mapped to RAM, some of which will be the program itself.

In both cases the kernel is intact and available for use straight away.

== PGX ==
This format is a simple, single segment executable, which can be loaded as low as $0200. A PGX is loaded using <code>pexec</code>. <code>pexec</code> treats PGX and PGZ in exactly the same way, and information on how PGZ is handled also applies to PGX.

PGZ is similar in scale to MS-DOS’s COM format, or the Commodore PRG format. It consists of a single segment of data to be loaded to
a specific address, where that address is also the starting address.

PGX starts with a header to identify the file and the starting address:

* The first three bytes are the ASCII codes for “PGX”.
* The fourth byte is the CPU and version identification byte. Bits 0 through 3 represent the CPU code, and bits 4 through 7 represent the version of PGX supported. At the moment, there is just version 0. The CPU code can be 1 for the WDC65816, or 2 for the M680x0.
* The next four bytes (that is, bytes 4 through 7) are the address of the destination, in big-endian format (most significant byte first). This address is both the address of the location in which to load the first byte of the data and is also the starting address for the file.

All bytes after the header are the contents of the file to be loaded into memory.

== PGZ ==
This is a more advanced multi-segment executable. It can be loaded as low as $0200. It is loaded using <code>pexec</code>.

When <code>pexec</code> loads a program, the program must not load itself into RAM banks 6 & 7, as these are used by the kernel, and the kernel is doing the actual loading. If the program does not need the kernel, it may of course utilize these banks once it is running. <code>pexec</code> is otherwise able to load code and data into anywhere in physical memory.

When the program starts, the state of the MMU LUTs is very similar to when a KUP starts. LUT #3 is active and slots 0-4 are mapped to RAM banks 0-4. The program's entry point must be in this region. Slots 6 and 7 are mapped to the kernel, which is intact and usable right away. Slot 5 is currently undefined.

Testing a PGZ can be done by using FoenixMgr and the <code>xdev</code> firmware component. It can of course also be copied to a disk or SD card, and manually run it on the machine.

A PGZ cannot "return" to another program, it can either start a KUP (if the kernel is intact) or reset the machine.

The first byte of the file is a file signature and also a version tag. If the first byte is an upper case Z, the file is a 24-bit PGZ file (i.e. all addresses and sizes specified in the file are 24-bits). If the file is a lower case Z, the file is a 32-bit PGZ file (all address and sizes are 32-bits in
length). Note that all addresses and sizes are in little endian format (that is, least significant
byte first).

After the initial byte, the remainder of the PGZ file consists of segments, one after the other. Each segment consists of two or three fields:

{| class="wikitable"
!Field!!Size!!Description
|-
|address||3 ('''Z''') or 4 ('''z''') bytes||The target address for this segment
|-
|size||3 ('''Z''') or 4 ('''z''') bytes||The number of bytes in the data field
|-
|data||'''size''' bytes||The data to be loaded (optional)
|}

For a particular segment, if the size field is 0, there will be no bytes in the data field, and the segment specifies the starting address of the entire program. At least one such segment must be present in the PGZ file for it to be executable. If more than one is present, the last one will
be the one used to specify the starting address.

 ''Original Information Source:'' https://github.com/FoenixRetro/Documentation/blob/main/f256/programming-file-formats.md

File Formats

2023-12-22T19:47:20Z

Draconian: definition for KUP

The F256 line has three file formats, each with slightly different properties and use cases. Additionally, pure binary files are often used by developers. The machine will be in a slightly different state, depending on how the program was started. We will cover this in the following sections.

== Binary ==
The binary file format is not a format as such. It is an image that is loaded directly into the F256's memory by a utility program running on the PC or Mac, and the F256 is then reset. Such an image must include properly initialized interrupt vectors, especially the RESET vector.

Running such an image requires knowledge of its starting address and a properly configured USB connection between the PC or Mac and the F256. Also, a jumper on the F256 Jr. motherboard must be moved to the "Boot-to-RAM" position. This is not necessary on the F256K.

Binary images should only be used by the developer while developing, as it is a very user-unfriendly method of distributing software, requiring tethering to a PC or Mac.

== KUP - Kernel User Program ==
KUPs are very simple and can contain 40 KiB code/data when run from flash, or 32 KiB when run from disk. Contained in their header is an entry point address, and the slot number of where they should be mapped into, the first possible slot being #1 ($2000).

DOS expands on the KUP header defined by the MicroKernel in a backwards compatible way.

The header is very simple:

<pre>
Byte 0 signature: $F2
Byte 1 signature: $56
Byte 2 the size of program in 8k blocks
Byte 3 the starting slot of the program (ie where to map it)
Bytes 4-5 the start address of the program
Byte 6 header structure version (indicates version of header, current 0 or 1)
Bytes 7-9 reserved
Bytes ?-? zero-terminated name of the program.
Bytes ?-? zero-terminated string describing the arguments. (in version >= 1)
Bytes ?-? zero-terminated string describing the program's function. (in version >= 1)
</pre>

Example of a header block definition:

<pre>
EXEC = __STARTUP_LOAD__
SLOT = __STARTUP_LOAD__ >> 13
COUNT = __END_LOAD__ >> 13 ; Assumes code starts at $2000.

.byte $f2,$56 ; signature
.byte <COUNT ; block count
.byte <SLOT ; start slot
.word EXEC ; exec addr
.byte 1 ; CHANGED, structure version
.byte 0 ; reserved
.byte 0 ; reserved
.byte 0 ; reserved
.asciiz "cwrite" ; name
.asciiz " "
.asciiz "App to program the Flash Cartridge"

.segment "END"
</pre>

The MicroKernel ignores the "argument" and "function" header entries. These are printed by DOS' <code>lsf</code> command, and only if the header version is greater or equal to 1.

When instructed to start a named KUP, the kernel will search through memory to find a match. First the expansion memory is searched, this could be either RAM or ROM. Then the on-board flash memory is searched. If DIP switch #1 is in the "on" position, the kernel will search memory banks 1-5 before the expansion blocks.

This sequence is also performed when the kernel starts up, for instance when the machine is reset or is first powered on.

Testing a KUP is therefore as easy as uploading it to a block of memory, and is an excellent choice for testing a program that interacts with the kernel. Though you should remember that this program will stay in memory as long as the machine is powered on, and may also survive a short power cut. Such a program should therefore, when testing, destroy its own header by overwriting the first two bytes with some values that are not the magic signature, to avoid being started again and again.

A KUP residing in flash does not "return" in the common sense of the word. If it has to terminate, it can either reset the machine, or use `RunNamed` to start another KUP.

On the other hand, when running a KUP from disk, it is able to return to DOS in a controlled manner. Distributing software intended to be run from disk as KUP is usually discouraged, as the program can only be started from DOS and not from SuperBASIC. It can, however, be appropriate for small utility programs mostly intended for maintenance tasks and so forth. When distributing software, you should prefer using one of the PGX or PGZ formats.

A KUP loaded from disk may exit back to DOS by issuing an RTS instruction. Additionally, the carry may be set if the machine should be reset, or carry clear to continue running DOS. Be aware that you must leave the MMU configuration in the state you found it for this to work properly. You should also keep away from the $0200-$07FF range completely.

When a KUP is started from flash, LUT #3 slots 0-5 is mapped to RAM banks 0-5, *except* where the KUP's header specifies where into should be mapped.

A KUP started from disk has LUT #3 slots 0-4 mapped to RAM, some of which will be the program itself.

In both cases the kernel is intact and available for use straight away.

== PGX ==
This format is a simple, single segment executable, which can be loaded as low as $0200. A PGX is loaded using <code>pexec</code>. <code>pexec</code> treats PGX and PGZ in exactly the same way, and information on how PGZ is handled also applies to PGX.

PGZ is similar in scale to MS-DOS’s COM format, or the Commodore PRG format. It consists of a single segment of data to be loaded to
a specific address, where that address is also the starting address.

PGX starts with a header to identify the file and the starting address:

* The first three bytes are the ASCII codes for “PGX”.
* The fourth byte is the CPU and version identification byte. Bits 0 through 3 represent the CPU code, and bits 4 through 7 represent the version of PGX supported. At the moment, there is just version 0. The CPU code can be 1 for the WDC65816, or 2 for the M680x0.
* The next four bytes (that is, bytes 4 through 7) are the address of the destination, in big-endian format (most significant byte first). This address is both the address of the location in which to load the first byte of the data and is also the starting address for the file.

All bytes after the header are the contents of the file to be loaded into memory.

== PGZ ==
This is a more advanced multi-segment executable. It can be loaded as low as $0200. It is loaded using <code>pexec</code>.

When <code>pexec</code> loads a program, the program must not load itself into RAM banks 6 & 7, as these are used by the kernel, and the kernel is doing the actual loading. If the program does not need the kernel, it may of course utilize these banks once it is running. <code>pexec</code> is otherwise able to load code and data into anywhere in physical memory.

When the program starts, the state of the MMU LUTs is very similar to when a KUP starts. LUT #3 is active and slots 0-4 are mapped to RAM banks 0-4. The program's entry point must be in this region. Slots 6 and 7 are mapped to the kernel, which is intact and usable right away. Slot 5 is currently undefined.

Testing a PGZ can be done by using FoenixMgr and the <code>xdev</code> firmware component. It can of course also be copied to a disk or SD card, and manually run it on the machine.

A PGZ cannot "return" to another program, it can either start a KUP (if the kernel is intact) or reset the machine.

The first byte of the file is a file signature and also a version tag. If the first byte is an upper case Z, the file is a 24-bit PGZ file (i.e. all addresses and sizes specified in the file are 24-bits). If the file is a lower case Z, the file is a 32-bit PGZ file (all address and sizes are 32-bits in
length). Note that all addresses and sizes are in little endian format (that is, least significant
byte first).

After the initial byte, the remainder of the PGZ file consists of segments, one after the other. Each segment consists of two or three fields:

{| class="wikitable"
!Field!!Size!!Description
|-
|address||3 ('''Z''') or 4 ('''z''') bytes||The target address for this segment
|-
|size||3 ('''Z''') or 4 ('''z''') bytes||The number of bytes in the data field
|-
|data||'''size''' bytes||The data to be loaded (optional)
|}

For a particular segment, if the size field is 0, there will be no bytes in the data field, and the segment specifies the starting address of the entire program. At least one such segment must be present in the PGZ file for it to be executable. If more than one is present, the last one will
be the one used to specify the starting address.

 ''Original Information Source:'' https://github.com/FoenixRetro/Documentation/blob/main/f256/programming-file-formats.md

File Formats

2023-12-18T07:09:18Z

Draconian:

The F256 line has three file formats, each with slightly different properties and use cases. Additionally, pure binary files are often used by developers. The machine will be in a slightly different state, depending on how the program was started. We will cover this in the following sections.

== Binary ==
The binary file format is not a format as such. It is an image that is loaded directly into the F256's memory by a utility program running on the PC or Mac, and the F256 is then reset. Such an image must include properly initialized interrupt vectors, especially the RESET vector.

Running such an image requires knowledge of its starting address and a properly configured USB connection between the PC or Mac and the F256. Also, a jumper on the F256 Jr. motherboard must be moved to the "Boot-to-RAM" position. This is not necessary on the F256K.

Binary images should only be used by the developer while developing, as it is a very user-unfriendly method of distributing software, requiring tethering to a PC or Mac.

== KUP ==
KUPs are very simple and can contain 40 KiB code/data when run from flash, or 32 KiB when run from disk. Contained in their header is an entry point address, and the slot number of where they should be mapped into, the first possible slot being #1 ($2000).

DOS expands on the KUP header defined by the MicroKernel in a backwards compatible way.

The header is very simple:

<pre>
Byte 0 signature: $F2
Byte 1 signature: $56
Byte 2 the size of program in 8k blocks
Byte 3 the starting slot of the program (ie where to map it)
Bytes 4-5 the start address of the program
Byte 6 header structure version (indicates version of header, current 0 or 1)
Bytes 7-9 reserved
Bytes ?-? zero-terminated name of the program.
Bytes ?-? zero-terminated string describing the arguments. (in version >= 1)
Bytes ?-? zero-terminated string describing the program's function. (in version >= 1)
</pre>

Example of a header block definition:

<pre>
EXEC = __STARTUP_LOAD__
SLOT = __STARTUP_LOAD__ >> 13
COUNT = __END_LOAD__ >> 13 ; Assumes code starts at $2000.

.byte $f2,$56 ; signature
.byte <COUNT ; block count
.byte <SLOT ; start slot
.word EXEC ; exec addr
.byte 1 ; CHANGED, structure version
.byte 0 ; reserved
.byte 0 ; reserved
.byte 0 ; reserved
.asciiz "cwrite" ; name
.asciiz " "
.asciiz "App to program the Flash Cartridge"

.segment "END"
</pre>

The MicroKernel ignores the "argument" and "function" header entries. These are printed by DOS' <code>lsf</code> command, and only if the header version is greater or equal to 1.

When instructed to start a named KUP, the kernel will search through memory to find a match. First the expansion memory is searched, this could be either RAM or ROM. Then the on-board flash memory is searched. If DIP switch #1 is in the "on" position, the kernel will search memory banks 1-5 before the expansion blocks.

This sequence is also performed when the kernel starts up, for instance when the machine is reset or is first powered on.

Testing a KUP is therefore as easy as uploading it to a block of memory, and is an excellent choice for testing a program that interacts with the kernel. Though you should remember that this program will stay in memory as long as the machine is powered on, and may also survive a short power cut. Such a program should therefore, when testing, destroy its own header by overwriting the first two bytes with some values that are not the magic signature, to avoid being started again and again.

A KUP residing in flash does not "return" in the common sense of the word. If it has to terminate, it can either reset the machine, or use `RunNamed` to start another KUP.

On the other hand, when running a KUP from disk, it is able to return to DOS in a controlled manner. Distributing software intended to be run from disk as KUP is usually discouraged, as the program can only be started from DOS and not from SuperBASIC. It can, however, be appropriate for small utility programs mostly intended for maintenance tasks and so forth. When distributing software, you should prefer using one of the PGX or PGZ formats.

A KUP loaded from disk may exit back to DOS by issuing an RTS instruction. Additionally, the carry may be set if the machine should be reset, or carry clear to continue running DOS. Be aware that you must leave the MMU configuration in the state you found it for this to work properly. You should also keep away from the $0200-$07FF range completely.

When a KUP is started from flash, LUT #3 slots 0-5 is mapped to RAM banks 0-5, *except* where the KUP's header specifies where into should be mapped.

A KUP started from disk has LUT #3 slots 0-4 mapped to RAM, some of which will be the program itself.

In both cases the kernel is intact and available for use straight away.

== PGX ==
This format is a simple, single segment executable, which can be loaded as low as $0200. A PGX is loaded using <code>pexec</code>. <code>pexec</code> treats PGX and PGZ in exactly the same way, and information on how PGZ is handled also applies to PGX.

PGZ is similar in scale to MS-DOS’s COM format, or the Commodore PRG format. It consists of a single segment of data to be loaded to
a specific address, where that address is also the starting address.

PGX starts with a header to identify the file and the starting address:

* The first three bytes are the ASCII codes for “PGX”.
* The fourth byte is the CPU and version identification byte. Bits 0 through 3 represent the CPU code, and bits 4 through 7 represent the version of PGX supported. At the moment, there is just version 0. The CPU code can be 1 for the WDC65816, or 2 for the M680x0.
* The next four bytes (that is, bytes 4 through 7) are the address of the destination, in big-endian format (most significant byte first). This address is both the address of the location in which to load the first byte of the data and is also the starting address for the file.

All bytes after the header are the contents of the file to be loaded into memory.

== PGZ ==
This is a more advanced multi-segment executable. It can be loaded as low as $0200. It is loaded using <code>pexec</code>.

When <code>pexec</code> loads a program, the program must not load itself into RAM banks 6 & 7, as these are used by the kernel, and the kernel is doing the actual loading. If the program does not need the kernel, it may of course utilize these banks once it is running. <code>pexec</code> is otherwise able to load code and data into anywhere in physical memory.

When the program starts, the state of the MMU LUTs is very similar to when a KUP starts. LUT #3 is active and slots 0-4 are mapped to RAM banks 0-4. The program's entry point must be in this region. Slots 6 and 7 are mapped to the kernel, which is intact and usable right away. Slot 5 is currently undefined.

Testing a PGZ can be done by using FoenixMgr and the <code>xdev</code> firmware component. It can of course also be copied to a disk or SD card, and manually run it on the machine.

A PGZ cannot "return" to another program, it can either start a KUP (if the kernel is intact) or reset the machine.

The first byte of the file is a file signature and also a version tag. If the first byte is an upper case Z, the file is a 24-bit PGZ file (i.e. all addresses and sizes specified in the file are 24-bits). If the file is a lower case Z, the file is a 32-bit PGZ file (all address and sizes are 32-bits in
length). Note that all addresses and sizes are in little endian format (that is, least significant
byte first).

After the initial byte, the remainder of the PGZ file consists of segments, one after the other. Each segment consists of two or three fields:

{| class="wikitable"
!Field!!Size!!Description
|-
|address||3 ('''Z''') or 4 ('''z''') bytes||The target address for this segment
|-
|size||3 ('''Z''') or 4 ('''z''') bytes||The number of bytes in the data field
|-
|data||'''size''' bytes||The data to be loaded (optional)
|}

For a particular segment, if the size field is 0, there will be no bytes in the data field, and the segment specifies the starting address of the entire program. At least one such segment must be present in the PGZ file for it to be executable. If more than one is present, the last one will
be the one used to specify the starting address.

 ''Original Information Source:'' https://github.com/FoenixRetro/Documentation/blob/main/f256/programming-file-formats.md

Hardware

2023-12-18T07:06:46Z

Draconian:

=== Overview and Comparison ===
{| class="wikitable"
|+
!
!F256Jr
!F256K
|-
|CPU
|WDC 65C02
WDC 65816S
FNX 6809
|WDC 65C02
WDC 65816S
FNX 6809
|-
|RAM
|512 KB
Optional 256K RAM expansion module available
|512 KB
Optional 256K RAM expansion module available
|-
|Flash
|512 KB
Optional 256K Flash Modules
|512 KB
Optional 256K Flash Modules
|-
|Graphic Chip
|TinyVicky
|TinyVicky
|-
|Audio
|2 x PSG (Sn76489)
2 x SID socket
|2 x PSG
2 x SID hardware emulation on board
OPL3
CODEC
|-
|Connections
|1 x DVI (digital & analog)
1 x PS2 (Mouse / External Keyboard)
1 x Commodore syle IEC Port
1 x Headphone 3,5
1 x RCA Line Out
2 x Serial Port Pin-Header
1 x Mni USB Debug Port
1 x Power 12V / 2A, 2,5mm Barrel Connector
1 x SD Card Slot
2 x Joystick Atari style Pin-Header
1 x PIN-Header onboard for SNES/NES Joystick Connector Box
1 x RAM Expansion Slot (on Top)
1 x JTAG Port for system updates (on bottom)
1 x Wifi Module ESP32 Feather (internal)
1 x Real Time Clock Battery CR2032 (internal)
|1 x DVI (digital & analog)
1 x PS2 (Mouse / External Keyboard)
1 x Commodore syle IEC Port
1 x Headphone 3,5
1 x RCA Line Out
1 x Serial Port DB9M / 1 x Serial Pin Header
1 x Mni USB Debug Port
1 x Power 12V / 2A, 2,5mm Barrel Connector
1 x SD Card Slot
2 x Joystick Atari style DB9 Connector
1 x Mini-DIN9 for SNES/NES Joystick Connector Box
1 x RAM Expansion Slot (on Top)
1 x JTAG Port for system updates (on bottom)
1 x Wifi Module ESP32 Feather (internal)
1 x Real Time Clock Battery CR2032 (internal)
|}

=== Details ===

===== CPU =====
The basic setup of all F256 is the [https://westerndesigncenter.com/ Western Design Center] '''65C02''', a slightly enhanced CMOS version of the very popular 6502 CPUs. The main difference to the 6502 in the 1970s and 1980s is the faster clock speed and the lower power consumption.

The 65C02 can also be replaced with a 65816 as a drop in replacement. The 65816

In the F256, the CPU is always clocked at 6,29 MHz (6,293,750 Hz to be exact, derived from 25.175 MHz / 4 as discussed on [https://discord.com/channels/691915291721990194/1054250056703815680/1177306520925524018 Discord]).