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

Software for 6502

2026-05-28T15:52:51Z

1BitFeverDreams: /* Music */ firejam v1.5

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
|-
|S.P.O.T.
|Satellite Position and Orbital Tracking: network driven representation of the position of the ISS (international space station) from data on the internet
|Mike C
|basic
|https://github.com/mcassera/SPOT
|-
|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
|-
|hackGfx
|Tile scrolling red pixels demo with short opl3 playback loop
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/hackGfx.pgz
* spacebar to toggle text
* S to toggle music
* backarrow to quit
it requires sshockt.vgm located in media/vgm/ in order to work with the music

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sshockt.vgm
|-
|gfxDemo
|Vicky graphics layer demo showcasing: mouse, reg text mode, mem text mode, 3 bitmaps, 3 tiles, sprites, palette swaps
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/gfxDemo.pgz<nowiki/>this is v0.9, the memtext layer is buggy and L0 and L1 for tiles are absent for now.
|-
|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
|-
|pendulum
|Sprite and MIDI demo
|MikeC
|pgz
|https://github.com/mcassera/pendulum
|-
|rpg-demo
|A Vicky graphic layers demos of sprites and layers, controlled by joy2
|econtrerasd
|basic
|unzip the following zip file into the root of your SD card. By doing so, various asset files will be put into the directories media/palettes/, media/tiles/ and media/sprites/. the .bas itself can be put anywhere.
https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/rpg-demo.zip
|-
|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.7 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

has a light show using all four RGB case LEDs of the K2 (might break compatibility with Jr2? test it please!)
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.5 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. Hit the [WLD] / [FNX] key to toggle playing with the typing keyboard.

v1.5 is here https://github.com/Mu0n/WildbitsOscar64CDoodles/tree/main/releases

older v1.2 is here 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.1 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://github.com/econtrerasd/testSuite-F256/releases
|
|-
|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
|-
|MikeC repos
|Various projects in assembly
|MikeC
|read github
|https://github.com/mcassera
|-
|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
|}

FPGA Releases

2026-05-25T13:36:16Z

1BitFeverDreams: /* How to Upgrade the FPGA for the F256K2 */ μSD instead of uSD and K2 instead of F256K2

# move the FG & BG Text LUT to:

=== Important: ===
Most users will want to consume the "Firmware package relases" (taken from here: https://github.com/FoenixRetro/f256-firmware/releases. ) which contain both the latest of the FPGA releases seen here on this page, and the kernel/base programs intended for the flash memory. The page you're ready here is meant for power user who would want to test back compatibility or attempt some roll-backs in case bugs are found, and for readers who want to learn about the release notes of each new FPGA version.

''(* "Purple" refers to the official 2025+ release of the K2; "Black" refers to the first run of K2B boards sent out to the original F256K owners in late 2024)''

=== Latest FPGA core files for all platforms ===
{| class="wikitable"
! colspan="3" |
==== <big>F256Jr2</big> ====
!
! colspan="3" |
==== <big>F256K2</big> ====
|-
!Core
!Link
!Notes
!
!Core
!Link
!Notes
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/Jr2/Classic/2025-01-07/F256Jr2_MMU_Jan8th_2025_OPL3.mcs 08-Jan-2025]
|OPL3 added
!
|6502 MMU
|Black*: [https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K2/CNTX1/2025-02-02/CFP95600C.bin 02-Feb-2025]
Purple*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2Purple/CNTX1/CFP95600C.bin 05-Feb-2025]
|fix Onboard Access to a SPI Flash
LCD Splash Screen
|-
|65816 Ext
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/Jr2/Extended/2024-12-21/F256Jr2_Ext16_Dec21st_2024.mcs 21-Dec-2024]
|Implementation of the 256Bytes
Copy from Flash to RAM before booting.
!
|65816 Ext
|Black*: [https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K2/CNTX2/2025-01-07/CFP95616E.bin 07-Jan-2025]
Purple*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2Purple/CNTX2/CFP95616E.bin 06-Jan-2025]
|Updated access to WS6100
UART for the VS1053B
|-
|65816 Ext 2x
|[https://c256foenix.com/product-category/gen2-core/?v=5435c69ed3bc Buy Here]
|2x CPU speed
layer of 16 bit colored text

hardware line drawing

64 more sprites.
!
|65816 Ext 2x
|Black*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2/CNTX4/F256K2x_Cores_Foenix138_BlackBoard_B3B_July27th_2025.bin 27-Jul-2025]
Purple*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2/CNTX4/F256K2x_Cores_Foenix138_B0C_August4th_2025.bin 4-Aug-2025]
|2x CPU speed
layer of 16 bit colored text

hardware line drawing

64 more sprites.
|-
|6809
|[https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/Jr2/6809/2025-06-15/F256JrJr_FNX6809_June14th_RC0014_0003.mcs 15-Jun-2025]
|WIFI Speed and Interface (added TX_Empty & RX_Empty Flag)
!
|6809
|Black*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2/CNTX3/NitrOS9_Load_BlackBoardB3B_WifiFixed_Sept4th.bin 04-Sep-2025]
Purple*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2Purple/CNTX3/NitrOS9_Load_PurpleBoardB0C_WifiFixed_Sept4th.bin 04-Sep-2025]
|Wifi fix
|-
! colspan="3" |
==== <big>F256Jr</big> ====
!
! colspan="3" |
==== <big>F256K</big> ====
|-
!Core
!Link
!Notes
!
!Core
!Link
!Notes
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/Jr/Classic/F256M_Wbh_Jan26th_2025_RC20_0100.jic 26-Jan-2025]
|fixes Overlay FONT on top of graphic
with Background Color Enabled
!
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K/F256Kc_WBh_Jan26th_2025_RC16_0001.jic 26-Jan-2025]
|fixes Overlay FONT on top of graphic
with Background Color Enabled
|-
|65816 Ext 2x
|[https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/Jr/Extended/F256M_Wbh_Jun24th_2025_RC0100_0002.jic 24-Jun-2025]
|Fixed bugs with register 0x0000 and 0x0001
!
|65816 Ext 2x
|[https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K/F256Kc_WBh_Jun23th_RC0100_0003_DualSpeed_CPU.jic 23-Jun-2025]
|Fixed bugs with register 0x0000 and 0x0001
|}

=== Previous FPGA core files for all platforms ===
Use these for testing out older softwares and snooping around for persistant issues.
{| class="wikitable"
|+
! colspan="3" |
==== <big>Previous F256Jr2 Cores</big> ====
|-
!Core
!Link
!Notes
|-
|6809
|[https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/Jr2/6809/2025-06-13/F256Jr2_FNX6809_June13th_RC0017_0002.mcs 13-Jun-2025]
|Move the FG & BG Text LUT to:

$18_3800 $18_383F TEXT_LUT_FG

$18_3840 $18_387F TEXT_LUT_BG
|-
|6809
|[https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/Jr2/6809/2025-06-11/F256Jr2_FNX6809_June11th_RC0017_0000.mcs 11-Jun-2025]
|big Wishlist
full access to write back the onboard flash
|-
|6809
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/Jr2/6809/2025-01-17/F256Jr2_FNX6809_Jan17th_RC0014_0002.mcs 17-Jan-2025]
|Fix for the manual Reset
Fix for the readback of Multiplication Values

Endianess

Changes to: Line/Pixel Position
|}

{| class="wikitable"
|+
! colspan="3" |
==== <big>Previous</big> <big>F256K2</big> <big>Cores</big> ====
|-
!Core
!Link
!Notes
|-
|6502 MMU
|Black*: [https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K2/CNTX1/2025-01-08/CFP95600C.bin 08-Jan-2025]
Purple*: n/a
|OPL3 implemented
|-
|6502 MMU
|Black*: [https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K2/CNTX1/2025-01-07/CFP95600C.bin 07-Jan-2025]
Purple*: n/a
|Instantiation of the UART for the VS1053B @ $DDB0
|-
|6809
|Black*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2/CNTX3/K2_NitrOS9_Load_BlackBoard_Aug26th.bin 26-Aug-2025]
Purple*: [https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K2Purple/CNTX3/FNX6809_First_Release_Aug24th_PurpleBoard.bin 24-Aug-2025]
|This is the preliminary version and only works with a PS/2 keyboard plugged in.
If destined for slot 3, rename the file and put in CNTX3/f256k2t9.bin
|}

{| class="wikitable"
|+
! colspan="3" |
==== <big>Previous F256Jr Cores</big> ====
|-
!Core
!Link
!Notes
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/Jr/Classic/F256M_Wbh_Dec23rd_2023_RC18_0100.jic 23-Dec-2023]
|Tiles fix; shifted by one towards the left.
(0100 = Serial RAM/Flash Select)
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/Jr/Classic/F256M_Wbh_Nov18th_2023_RC17_0100.jic 18-Nov-2023]
|In light of decision to dump the big ticket items and the accessories from the store...

* Removed the very SPI core introduced yesterday to drive the FNXNET51 module.
* Removed the DP memory for the MMU and replace it back with simple Registers, which means that when you reset the system, the MMU, Page0 will be reset back to the way it was. However, the caveat is that if you change between RAM to FLASH MMU default value, you need to do a reset, either a debug reset or General Reset because the MMU is now only 32bytes in Size, so, 4 pages of 8 values.
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/Jr/Classic/F256M_WBh_Nov17th_2023_RC16_0111.jic 17-Nov-2023]
|
* No Write Allowed when Debug Port writes in the MMU Memory Zone
* Incorporation of a new SPI Controller to interface with the FNXNET51 module using the NES/SNES MiniDin9 Connector
* ReSync of the Debug Generated RDY to stop the CPU. (untested)
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/tree/main/fpga/Jr/Classic various older]
|
|-
|65816 Ext 2x
|[https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/Jr/Extended/F256M_Wbh_Jun17th_2025_RC0100_0001.jic 16-Jun-2025]
|CPU runs at 2x speed at 12 MHz
MUST use a 65816 cpu chip,

will not work with the 6502
|-
|6809
|n/a
|n/a
|}

{| class="wikitable"
|+
! colspan="3" |
==== <big>Previous</big> <big>F256K</big> <big>Cores</big> ====
|-
!Core
!Link
!Notes
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K/2024-12-23/F256K_WBh_Dec23rd_RevB0x_RC14_0000.jic 23-Dec-2023]

|Tiles fix; shifted by one towards the left.
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K/F256K_WBh_Dec9th_RevB0x_RC13_0000.jic 09-Dec-2023]
|
* Fixes a problem with Interrupt from timer0 that was working on the Jr.
* Resolves a discrepancy between the F256Jr interrupt block and the F256K.
|-
|6502 MMU
|[https://github.com/Mu0n/F256MiscGoodies/blob/main/fpga/K/F256K_WBh_Nov19th_RevB0x_RC12_0011.jic 19-Nov-2023]
|Corrects the issue with no-response from command $20 & $21 (not being processed in the early parser). The Jr doesn't have the issue.
|-
|6502 MMU
|various older
|
|-
|65816 Ext 2x
|[https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/fpga/K/F256Kc_WBh_Jun18th_2025_RC0100_0000_DualSpeed_CPU.jic 18-Jun-2025]
|CPU runs at 2x speed at 12 MHz
MUST use a 65816 cpu chip,

will not work with the 6502
|-
|6809
|N/A yet
|N/A yet
|}

---old version will be kept at the bottom for a while in case errors are found above---

== FPGA Upgrade Guide ==

==== How to Upgrade the F256K FPGA (and F256Jr) ====
Note that the below Video Guide applies to both the F256K & F256Jr, despite it just being titled F256K.

<youtube>U7bq7t_qjxg</youtube>

You will need to download Quartus Prime Lite 18.1 Edition, since you are going to target a EP4CE15 FPGA (Cyclone 4).

Do not update to the latest version of Quartus Prime Lite, as the latest version doesn’t support that family of FPGA anymore and the software is very big.

Also, one might want to download only the "Intel® Quartus® Prime Programmer and Tools" as opposed to download the whole software by clicking on "Additional Software"

[https://www.intel.com/content/www/us/en/software-kit/665990/intel-quartus-prime-lite-edition-design-software-version-18-1-for-windows.html Intel Quartus Prime Lite Edition 18.1 for Windows]

[https://www.intel.com/content/www/us/en/software-kit/665988/intel-quartus-prime-lite-edition-design-software-version-18-1-for-linux.html Intel Quartus Prime Lite Edition 18.1 for Linux]

==== How to Upgrade the FPGA for the Wildbits/K2 (F256K2) ====
It is possible that there will be more graceful methods in the future, but for now, the easiest is to pop off the μSD card found on the left side of the board marked "μSD Card / FPGA Load" and to replace the .bin files inside the directory of the root of that μSD card, using a modern computer.

This is a video guide that covers both upgrade the FPGA cores of the K2 as well as updating the firmware once the FPGA is improved or installed for the first time:

<youtube>pOab0ocKqac</youtube>

This will of course imply that you open up your case. [[Optional Upgrades#Opening the F256K case|There is a guide]] on how to do so for the original F256K enclosure. The K2 enclosure is similar.

For those unfamiliar with the process of removing the μSD card from these slide-operation holders here is the process:

1) very gently press down on the middle metal locking slider that goes across on top of the μSD card and slide it towards the left.

2) the μSD card and its locking slider will now open up by rotating towards the left with a hinge on the left side

Inside the root of this μSD card, there are four folders marked as CNTX# where # is a number from 1 to 4. Simply replace the .bin file therein to update any one given core. You may completely ignore .prm files since they do not affect the F256K2.
{| class="wikitable"
|+
!Folder
!Hard coded file name
!Typical* usage
!CPU in the FPGA
|-
|CNTX1
|CFP95600C.bin
|F256 Classic mode with a memory management unit (MMU), where the CPU sees 64k at once
|65816 acting as 6502
|-
|CNTX2
|CFP95616E.bin
|F256 Extended mode with a flat memory map all accessible at once
|65816
|-
|CNTX3
|f256k2t9.bin
|F256 with the 6809 core (planned) or 68000 core (planned)
|6809
|-
|CNTX4
|foenix138.bin
|F256 with 2x CPU speed Extended mode with a flat memory map all accessible at once
|65816
|}

====== Note* on typical usage ======
As long as you keep the proper hard coded names tied to their folder names, you can slide any core to any slot. For example, if you want the 2x core to be in the CTNX2 folder, just rename it appropriately to CFP95616E.bin as you put it into CTNX2/.

====== K2 core prep steps: ======

# Take care of placing the bin file in the FPGA load μSD card
# Set the core selecting DIP switches at the back of the unit. Down (towards bottom of the unit) = 0, Up (towards the upper side of the unit) = 1. See below for all possibilities.
# Power up the unit. If this is the first time you're using that core and you've never done step 4 for it, it's normal to not have a properly booted initial software (ie superbasic or otherwise)
# Write the firmware to the content of the flash. Each of the 4 cores have their own 512kb of reserved flash space that are selected at the same time as the core itself from the μSD FPGA load card. Once they are written to, they are set for future usages as you switch between cores and won't require further flash writes, unless you're doing updates.

====== Core selecting DIP switches in the back ======
{| class="wikitable"
|+
!Core 1
!Core 2
!Core 3
!Core 4
|-
|
[[File:Core1.png|thumb]]
|
[[File:Core3.png|thumb]]
|
[[File:Core2.png|thumb]]
|
[[File:Core4.png|thumb]]
|-
|0 0
|1 0
|0 1
|1 1
|}

==== How to Upgrade the FPGA for the F256Jr. the 2nd ====
Go look at this [[FPGA Upgrade Guide (F256JrJr)|guide here in the wiki]].

=== Suggested USB Blaster (K and Jr. only) ===

Earth People Technology
[https://www.amazon.ca/JTAG-Blaster-Intel-Altera-Programmer/dp/B07BZMSZ3G/ref=sr_1_3?crid=WWV8P0OHVCE3&keywords=altera+usb+blaster&qid=1688067039&sprefix=altera+usb+blaster%2Caps%2C113&sr=8-3]
[https://earthpeopletechnology.com/?wpsc-product=ept-2232h-sp-s1]

Terasic USB Blaster (low cost version)
[https://www.digikey.ca/en/products/detail/terasic-inc/P0302/2003484]
[https://www.terasic.com.tw/cgi-bin/page/archive.pl?Language=English&CategoryNo=&No=46#contents]

Chinese Knockoff (please avoid if possible)

=== Open Source blaster software (K and Jr. only) ===

For those who are struggling to program the FPGA with Linux or Apple, Stef found this great tool:

https://github.com/trabucayre/openFPGALoader/releases

Getting Started

2026-05-25T13:32:54Z

1BitFeverDreams: /* Getting Powered Up */ added text for wildbits. Added details for the JR2 powering situation. Added text on the internal uSD cards for gen2 machines.

== Getting Powered Up ==

=== Powering your F256K and Wildbits/K2 (fmr. known as F256K2) ===

These machines are powered via a standard 2.5mm DC Connector, which takes a centre-positive 12V 2A capable Power Supply.

It's possible to use 9 V instead of 12 V, (''I can personally vouch for it -Mu0n''). Typical power draw is around 4 to 5 W.

This type of power supply is quite common. [https://www.amazon.com/Adapter-100-240V-Transformer-Charger-Security/dp/B091XSVV1Y Example 12V 2A capable power supply] (used by at least 1 Discord user successfully)

The Wildbits/K2 (or F256K2) higher end FPGA requires adding a [https://www.amazon.com/dp/B08CMK8BMT compatible heatsink] if you're running advanced cores like the theoretical 68k core, but is not required for the default K2c/e, 6809, or Core2x.

=== Powering your Wildbits/Jr2 (formerly known as F256Jr2) ===
Power is provided through a USB-C connector. The cable used there is also providing 4x channels for programming the FPGA, allowing the use of the debug port and the system's serial COM port.

=== Powering your F256Jr ===

The F256Jr is supplied as a Mini-ITX form factor mainboard, with a standard 24 pin ATX power supply connector for power connectivity.

Since the F256Jr needs relatively little power, compared to a mini-ATX PC, a popular DC 12V 24pin Pico ATX PSU works well and is a compact solution.

* [https://www.amazon.com/dp/B08F57GKCL Pico PSU] - You power the Pico PSU via a 12V DC center-positive Power Supply source.
* [https://www.amazon.com/dp/B07MXXXBV8 12V DC center-positive A/C Adapter] - Commonly used to power the Pico PSU.
The board itself has no power switch. If you do not have a Mini-ITX case, a pin header on the board can be bridged by a jumper and thereby used instead of a proper power switch as a stop gap solution. In this picture https://wiki.c256foenix.com/images/6/64/Pinout_Jr_December_7th_Trans.png the pin header in question is shown in the lower right and is labeled with ''PW ON SPST Switch''.

== Getting programs onto the Wildbits/F256 ==

=== SD Card ===

The F256K, Wildbits/K2 (F256K2), F256JR and Wildbits/Jr2 (F256Jr.Jr.) have an SD card slot. The device software to read the SD card is a bit touchy (it's inherited from the Commander X16 project) and doesn't work with all SD cards

* Cards should support the V2 protocol (HC or XC); older cards that only support the V1 protocol (typically 2GB or less) won't work. By contrast, the kernels for the C256 machines generally only work with V1 cards. Note that, in both cases, this is a software limitation -- all of the Foenix machines are electrically capable of using both kinds of cards.
* Partitioning should be MBR, and partition type 0x0c.
* Cards *MUST* be formatted FAT32 -- **NOT: FAT, FAT12, FAT16, or exFAT**.
* Formatting with Windows 10/11 works fine, but make sure to force FAT32 (or use the command line: <code>format /FS:FAT32 H:</code>)
* Formatting with MacOS will only work using the <code>diskutil</code> command line utility. An example usage looks like this: <code>sudo diskutil eraseDisk FAT32 [DiskName] MBRFormat /dev/[DiskNumber]</code>. You can use <code>diskutil list</code> to get the disk number for the SD Card.
* Formatting and partitioning SD cards with Linux can be done using the <code>gnome-disk-utility</code> (known simply as Disks) and is installed on most mainstream distributions of Linux. Disks will access all the drives on the computer so be sure you have the SD card selected when editing. [https://wiki.gnome.org/Apps/Disks Gnome/Disks wiki]
* FAT32 only supports a maximum partition size of 32Gb, on larger cards you will need to create multiple partitions -- however, only the first is recognized by DOS.
* Some folks have had luck formatting cards with the [https://www.sdcard.org/downloads/formatter/sd-memory-card-formatter-for-windows-download/ Official SD Association formatter for Windows].

=== Internal μSD Card(s) ===
The gen 2 machines have additional μSD for various purposes.

The Wildbits/Jr2 (F256Jr2) has a μSD socket on its underside for "internal storage" purposes. This needs to be enabled through a specific FPGA feature that is still pending in May of 2026.

The Wildbits/K2 (F256K2) has two μSD sockets inside the case. The leftmost one is a storage for the FPGA binary builds that get sent to the FPGA during bootup, according to the status of the DIP switches at the backside of the case. Four such builds can be prepared in advanced and you can read more on this topic in the [[FPGA Releases|FPGA Release page]]. The rightmost μSD socket is for "internal storage" purposes. This needs to be enabled through a specific FPGA feature that is still pending in May of 2026.

=== Curated Software Collections ===

* [https://github.com/Mu0n/F256MiscGoodies/tree/main/SDCard_Collection Go here to get a nice curated collection of programs] - it was first pepared for VCF East 2025 for the showroom Foenix table, but it is actively getting further updates. simply unzip it to the root of the flash card. You are encouraged to browse and launch most things with the f/manager program by first diving into /- fm from superbasic.
* An older 2023 pack can be found here (and is referenced down below in the SuperBasic section of this current page), simply unzip it to the root of the flash card: [https://github.com/FoenixRetro/Documentation/blob/main/f256/archive older demo pack from 2023]

=== Tutorial Video on 13 methods on running programs: ===
<youtube>0ShFv89KGDs</youtube>

00:41 Method 1 - SuperBasic program

01:51 Method 2 - .pgz, .pgZ or .pgx executable from SuperBasic

03:12 Method 3 - Program residing in flash memory

05:58 Method 4 - .pgz, .pgZ or .pgx from DOS

07:31 Method 5 - f/manager utility

12:31 Method 6 - 5.25" 1541 Commodore Disk Drive

14:08 Method 7 - FoenixMgr python scripts for .pgz, .pgZ or .pgx

17:52 Method 8 - FoenixMgr python scripts for .bin

22:21 Method 9 - FoenixMgr modifying the flash programs

25:41 Method 10 - Fcart & PGZ2FLASH to program a Flash Cartridge

28:58 Method 10b - PGZ2Flash to program a Flash Program

30:01 Method 11 - Fcart to REPROGRAM a Flash Cartridge

33:51 Method 12 - Toolbox environment in 65816 extended mode

=== Debug USB port ===

* This is what most developers use as it's the most convenient. Connect the debug USB port to your PC or Mac

* You can use:
** [https://github.com/pweingar/FoenixMgr FoenixMgr] - works on Windows, Mac, Linux
*** A Python script to manage the Foenix series of retro style computers through their USB debug ports. This tool allows uploading files of various formats to system RAM, and displaying memory through various me

** [https://github.com/Trinity-11/FoenixIDE FoenixIDE] (Windows only)
*** Development and Debugging Suite for the C256 Foenix Family of Computers.

=== wget (for gen1 only: F256K and F256Jr) ===
If you have the [[wifi]] configured, you can use [https://github.com/ghackwrench/F256_wget wget] to pull programs and data right off the web!

== SuperBASIC ==

The machine boots to SuperBASIC. SuperBASIC is inspired by BBC BASIC but offers quite a bit more.

* Read the [https://github.com/FoenixRetro/f256-superbasic/blob/main/reference/source/f256jr_basic_ref.pdf SuperBASIC Reference Manual].

* Watch EMWhite's excellent intro series on Youtube:
** Full Playlist here: [https://www.youtube.com/playlist?list=PLeHjTvk7NPiSqGz4REMH-S4hjYpLS2YNR EMWhite's Intro Series - Full Playlist].
** Part 1 can be viewed here:
<youtube>G_S2c_MsqYA</youtube>

To get started, you can type in a sample program at the command prompt:

<pre>
10 for i=1 to 5
20 print "Hello world"
30 next
run
</pre>

SuperBASIC is similar to CBM (Microsoft) BASIC but has some differences. For example, note in the sample above it's just <code>next</code> not <code>next i</code>.

The first 15 or so pages of the [https://github.com/FoenixRetro/f256-superbasic/blob/main/reference/source/f256jr_basic_ref.pdf SuperBASIC Reference Manual] are quite instructive.

SuperBASIC is actually much more powerful and supports structured programming (procedures, blocks etc.)

<code>dir</code> - Run this to display directory of SD card

Loading & running programs off of the SD card is similarly easy:

<pre>
load "JrWordl.bas"
run
</pre>

Similar to the C64, you can save time in loading programs from the <code>dir</code> listing by using your cursor keys to go up to the entry, typing <code>load "</code> (insert mode is active by default) etc. You can use <code>CTRL+E</code> to jump to the end of the line and use <code>CTRL+K</code> to delete any text from the cursor to the end of the line. Correctly place the closing <code>"</code> and hit <code>ENTER</code>.

<code>CTRL+C</code> acts as a "break" command and stops any running SuperBASIC program or <code>LIST</code> command.

Read built-in help/reference:

<code>/help</code> : But '''NOTE''', this erases BASIC memory! Use Backspace key to go back in menus and to exit.

Explore the included demo SuperBASIC programs:

{| class="wikitable"
! Program !! Notes !! Source
|-
| <code>JrWordl.bas</code> || Wordle game, guess 5 letter word ||
|-
| <code>mandel.bas</code> || Draws Mandlebrot set in graphics mode, takes between 2 and 3 hours || [https://github.com/Mu0n/F256KbasicBASICdoodles @Mu0n]
|-
| <code>rpg-demo.bas</code> || UI sample that shows Zelda like RPG game. Control the character with an Atari-joystick connected to JoyPort1 || @econtrerasd
|-
| <code>Problematic_Code.bas</code> || Displays scrolling starfield ||
|-
| <code>noelrl.bas</code> || Simple integer BASIC bench mark from Noel's retro lab. Completes < 3.5 seconds, compares very favourably to other retro systems! || [https://www.youtube.com/watch?v=H05hM_Guoqk Youtube]
|-
| <code>dance.bas</code> || Animates sprite of dancer || [https://github.com/Mu0n/F256KbasicBASICdoodles @Mu0n]
|-
| <code>luna.bas</code> || Displays simple scene ||
|-
| <code>blink.bas</code> || Blinks drive access light || [https://github.com/Mu0n/F256KbasicBASICdoodles @Mu0n]
|-
| <code>piano.bas</code> || Play some notes with the PSG || [https://github.com/Mu0n/F256KbasicBASICdoodles @Mu0n]
|}

=== Running pgz, pgZ, pgx Executable Files ===
Running executables from superbasic involves calling the "pexec program" normally stored in Flash memory, but which is written as simply as possible with a "-" (dash symbol without the quotes) to make it easy and convenient to run programs.

You can use this notation to execute file.pgz (the same can be done with pgx, pgZ):<pre>
/- file.pgz
</pre>The / is for running anything that's stored in flash

The - is the special alias for pexec, as it is stored in flash

Therefore /- is used together to launch an executable, which would follow as the first argument to the right. Keep in mind you need a space between /- and your program name.

=== More Resources ===
=== This Wiki ===

Explore all of the content of this Wiki, to expand your F256 series knowledge!

=== Discord ===

The [https://discord.gg/9vjUEGgcUS Wildbits Computing Company Discord] is the primary place to get questions answered.

Also, if you resolve your question, and you didn't find the answer here on the Wiki, '''''please consider contributing to the Wiki''''', for the benefit of others with the same question!

=== Foenix Retro Systems Newsletter ===

Read back issues [http://apps.emwhite.org/foenixmarketplace/ here] (also a great source for sample programs).

Issues starting at #4 cover the F256 line. Issues 1-3 cover the previous version of the hardware (C256), although there are still many salient points.

=== Youtube Channels with regular Foenix videos ===
Official Foenix Retro Systems channel: https://www.youtube.com/@foenixretrosys

8-Bit Wall of Doom (from EMWhite): https://www.youtube.com/@8-bitwallofdoom

AnyBit Fever Dreams (from Mu0n): https://www.youtube.com/@anybitfeverdreams

Boisy Pitre (from MrPitre): https://www.youtube.com/@boisypitre

digarok (from digarok): https://www.youtube.com/@digarok

Micah Bly (from Micah): https://www.youtube.com/@micahbly8241

NormanYen (from beethead): https://www.youtube.com/@normanyen5720

Programmer vs World (from PlasmaTrout): https://makertube.net/c/programmervsworld/videos

==== Specific youtube videos from heavy hitters: ====
Jan Beta reviews the F256K: https://www.youtube.com/watch?v=57FuA8YuXn0

Perifractic (from Retro Recipes) reviews the F256K: https://www.youtube.com/watch?v=TJQgecozNzU

Software for 6502

2026-05-12T16:57:20Z

1BitFeverDreams: /* Applications */

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
|-
|S.P.O.T.
|Satellite Position and Orbital Tracking: network driven representation of the position of the ISS (international space station) from data on the internet
|Mike C
|basic
|https://github.com/mcassera/SPOT
|-
|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
|-
|hackGfx
|Tile scrolling red pixels demo with short opl3 playback loop
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/hackGfx.pgz
* spacebar to toggle text
* S to toggle music
* backarrow to quit
it requires sshockt.vgm located in media/vgm/ in order to work with the music

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sshockt.vgm
|-
|gfxDemo
|Vicky graphics layer demo showcasing: mouse, reg text mode, mem text mode, 3 bitmaps, 3 tiles, sprites, palette swaps
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/gfxDemo.pgz<nowiki/>this is v0.9, the memtext layer is buggy and L0 and L1 for tiles are absent for now.
|-
|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
|-
|pendulum
|Sprite and MIDI demo
|MikeC
|pgz
|https://github.com/mcassera/pendulum
|-
|rpg-demo
|A Vicky graphic layers demos of sprites and layers, controlled by joy2
|econtrerasd
|basic
|unzip the following zip file into the root of your SD card. By doing so, various asset files will be put into the directories media/palettes/, media/tiles/ and media/sprites/. the .bas itself can be put anywhere.
https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/rpg-demo.zip
|-
|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.7 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

has a light show using all four RGB case LEDs of the K2 (might break compatibility with Jr2? test it please!)
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.1 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://github.com/econtrerasd/testSuite-F256/releases
|
|-
|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
|-
|MikeC repos
|Various projects in assembly
|MikeC
|read github
|https://github.com/mcassera
|-
|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-05-12T16:57:04Z

1BitFeverDreams: /* Applications */ S.P.O.T.

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
|-
|S.P.O.T. iss
|Satellite Position and Orbital Tracking: network driven representation of the position of the ISS (international space station) from data on the internet
|Mike C
|basic
|https://github.com/mcassera/SPOT
|-
|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
|-
|hackGfx
|Tile scrolling red pixels demo with short opl3 playback loop
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/hackGfx.pgz
* spacebar to toggle text
* S to toggle music
* backarrow to quit
it requires sshockt.vgm located in media/vgm/ in order to work with the music

https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/sshockt.vgm
|-
|gfxDemo
|Vicky graphics layer demo showcasing: mouse, reg text mode, mem text mode, 3 bitmaps, 3 tiles, sprites, palette swaps
|Mu0n
|pgz
|https://github.com/Mu0n/F256KsimpleCdoodles/raw/refs/heads/main/NoFussDemos/gfxDemo.pgz<nowiki/>this is v0.9, the memtext layer is buggy and L0 and L1 for tiles are absent for now.
|-
|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
|-
|pendulum
|Sprite and MIDI demo
|MikeC
|pgz
|https://github.com/mcassera/pendulum
|-
|rpg-demo
|A Vicky graphic layers demos of sprites and layers, controlled by joy2
|econtrerasd
|basic
|unzip the following zip file into the root of your SD card. By doing so, various asset files will be put into the directories media/palettes/, media/tiles/ and media/sprites/. the .bas itself can be put anywhere.
https://github.com/Mu0n/F256MiscGoodies/raw/refs/heads/main/apps/rpg-demo.zip
|-
|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.7 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

has a light show using all four RGB case LEDs of the K2 (might break compatibility with Jr2? test it please!)
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.1 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://github.com/econtrerasd/testSuite-F256/releases
|
|-
|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
|-
|MikeC repos
|Various projects in assembly
|MikeC
|read github
|https://github.com/mcassera
|-
|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
|}

Oscar64

2026-05-01T19:34:14Z

1BitFeverDreams: /* Embedding asset files */ parameters added to the #embed directive

==== Documentation ====

The main documentation website is located here: https://github.com/drmortalwombat/oscar64/blob/main/oscar64.md

=== Installation procedure ===
(this is from Mu0n, under Windows 11 but using a WSL command window)

<blockquote>Assumptions:

* Windows' WSL is installed (ie with Ubuntu)
* Python is installed inside windows
* make is installed inside WSL
* gcc is installed inside WSL ('''sudo apt install build-essential''')
</blockquote>
Step 1) in Windows, make a base directory (let's call it '''BASEPATH''') that will hold both:

* the oscar64 project, but with the 'f256k-support' branch rather than 'main' branch <nowiki>https://github.com/sdwfrost/oscar64</nowiki>

* the f256lib-oscar64 project, 'main branch' <nowiki>https://github.com/sdwfrost/f256lib-oscar64</nowiki>

(both from sdwfrost's GitHub account)

Step 2) from windows, open a cmd window, go to your intended base folder

Step 3) type WSL

Step 4) clone oscar64 with

'''git clone -b f256k-support <nowiki>https://github.com/sdwfrost/oscar64.git</nowiki>'''

Step 5) clone f256lib-oscar64 side by side in the same base folder.

'''git clone -b main <nowiki>https://github.com/sdwfrost/f256lib-oscar64</nowiki>'''

Both ''''oscar64'''<nowiki/>' and ''''f256lib-oscar64'''<nowiki/>' folders will be in the same location when this is done.

Step 6) go into oscar64/

Step 7) type:

'''make -f make/makefile'''

(this assumes gcc being present in WSL, it will take a while!)

Step 8) switch over to f256lib-oscar64/ and type:

'''OSCAR64=../../oscar64/bin/oscar64 make all'''

(warning 1: at the time of writing this guide, the 2nd project, BachHero, triggers an error that halts the whole list. Simply remove that entry from /f256lib-oscar64/doodles/MakeFile to get the rest going) (warning 2: most projects will compile, but not run properly when run in the Wildbits environment since they expect extra library files that have not been ported over)

Step 9) to compile a single project in general, make sure you use a path that points to the compiled oscar64 of step 7 like so: (assuming your project myproject is in BASEPATH/f256lib-oscar64/doodles/)

'''BASEPATH/oscar64/bin/oscar64 -tm=f256k -n -i=BASEPATH/f256lib-oscar64/f256lib BASEPATH/f256lib-oscar64/doodles/myproject/src/myproject.c -o=BASEPATH/f256lib-oscar64/doodles/myproject/myproject.pgz'''

=== Noteworthy files and folders ===

(some of these are merely suggestions in how to organize your local installation of oscar64)

assuming your '''BASEPATH''' = the folder where you do your installation,

'''BASEPATH/oscar64/''' is where the compiler should be installed

'''BASEPATH/f256lib-oscar64/''' is where the F256/wildbits libraries for oscar64 should be installed

'''BASEPATH/f256lib-oscar64/f256lib/''' is the folder containing all the library files

'''BASEPATH/f256lib-oscar64/f256lib/f256lib.c''' is the master library file, also has a corresponding f256lib.h header file and loads all the rest.

'''BASEPATH/f256lib-oscar64/doodles/''' is a good place to store your projects

'''BASEPATH/f256lib-oscar64/doodles/myproject/''' is the root folder of your project called 'myproject' and where the program and linker produced files end up in

'''BASEPATH/f256lib-oscar64/doodles/myproject/src/''' is the folder containing all of your source code

=== How to manage multiple source code files in a project ===

* Create .h + .c pairs of source code files by themes. 

* Use '''whatever.h''' so that '''BASEPATH/f256lib-oscar64/doodles/myproject/src/whatever.c''' and its corresponding whatever.h are referred to 

* Put the entirety of whatever.h's content between

<pre>#ifndef WHATEVER_H

#define WHATEVER_H

</pre>

and

<pre>

#endif

</pre>

to avoid complaints of multiple definitions if multiple files need this reference.

=== Compiling a program, scripts from Mu0n ===
I use a pair of scripts that are located in BASEPATH/f256lib-oscar64/doodles/

Here's the shell script ("c.sh") I use to simply compile a program, this works regardless if your project uses one .c file or multiples. Adjust your absolute paths to what you have on your modern computer. "projectname" is the folder of your project inside the "doodles" folder.

run it using the command '''./c.sh myprojectname'''<pre>
#!/bin/bash

# --- 1. CONFIGURATION ---
OSCAR_BIN="/mnt/d/F256/oscar64/bin/oscar64"
# Use the Windows python launcher (it handles COM8 perfectly)
PYTHON_EXE="python.exe"
# Use the Windows path for the script (escaped backslashes)
FOENIX_MGR="D:\\F256\\llvm-mos\\f256dev\\FoenixMgr\\FoenixMgr\\fnxmgr.py"

# --- 2. ARGUMENTS ---
PROJ_NAME="$1"
SRC_DIR="${PROJ_NAME}/src/"
SRC_FILE="${PROJ_NAME}/src/${PROJ_NAME}.c"
OUT_DIR="${PROJ_NAME}/"
BIN_FILE="${PROJ_NAME}.pgz"
FLAGS="-tm=f256k -n -v -i=../f256lib"
# --- 3. Gather all files in src/

mapfile -t CFILES < <(find "$SRC_DIR" -maxdepth 1 -type f -name "*.c")

# --- 4. COMPILE ---
echo "Compiling:"
printf '%s\n' "${CFILES[@]}"
echo
echo "Linking into ${OUT_DIR}/${PROJ_NAME}.pgz"
$OSCAR_BIN $FLAGS "${CFILES[@]}" -o="./$OUT_DIR/$PROJ_NAME.pgz"
</pre>Here's the shell script ("car.sh" = Compile And Run) I use to compile a program and send it over to my Wildbits through the foenixmgr script. This assumes that your host is win11 and python is run from that, from inside WSL ubuntu. Tweak to your setup's situation, of course.

run it using the command '''./car.sh myprojectname'''<pre>
#!/bin/bash

# --- 1. CONFIGURATION ---
OSCAR_BIN="/mnt/d/F256/oscar64/bin/oscar64"
# Use the Windows python launcher (it handles COM8 perfectly)
PYTHON_EXE="python.exe"
# Use the Windows path for the script (escaped backslashes)
FOENIX_MGR="D:\\F256\\llvm-mos\\f256dev\\FoenixMgr\\FoenixMgr\\fnxmgr.py"

# --- 2. ARGUMENTS ---
PROJ_NAME="$1"
SRC_DIR="${PROJ_NAME}/src/"
SRC_FILE="${PROJ_NAME}/src/${PROJ_NAME}.c"
OUT_DIR="${PROJ_NAME}/"
BIN_FILE="${PROJ_NAME}.pgz"
FLAGS="-tm=f256k -n -i=../f256lib"
# --- 3. Gather all files in src/

mapfile -t CFILES < <(find "$SRC_DIR" -maxdepth 1 -type f -name "*.c")

# --- 4. COMPILE ---
echo "Compiling:"
printf '%s\n' "${CFILES[@]}"
echo
echo "Linking into ${OUT_DIR}/${PROJ_NAME}.pgz"
$OSCAR_BIN $FLAGS "${CFILES[@]}" -o="./$OUT_DIR/$PROJ_NAME.pgz"

# --- 5. TRANSFER ---
if [ $? -eq 0 ]; then
echo "Transferring to F256K2 via Windows Python..."
# We use the Windows path for the file we just built
WIN_BIN_PATH="D:\\F256\\f256lib-oscar64\\doodles\\${PROJ_NAME}\\${BIN_FILE}"

$PYTHON_EXE "$FOENIX_MGR" --port COM8 --run-pgz "$WIN_BIN_PATH"
else
echo "Compilation failed."
exit 1
fi
</pre>

=== Embedding asset files ===

Here's an example of a few assets loaded in a specific spot in memory, starting from 0x10000. It needs to be part of a section, then a region and then some array identifiers that point to the data itself. When the project compiles, you can check out the layout of the memory being used inside your .map file.

<pre>
/*
* The following assets will be located within these bounds
*
10000 - 10400 : grupal, DATA:assets
10400 - 10800 : sBoy1, DATA:assets
10800 - 10c00 : sThing, DATA:assets
10c00 - 11000 : sGirl1, DATA:assets
11000 - 11400 : sCath, DATA:assets
11400 - 11800 : sCat, DATA:assets
11800 - 12000 : sDash, DATA:assets
*/

#pragma section( assets, 0 )
#pragma region( assets, 0x10000, 0x20000, , , {assets} )
#pragma data(assets)
__export const char grupal[] = { //1kb palette from 0x10000 to 0x103FF
#embed "../assets/grudge.pal"
};
__export const char sBoy1[] = { //16x16 sprite of 1kb from 0x10400 to 0x107FF
#embed "../assets/boy1.bin"
};
__export const char sThing[] = {
#embed "../assets/thing.bin"
};
__export const char sGirl1[] = {
#embed "../assets/girl1.bin"
};
__export const char sCath[] = {
#embed "../assets/cath.bin"
};
__export const char sCat[] = {
#embed "../assets/cat.bin"
};
__export const char sDash[] = {
#embed "../assets/dash.bin"
};

//return to normalcy
#pragma data(data)</pre>

If you want to embed files that are larger than 64kb OR if you want to manually force a specific size of data that will get loaded as an embedded asset, use a byte number right after #embed, like so:
<pre>
__export const char bmScreen[] = {
#embed 76800 "../assets/bitmap.bin"
};
</pre>
''(this would load a full screen bitmap of 76,800 bytes at a 320x240 resolution.)''

If you want to use an offset from which to start using your data, use a second number like so:

<pre>
__export const char binaryChunk[] = {
#embed 8192 1024 "../assets/chunk.bin"
};
</pre>
''(this would load 8kb but starting at byte 1024 from the start instead of 0)''

=== How to use higher memory and the MMU to store code ===

Much like assets, you will have to use the #pragma directive to set up a section and region for each chunk of RAM. Since a trampoline scheme gets used here in conjunction with the machine's MMU, these regions should be 0x2000 big, or 8kb.

Keep in mind that these chunks of RAM will be swapped in and out of the 0xA000 to 0xBFFF 8kb chunk visible by the CPU.

Here is the list of stuff you must define for it to work:

* A specific number for your code's block = physical address / 0x2000 you have in mind to stash your code. For example, to use the 8kb of code space between 0x10000 and 0x11FFF, this will be "overlay block 8". For the space between 0x12000 and 0x13FFF, this is "overlay block 9"
<pre>
#define OVL1_BLOCK 8 // Physical 0x10000
</pre>
* #pragma directive such as:
<pre>
// Overlay 1: stored at physical 0x10000, compiled to run at 0xA000
#pragma section( ovl1_code, 0 )
#pragma region( ovl1, 0x10000, 0x12000, , , { ovl1_code }, 0xA000 )
</pre>
* Forward declaration of a trampoline function used to access the higher memory function, such as:
<pre>
// ---------------------------------------------------------------------------
// Forward declarations of trampolines (in main code, always visible)
// ---------------------------------------------------------------------------

void firstSegment(int arg1, int arg2);

// Trampolines save the current bank 5 mapping, switch to the target
// overlay's physical block, call the FAR function, then restore the
// original mapping. This supports nested cross-overlay calls.

void firstSegment(int arg1, int arg2) {
volatile byte saved = PEEK(OVERLAY_MMU_REG);
POKE(OVERLAY_MMU_REG, OVL1_BLOCK);
FAR_firstSegment(arg1, arg2);
POKE(OVERLAY_MMU_REG, saved);
}

</pre>

* Your far memory function in between #pragma code directives:
<pre>
#pragma code( ovl1_code )

void FAR_firstSegment(int arg1, int arg2) {
textPrint("firstSegment = ");
textPrintInt((int32_t)(arg1 + arg2));
textPrint("\n");
}

//return to normalcy
#pragma code( code )
</pre>Note: it's perfectly ok to define multiples of these high memory regions. One far memory function can call another far memory function from another region without issue, but it has to call it through its lower memory trampoline.

=== Accessing the extra 2x core banks of 512kb memory ===

Since the launch of the 2x core, the full 2MB of SRAM is accessible if you set a bit right in register 0x0000. For more details on this feature of the 2x core, [[Use the Core2x|see this page]].

To peek a byte at these regions of memory, use this asm block as an oscar64 function:

'''peek24''' accepts a 32bit long address, stores it temporarily into a few bytes near the beginning of zero page. It then activates bit 3 of register 0x0000 to access the new 2x core higher memory banks. Finally, it fetches the content of that byte as a returned char.

<pre>
char peek24(unsigned long addr)
{
return __asm {
lda addr
sta 0x05
lda addr+1
sta 0x06
lda addr+2
sta 0x07

ldx 0x00
ldy 0x01
txa

ora #0x08
php
sei
sta 0x00
tya
ora #0x30
sta 0x01

byt 0xa7
byt 0x05

stx 0x00
sty 0x01

plp

sta accu
lda #0
sta accu+1
};
}</pre>

To write something to these higher memory banks, you can use '''poke24''', which goes the other way:

<pre>
void poke24(unsigned long addr, unsigned char value)
{
__asm {
lda addr
sta 0x05
lda addr+1
sta 0x06
lda addr+2
sta 0x07

ldx 0x00
ldy 0x01
txa

ora #0x08
php
sei
sta 0x00
tya
ora #0x30
sta 0x01

lda value

byt 0x87
byt 0x05
stx 0x00
sty 0x01

plp
ldx #0x00
};
}
</pre>

=== "Troubleshoot Gotchas" during compilation ===

None to report so far.

Use the Core2x

2026-04-30T13:16:55Z

1BitFeverDreams: /* Floating point module = */

== Core2x for K2 and Jr2 ==

=== Overview ===

These new features were brought in as a new FPGA core back in August of 2025. It was feature complete for the K2 and mostly feature complete for the Jr2. Since early 2026, feature parity is coming to the Jr2.

Here is the original reference document from August 2025 from Stefany Allaire:
[https://256-foenix.us-east-1.linodeobjects.com/F256K2x_Cores%2FCore2x_ShortFormSpec_Aug7th.pdf Core2x_ShortForm_Documentation]

Here is Stefany Allaire's video on the Core2x features: https://www.youtube.com/watch?v=ECu1Z3AwZEw

=== Flat mode 24 bit memory addressing and accessing 3 new banks of 512kb of SRAM ===

To do.

=== Moving I/O decoding and Flash/Cart to higher memory ===

To do.

=== Accessing an extra bank of 64 sprites ===

To access the extra bank of 64 sprites using the same register locations as the first 64 sprites, just set bit 6 to 1 of register 0x0001.

Keep it cleared when you want to access the first bank.

The sprite registers are well documented in this [[IO Pages#$D900: Sprites|Sprite section of the IO Pages]], as well as in chapter 5 of the [[Manuals|Jr reference book]] starting at 0xD900, assuming you have i/o page set at 0.
{| class="wikitable"
|+I/O Memory Control Register (0x0001)
!B7
!''B6''
!B5
!B4
!B3
!B2
!B1
!B0
|-
|Not used
|'''''Sprite Block Select - 0:Sprite 0-63, 1:Sprite 64-127'''''
|Move Flash/Cart to High
|Move IO Devices to High
|Active IO Page[2]
|IO Page Disable - 0:Enabled, 1:Disabled
|Active IO Page[1]
|Active IO Page[0]
|}

=== New layer: memtext mode (more colors, fonts, background and foreground bigger LUTs) ===

To do.

=== VDMA Controller adds 16bit memcopy ===

To do.

=== Fast hardware line draw ===

To do.

=== Floating point module===

To do.

2026-04-28T20:45:09Z

1BitFeverDreams: more details for oscar64

== '''C Compilers''' ==
* [[cc65]]
* [https://www.calypsi.cc/ Calypsi]
* [[llvm-mos]]
* [https://github.com/sdwfrost/oscar64 oscar64] (read below for detailed install instructions)

=== LLVM-MOS ===
This fork of llvm-mos was adapted for F256/Wildbits usage by user sduensing from Kangaroo Punch Studios and [https://kangaroopunch.com/view/ShowSoftware?id=13 can be found here]. The installation instructions are simple and work for both Windows and Linux. It mostly uses a one-stop-shop f256lib.h file containing macros and functions leveraging some devices (not all yet) and the MicroKernel.

The default linking configuration will have your code start at 0x300, a 8 kb stack/trampoline from 0xA000 to 0xBFFF that is used to bring in higher memory content visible into that slice of the first 64k of the CPU. The slice 0xC000 to 0xDFFF is used by IO as usual and 0xE000 to 0xFFFF is used by the MicroKernel as usual. To change any of this, you can bring a modified copy of link.ld into your /projectfolder/ and it will supersede this default mapping.<blockquote>
==== List of "Gotchas" for llvm-mos ====
1) When trying to use the EMBED directive in order to put data at specific memory locations, keep in mind that you CAN'T comment those lines out with <code>/*</code> and <code>*/</code>, the compiler will try to follow them whether they're in them or not. The only way to comment them is to use <code>//</code>.

2) When trying to use the EMBED directive, you may want to put your assets in a subfolder of your project. As in, assuming your source files are in ./src/ (where '.' is the root of your project) and your assets are in ./assets/, then you WILL need to refer to your asset files like so: <code>EMBED(myassetname, "../assets/myassetfile.bin", 0x10000);</code>. Note the weird ../ folder backtracking that has to be used. No other combination worked for me (-Mu0n)

3) In the f256dev/ folder, the f256build.bat file contains all you need to compile and link your project. In the "call mos-f256-clang.bat" line, one important switch is the optimization level you let the compiler use. Experiment with -O1 (no optimization), -O2 (some) and -O3 (most). Some operations and repetitions work with some and fail with others. One prominent example of where it failed was a repetitive fileRead operation that read and parsed little chunks of data from a file, byte by byte and while it compiled and linked, it failed during execution. By reducing -O3 to -O2, it all worked again.

4) One linking error kept giving me "<code>ld.lld: error: ld-temp.o <inline asm>:2:1: operand must be a 16-bit address sta (mos8(.LpickAudioFile_zp_stk+4)</code>" despite not having written any inline assembly in my project. You can skirt around the issue for the problematic function by adding a compiler attribute: <code>__attribute__((optnone))</code> right before your function definition.

5) When your code nears a size of 0x9400 and above, you may get in trouble in terms of code not being fully loaded into RAM while executing. Either deliberately put some code into far memory and devise a scheme with the MMU to swap that code in and out of reach for the CPU, or you can carve yourself a bit more space by editing f256dev/llvm-mos/mos-platform/f256/lib/link.ld and change:

<code>/* fake C Stack */</code>

<code>PROVIDE(__stack = 0xA000);</code>

<code>to</code>

<code>/* fake C Stack */</code>

<code>PROVIDE(__stack = 0xC000);</code>

to get yourself an extra 8k of code space before it collides with the stack

6) The compiler will often complain about a missing closing curly bracket '}' at the end of your source files. Just add the one it requires at the very end even though it's an extra one, or, finish your source file by putting your last function with this notation:

<code>void myLastFunction(uint8_t whatever) {</code>

<code>//bunchacode</code>

<code>}</code></blockquote><blockquote>
==== jbaker8935's guide on creating trampolines for functions in higher memory: ====

what you can do is pick a function in one of your projects that isnt time critical and create a trampoline function for it using this pattern:

void FAR8_video_init(void);

<pre>
#pragma clang optimize off
__attribute__((noinline))
void video_init(void) {
volatile unsigned char ___mmu = (unsigned char)*(volatile unsigned char *)0x000d;
*(volatile unsigned char *)0x000d = 8;
FAR8_video_init();
*(volatile unsigned char *)0x000d = ___mmu;
}
#pragma clang optimize on

__attribute__((noinline, section(".block8")))
void FAR8_video_init(void)
</pre>

note: that FAR8_video_init is the renamed function that is being moved. It's just a convention.
in your main you can call video_init as you do normally and the trampoline will take care of swapping the code into A000 in cpu memory.
For linking you need to create file f256.ld that sits in the project directory. it is a copy of "${ROOT}/llvm-mos/mos-platform/f256/lib/link.ld" but has additional linker instructions to explain how to deal with block8. à
Around line 100 or so you need to add instructions after the include output.ld statement. like so:

<pre>
/* Overlay Segments and Binary Data */
INCLUDE output.ld

/* Hand Coded output.ld records */
SHORT(8*0x2000)
BYTE(8/8)
SHORT(end_block8 - __block8_lma)
BYTE(0x00)
TRIM(block8)
</pre>

i'm using f256build.sh and the normal 'everything in src' structure. Also I didnt fiddle with moving the default stack or swap page, so this example trampoline is using A000 (writing to 0x000d). Note that the mmu is left in edit mode, so the trampolines can just write to 000d with no disabling of interrupts.</blockquote>

=== Oscar64 ===
<blockquote>Oscar64 is a C/C++ cross compiler running on a modern system (such as a Windows PC, Mac or Linux machine) and targets the classic 6502 family of processors. It is mainly focused on Commodore systems such as the C64, PET or VIC20. The compiler supports C99 and many C++ features up to variadic templates and lambda functions.

The purpose of this compiler is to eliminate the need to write 6502 assembler code to achieve high code density and fast execution speed. It continues to improve with all the games, demos and tools written by it. It supports disk overlays and banked cartridges for larger projects.

Oscar64 was adapted for the F256/WildBits by swdfrost and [https://github.com/sdwfrost/oscar64 here is a link its github page]. You will also need the adaptation of the f256lib (ported over from llvm-mos) [https://github.com/sdwfrost/f256lib-oscar64 from this github page] as well, which also includes many projects examples as well. </blockquote>

==== Documentation ====
The main documentation website is located here: https://github.com/drmortalwombat/oscar64/blob/main/oscar64.md

==== Getting set up on Windows 10/11 (-Mu0n) ====
<blockquote>Assumptions:

* Windows' WSL is installed (ie with Ubuntu)
* Python is installed inside windows
* make is installed inside WSL
* gcc is installed inside WSL ('''sudo apt install build-essential''')
</blockquote>
Step 1) in Windows, make a base directory (let's call it '''BASEPATH''') that will hold both:

* the oscar64 project, but with the 'f256k-support' branch rather than 'main' branch <nowiki>https://github.com/sdwfrost/oscar64</nowiki>

* the f256lib-oscar64 project, 'main branch' <nowiki>https://github.com/sdwfrost/f256lib-oscar64</nowiki>

(both from sdwfrost's GitHub account)

Step 2) from windows, open a cmd window, go to your intended base folder

Step 3) type WSL

Step 4) clone oscar64 with

'''git clone -b f256k-support <nowiki>https://github.com/sdwfrost/oscar64.git</nowiki>'''

Step 5) clone f256lib-oscar64 side by side in the same base folder.

'''git clone -b main <nowiki>https://github.com/sdwfrost/f256lib-oscar64</nowiki>'''

Both ''''oscar64'''<nowiki/>' and ''''f256lib-oscar64'''<nowiki/>' folders will be in the same location when this is done.

Step 6) go into oscar64/

Step 7) type:

'''make -f make/makefile'''

(this assumes gcc being present in WSL, it will take a while!)

Step 8) switch over to f256lib-oscar64/ and type:

'''OSCAR64=../../oscar64/bin/oscar64 make all'''

(warning 1: at the time of writing this guide, the 2nd project, BachHero, triggers an error that halts the whole list. Simply remove that entry from /f256lib-oscar64/doodles/MakeFile to get the rest going) (warning 2: most projects will compile, but not run properly when run in the Wildbits environment since they expect extra library files that have not been ported over)

Step 9) to compile a single project in general, make sure you use a path that points to the compiled oscar64 of step 7 like so: (assuming your project myproject is in BASEPATH/f256lib-oscar64/doodles/)

'''BASEPATH/oscar64/bin/oscar64 -tm=f256k -n -i=BASEPATH/f256lib-oscar64/f256lib BASEPATH/f256lib-oscar64/doodles/myproject/src/myproject.c -o=BASEPATH/f256lib-oscar64/doodles/myproject/myproject.pgz'''

==== Embedding assets ====
Here's an example of a few assets loaded in a specific spot in memory, starting from 0x10000. It needs to be part of a section, then a region and then some array identifiers that point to the data itself. When the project compiles, you can check out the layout of the memory being used inside your .map file.

<pre>
/*
* The following assets will be located within these bounds
*
10000 - 10400 : grupal, DATA:assets
10400 - 10800 : sBoy1, DATA:assets
10800 - 10c00 : sThing, DATA:assets
10c00 - 11000 : sGirl1, DATA:assets
11000 - 11400 : sCath, DATA:assets
11400 - 11800 : sCat, DATA:assets
11800 - 12000 : sDash, DATA:assets
*/

#pragma section( assets, 0 )
#pragma region( assets, 0x10000, 0x20000, , , {assets} )
#pragma data(assets)
__export const char grupal[] = { //1kb palette from 0x10000 to 0x103FF
#embed "../assets/grudge.pal"
};
__export const char sBoy1[] = { //16x16 sprite of 1kb from 0x10400 to 0x107FF
#embed "../assets/boy1.bin"
};
__export const char sThing[] = {
#embed "../assets/thing.bin"
};
__export const char sGirl1[] = {
#embed "../assets/girl1.bin"
};
__export const char sCath[] = {
#embed "../assets/cath.bin"
};
__export const char sCat[] = {
#embed "../assets/cat.bin"
};
__export const char sDash[] = {
#embed "../assets/dash.bin"
};

//return to normalcy
#pragma data(data)</pre>

==== Trampoline scheme for functions in higher memory ====
Much like assets, you will have to use the #pragma directive to set up a section and region for each chunk of RAM. Since a trampoline scheme gets used here in conjunction with the machine's MMU, these regions should be 0x2000 big, or 8kb.

Keep in mind that these chunks of RAM will be swapped in and out of the 0xA000 to 0xBFFF 8kb chunk visible by the CPU.

Here is the list of stuff you must define for it to work:

* A specific number for your code's block = physical address / 0x2000 you have in mind to stash your code. For example, to use the 8kb of code space between 0x10000 and 0x11FFF, this will be "overlay block 8". For the space between 0x12000 and 0x13FFF, this is "overlay block 9"
* #pragma directive such as:<pre>
// Overlay 1: stored at physical 0x10000, compiled to run at 0xA000
#pragma section( ovl1_code, 0 )
#pragma region( ovl1, 0x10000, 0x12000, , , { ovl1_code }, 0xA000 )
</pre>
* Forward declaration of a trampoline function used to access the higher memory function, such as:
<pre>
// ---------------------------------------------------------------------------
// Forward declarations of trampolines (in main code, always visible)
// ---------------------------------------------------------------------------

void firstSegment(int arg1, int arg2);

// Trampolines save the current bank 5 mapping, switch to the target
// overlay's physical block, call the FAR function, then restore the
// original mapping. This supports nested cross-overlay calls.

void firstSegment(int arg1, int arg2) {
volatile byte saved = PEEK(OVERLAY_MMU_REG);
POKE(OVERLAY_MMU_REG, OVL1_BLOCK);
FAR_firstSegment(arg1, arg2);
POKE(OVERLAY_MMU_REG, saved);
}

</pre>

* Your far memory function in between #pragma code directives:
<pre>
#pragma code( ovl1_code )

void FAR_firstSegment(int arg1, int arg2) {
textPrint("firstSegment = ");
textPrintInt((int32_t)(arg1 + arg2));
textPrint("\n");
// Call into overlay 2 via trampoline (in main memory)
}

//return to normalcy
#pragma code( code )
</pre>Note: it's perfectly ok to define multiples of these high memory regions. One far memory function can call another far memory function from another region without issue, but it has to call it through its lower memory trampoline.

==== Compiling a program, scripts from Mu0n ====
I use a pair of scripts that are located in BASEPATH/f256lib-oscar64/doodles/

Here's the shell script ("c.sh") I use to simply compile a program, this works regardless if your project uses one .c file or multiples. Adjust your absolute paths to what you have on your modern computer. "projectname" is the folder of your project inside the "doodles" folder.

run it using the command <nowiki><code>./c.sh myprojectname</code></nowiki><pre>
#!/bin/bash

# --- 1. CONFIGURATION ---
OSCAR_BIN="/mnt/d/F256/oscar64/bin/oscar64"
# Use the Windows python launcher (it handles COM8 perfectly)
PYTHON_EXE="python.exe"
# Use the Windows path for the script (escaped backslashes)
FOENIX_MGR="D:\\F256\\llvm-mos\\f256dev\\FoenixMgr\\FoenixMgr\\fnxmgr.py"

# --- 2. ARGUMENTS ---
PROJ_NAME="$1"
SRC_DIR="${PROJ_NAME}/src/"
SRC_FILE="${PROJ_NAME}/src/${PROJ_NAME}.c"
OUT_DIR="${PROJ_NAME}/"
BIN_FILE="${PROJ_NAME}.pgz"
FLAGS="-tm=f256k -n -v -i=../f256lib"
# --- 3. Gather all files in src/

mapfile -t CFILES < <(find "$SRC_DIR" -maxdepth 1 -type f -name "*.c")

# --- 4. COMPILE ---
echo "Compiling:"
printf '%s\n' "${CFILES[@]}"
echo
echo "Linking into ${OUT_DIR}/${PROJ_NAME}.pgz"
$OSCAR_BIN $FLAGS "${CFILES[@]}" -o="./$OUT_DIR/$PROJ_NAME.pgz"
</pre>Here's the shell script ("car.sh" = Compile And Run) I use to compile a program and send it over to my Wildbits through the foenixmgr script. This assumes that your host is win11 and python is run from that, from inside WSL ubuntu. Tweak to your setup's situation, of course.

run it using the command <nowiki><code>./car.sh myprojectname</code></nowiki>

2026-02-14T15:13:17Z

1BitFeverDreams:

describes booting times in relation to the strategy of getting fpga cores to the fpga

Firmware

2026-02-14T14:59:22Z

1BitFeverDreams: moving the RP2040 firmware to its own hardware maintenance page

== System Flash ROM ==
The Foenix F256K, Jr., K2 and Jr2 computers contain 512K of flash memory which is intended to store software which should be available to the user without any media like SD-cards or IEC drives present. Think of it like a space traditionally occupied by ROM chips of 80's computers containing critical, often used programs and routines, but instead of being very rarely updated with scarce ROM chip revisions, it can be quickly updated with firmware revisions using the FoenixMgr python scripts.

'''Important Note''': for the F256K2, each core has its own dedicated area of 512K of flash memory. When switching to a new core, a separate dedicated area of 512K exists for that core and there's an expectation that the process of flashing the firmware has to be done for it.

This collection of software can be changed by the user by simply reprogramming the flash "ROM". At the moment (2025+) the following applications are stored in flash as a default loadout:
{| class="wikitable"
|+Collection of 6502/65816 firmware programs as of firmware release version 2025.13
!Absolute Block* in Memory Map
!Block* Offset in onboard Flash
!Name of program
!Description
|-
|0x40
|0x00
|'''''reserved'''''
|
|-
|0x41
|0x01
|xdev
|trampoline program meant to react to developper scripts from [[FoenixMgr]]: pcopy, runpgz, runpgx
|-
|0x42 to 0x45
|0x02 to 0x05
|superbasic
|if xdev has nothing to react to, superbasic is your default startup program
|-
|0x46
|0x06
|dos
|minimalistic file management and info shell
|-
|0x47
|0x07
|'''''free'''''
|
|-
|0x48
|0x08
|fcart
|allows a user to flash the 256K Flast Cart with 8kb prepared blocks. See [[CartFlasher|this for usage]]
|-
|0x49
|0x09
|'''free'''
|
|-
|0x4A
|0x0A
|help
|text help on screen for superbasic programming
|-
|0x4B to 0x4E
|0x0B to 0x0E
|'''''free'''''
|
|-
|0x4F
|0x0F
|wget
|web get, works only for gen1 K and Jr equipped with a feather wifi board
|-
|0x50 to 0x56
|0x10 to 0x16
|fm
|f/manager - a rather feature rich file manipulation, program launcher and memory exploration software
|-
|0x57
|0x17
|'''''free'''''
|
|-
|0x58 to 0x5B
|0x18 to 0x1B
|mless
|moreorless - a text editor. See [[Moreorless|here for more information.]]
|-
|0x5D to 0x7B
|0x1D to 0x3B
|'''''free'''''
|
|-
|0x7C to 0x7F
|0x3C to 0x3F
|microkernel
|the microkernel, gadget's masterpiece used by many programs
|}
<nowiki>*</nowiki>Block: each block of flash memory is 8kb is size

To reprogram the flash, you can start with the [https://github.com/FoenixRetro/f256-firmware/releases official firmware releases in this github.]

This repo is part the [https://github.com/FoenixRetro FoenixRetro] Github organisation which in turn is an attempt to gather forks of all projects which are part of the firmware and other resources relevant for the Foenix F256 new retro computers.

There are now two firmware loads available: Gen1 - for K and Jr and Gen2 - for K2 and Jr2. The only difference between these loads is the superbasic part of the firmware, in order to have a properly identified superbasic startup screen that reflects the exact computer and generation in the logo.

====== Video tutorial: ======
A part of a tutorial video covers updating the firmware as a follow up step to updating the FPGA core, check it at 6:45 and on.

<youtube>pOab0ocKqac</youtube>

==== 6809 firmware: ====
This core has specialized firmware - it is best to ask around in the appropriate channels of the [https://discord.gg/9vjUEGgcUS Foenix discord].

Raspberry Pi Pico Update

2026-02-11T05:09:16Z

1BitFeverDreams: /* Overview */