Firmware notes Downloads Docs

Card holders · latest release 1.42

Firmware notes

What changed in each build, newest first. Updates install over the air from the card. On a GS, open CoGS Config (Open-Apple-Control-Esc), press 0 for About, then U for Firmware Update. On any Apple II, hold C or M at power-on for the card's own menu and take the same About, then U path. The card downloads the build, checks it, and reflashes itself. Wi-Fi and settings are kept.

The list below is the builds that changed what the card does. Bench-only builds and the small steps between them are folded into the release that carried them. A card runs whatever release was current when it was built; the update path above brings it to the latest. Updates to the GS-side software (the link layer, Control Panel, NDA, and the cogsall and cogsutil disks) are listed here too, dated, marked as disk updates; those need no card update.

1.42

2026-11-10latest release
  • Favorites. Press * (or F) on the highlighted row of any disk list to add it, and the same key takes it off. That works in Featured, Recent, a category, GS and 8-bit titles, A-Z, Find results, Your source and the local catalog. A marked row shows * at the left, and the line above the key bar says what the key will do. Browse Disks gets a *  Favorites row under Featured and Recent with the count. On that page Return boots, 1-8 mounts on a drive, 0 unmounts, X takes one row off and A clears the list. The list holds 18 disks, sorted by name, and is kept in the card's flash.
  • CoGS Catalog Local R/W. Image Manager 1.9 on a Mac and ACIM 0.3 everywhere else can download the whole CoGS disk catalog (2,444 titles, about 1.9 GB) to a computer on your network and serve it writable. The card lists it as C  CoGS Catalog Local R/W on Browse Disks, above Your source, and C opens the same hub you know from the a2cogs catalog: Featured, Recent, Favorites, the six shelves, GS and 8-bit titles, A-Z, and Find by name. Disks you mount from there are your copies, so a high score or a change to a GS/OS volume is saved. Both programs are on the Downloads page.
  • Image/Audio Source has a fourth slot for the local catalog, under Disks, Audio and Pictures. S scans the network as before, and the pick page adds C for the local catalog and T for all four. On the page itself C now edits the fourth slot and X clears all four. C was clear through 1.41.
  • Rows on Recent and Favorites that came from your own share or the local catalog say yours or local, so you can tell a streamed title from your writable copy of it. A favorite mounts from wherever you marked it.
  • Factory Reset clears all four source slots and Recent. Favorites are kept; A on the Favorites page clears them.

Update from the card: CoGS Config (Open-Apple-Control-Esc), About / Update, then U.

1.41

2026-11-08
  • Music keeps playing through disk reads. The slot ROM used to hold interrupts off while it waited for the card to fetch a disk block, so anything interrupt-driven stalled for the length of the fetch: radio and file playback from CoGS Config stuttered whenever the Finder touched a disk, and a program playing its own music while it loads from a CoGS drive skipped on every fresh block. Flatline's VS screen and stage loads were the case on the bench, and the same holds for any GS/OS program with an Ensoniq player or a Tool225/226 stream running during disk reads. The ROM now waits with interrupts open, from a part of the card's ROM that an interrupt cannot pull out from under it. Tested on ROM 01 with an AppleSqueezer and on ROM 3.
  • Two disks with the same name. Picking the same disk for two drives, say from your own share and from a2cogs, used to bring up GS/OS's "There are two disks named ..." dialog, and Eject on that dialog froze the Finder. The card now keeps the second one empty for the session and Browse or Disk Drives says which drive already has that volume. An empty drive also answers the way a 3.5 drive does after an eject, so the Finder moves on.
  • A disk mounts while the radio plays with TCP/IP connected. In that state the card had no cache memory left for a new disk, its first directory read failed, and the Finder ejected it with "can't read". The card now makes room by parking the least recently used disk's cache in flash. Browsing is slower with both the radio and TCP/IP up; the reads are right.
  • Starting stereo playback from the menu no longer times out at 31 seconds and bounces back to the menu.
  • A boot that dies early, or a disk GS/OS ejects, no longer overwrites the disk's learned boot manifest (the list of blocks the card pre-warms on the next mount).

Update from the card: CoGS Config (Open-Apple-Control-Esc), About / Update, then U.

CoGS software update: AppleSqueezer SD card volumes

2026-10-29disk update, no card update

The streamed GS/OS disks (cogsall, cogsasq, gsfly, Demoscene, Communications) now carry Antoine Vignau's ASSDDriver in System:Drivers, so booting from CoGS on an AppleSqueezer v2 with an SD card (core 14 or later) mounts all of the SD partitions, not just the first. If you boot your own image, the driver is in the Drivers folder on cogsutil; copy it into System:Drivers and reboot. On a machine without an AppleSqueezer the driver finds nothing and GS/OS leaves it out.

Two things about slots on a Squeezer SD machine. Setting slot 5 to Your Card turns off the IIgs's built-in slot 5 SmartPort, and the Squeezer's SD boot rides on it, so Startup = ROM Disk stops booting the card with or without CoGS. Keep CoGS in any slot but 5. And Startup = Scan boots the CoGS card before the SD, so set Startup to ROM Disk for the SD or to the CoGS slot for the card.

1.39

2026-10-29
  • CoGS Config takes keys on a System with EasyAccess installed (Apple's sticky-keys init, in System.Setup on a stock System 6 install). The menu waited for a key with interrupts off, and EasyAccess delivers the keyboard through an interrupt, so the keyboard and Ctrl-OpenApple-Reset went dead until a power cycle. Found on the AppleSqueezer's SD card System.
  • A Game Room join no longer fails about one time in six. Cloudflare's WebSocket reply had outgrown the card's buffer, so the join was refused while the lobby had already seated the player. Found with Pole Position head-to-head.
  • A disk URL typed in capitals (HTTP://, HTTPS://) mounts.
  • A DNS failure says so on Status, in the Support Snapshot, and when Browse Disks times out, instead of reading as a bad card. With a static IP, the message points at the static DNS entry.

CoGS software update: Marinetti link layer 1.4

2026-10-27disk update, no card update

Fixed a bug in v1.3 of the Marinetti CoGS link layer. v1.4 fixes a crash if you had streaming audio and a Marinetti connection up at the same time. The two were sharing the card and stepping on each other. 1.4 is on the cogsall and cogsutil disks in Browse Disks as of tonight.

If you copied the 1.3 link layer onto your own GS/OS image, grab the new one from cogsutil (TCPIP/COGS) and copy it over System:TCPIP:CoGS, then reboot. You should now be able to stream audio in the background and keep a Marinetti connection up.

1.38

2026-10-26
  • Leaving the Config menu after a boot image failed brings the menu back with the reason, instead of dropping to the firmware's "Check startup disk". Found on a real machine the night 1.37 went out.
  • A boot image whose certificate is not trusted gives up after two attempts; other failures keep five.
  • The card's log records how long each failed boot-image attempt took.

1.37

2026-10-26
  • Slot ROM: a SmartPort STATUS from a Pascal or ProDOS 8 program no longer writes into the caller's zero page, and the card's 65816 code never runs on a 65C02. Henry Lowe's Card Cat (Apple Pascal) crashed with a Stack overflow right after probing the card on a GS and reboot-looped an enhanced //e; it now lists the card. Any 8-bit program that polls the card went through the same path.
  • Starting another radio station or podcast episode after a Stop plays at your volume instead of the lowest level.
  • A boot image whose connection keeps failing (certificate not trusted, host not found, connection refused) gives up after five tries and the Config menu says which, instead of sitting at Booting until Ctrl-Reset.
  • A GS/OS Restart, or any boot that arrives without a reset on the slot, closes the previous session's connections, so a Game Room seat is not left waiting on the server.

1.36

2026-10-26
  • Two-player Doom over the card. A program can open a WebSocket through the card the way it opens a TCP socket; the card does the TLS, the upgrade and the framing. Doom for the IIGS gains a Network Game menu row and plays deathmatch or cooperative against another machine through the Game Room lobby. Stream it from Browse Disks as Doom CoGS Deathmatch; it needs an accelerated IIGS.
  • Podcasts under Internet Radio: top shows, genres, find by name, episode lists with dates and lengths, resume where you stopped, Recent episodes.
  • A slideshow over the radio no longer falls back to the picture list when a slide fetch goes quiet. The fetch is re-issued on a fresh connection inside the slide's wait; three kinds of stall were caught on real machines at 128 and 192 kbps.
  • Disks served from archive.org boot again. archive.org moved to a new certificate chain in January and the card's root bundle did not carry it; Night Driver IIgs and Pitch Darker sat at Booting.
  • A program's first connection on socket 0 is no longer refused while the boot disk is still streaming; the card's own connections take the top slot.
  • The card-injected desk accessory is free of its 16 KB size ceiling, and about 40 KB of RAM went back to the heap.
  • Carries 1.34 and 1.35, which were bench and iron builds that were never posted on their own.

1.32

2026-10-20
  • Recent disks survive a power-off. Since 1.14 the list had only lived in the card's RAM and was rebuilt from the mounted drives at each boot, so anything you had mounted from Browse or from the Image Manager was gone after the power switch.
  • Boot hang on the Apple IIgs banner after a quick power cycle with an AppleSqueezer on core 15. Core 15 puts the 65816's indexed-store dummy read on the slot bus, spaced further from the write than a stock CPU, and the card's repair window was sized for stock. The window is wider now and only ever undoes the read that immediately preceded the write, so stock and TransWarp machines behave as before.
  • The CoGS Config menu opens while the radio plays, and Browse Pictures and box art work over the music.
  • Boot passes down the slot chain when the card is a secondary card, so a SCSI or other boot card ahead of it still boots.
  • Disk Drives: a digit moves the selected image to that drive, 0 unmounts it.
  • Control Panel shows the firmware version and holds while the radio plays.
  • Firmware Update page shows two lines of build notes.
  • Last Session log keeps the useful lines; the wired-port poll line backs off once the link settles.
  • Slideshow runs the whole folder, not one page, and across scanned-image weeks.
  • Fixes: Net K counter past 16 MB, a stale digit on the play clock, parked connections dropped when the network route changes, radio error paths time-bound so a bad stream cannot wedge the player.

1.31

2026-09-29
  • CoGS Config is back in the CDA menu after a Finder Shut Down followed by Restart.

1.30

2026-09-29
  • Shut Down keeps the saved drive mounts in every slot, including the Restart button. Finder Eject still removes them.

1.27 and 1.28

2026-09-28
  • Short power cycles boot again (a merged reset edge was eating the first frame).
  • Setting the GS clock from the card no longer reports failure after a successful write.

1.26

2026-09-26
  • Finder padlock follows the Writable switch in Image Manager 1.6, so a read-only share mounts read-only.
  • Wired Ethernet bridge gets its own MAC address.
  • Marinetti link layer 1.3 with poll mode, less time spent in interrupts.
  • Remount hold so a quick reset does not drop the mounted images.

1.21 to 1.25

2026-09-25
  • Finder Eject unmounts the network image.
  • Memory: every big buffer moved to a fixed pool, CA roots in flash, idle connections reaped. The card no longer runs out of heap on long sessions.
  • Volume windows capped at two with the least recent evicted, so many mounted images do not starve each other.

1.13 to 1.16

2026-09-17 to 2026-09-23
  • Your source: the Image Manager share's own folders appear as categories under Y.
  • Recent disks on Browse and Disk Drives.
  • CoGS Config installs on a 2 second quiet timer instead of during boot.
  • Over-the-air download survives a server that ignores Range requests.
  • Stream failures are named on screen instead of a bare error code.

1.08 to 1.12

2026-09-15 to 2026-09-16
  • Writable network disks. Block writes go through the slot window on a kept-alive connection with a write-behind ring.
  • One image, one drive. Mounting the same image twice is refused.
  • CoGS Config installs on a GS that did not boot from the card.

1.03

2026-09-14
  • Boot Menu: pick the boot image by number at power-on.
  • Static IP for the card.
  • Machine ID so Image Manager can tell cards apart.

1.00

2026-09-13milestone
  • Boot manifests. The card learns which blocks a boot reads and streams them ahead next time, so a GS/OS boot off the network is a fraction of the earlier time.
  • Over-the-air update rides the same stream engine as disks.

Before 1.0

0.236 to 0.243

2026-09-10 to 2026-09-12
  • Faster disk reads. Block copies run at full speed under GS/OS, use a 16-bit window, and the read path stops popping the FIFO one byte at a time. TransWarp boot time went from 31.7 s to 20.5 s across these builds.
  • The config menu and clock write move to a card-served overlay, freeing slot ROM.

0.220 to 0.221

2026-09-09
  • The audio tools (Tool226 and Tool219) are served by the card and injected at play time. No disk needs them.
  • CoGS Config install dropped from 22 s to under a second on stock and TransWarp machines.

0.200 to 0.210

2026-09-01 to 2026-09-05
  • Browse by function: disks, audio, and pictures each get a category hub.
  • Native SoundSmith playback, with background play, volume, and stereo.
  • Pictures viewer shows HGR and DHGR next to SHR.
  • Live status and signal strength on every menu page.

0.181 to 0.186

2026-08-31milestone
  • Browse Pictures. SHR images stream from the card into the CDA, with a slideshow and a W key to set the Finder wallpaper.

0.153 to 0.178

2026-08-29 to 2026-08-31
  • Tool226, the CoGS audio tool, with stereo and hi-res PCM on a stock GS.
  • Volume follows the Control Panel and survives Stop.

0.94

2026-08-21milestone
  • Internet radio. The card decodes MP3 streams and hands PCM to the Ensoniq.

0.73 to 0.81

2026-08-08 to 2026-08-09milestone
  • In-menu firmware updates from a2cogs.com.
  • CoGS Config installs on every GS ROM.
  • Marinetti bridge: the GS gets its own DHCP identity on the network through the card.

0.53

2026-07-19
  • GS clock set from the card, with auto-sync at boot.

0.12 to 0.24

2026-06-22 to 2026-06-29milestone
  • Network storage. Disk images stream from a2cogs.com and mount as SmartPort drives.
  • Multi-unit mount table, stock ProDOS 8 disks boot when streamed.

0.4

2026-06-18
  • First boot on real hardware. Wi-Fi join, NTP, TLS, and the slot menu.

Downloads are on the Download page. Manuals on Docs. Questions to [email protected].