adafruit-mirror/pico-mac
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update README

Browse source
This commit is contained in:
Jeff Epler 2025-03-28 08:34:27 -05:00
parent e98a74b69c
commit 2593d665b0
1 changed files with 23 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
README.md
View file

@ -1,37 +1,44 @@
# Pico Micro Mac (pico-umac) # Pico Micro Mac (pico-umac)
v0.21-fruitjam 22 March 2025 v0.21-fruitjam 28 March 2025
I (@jepler) have run roughshod across the code, breaking things willy-nilly and adding I (@jepler) have run roughshod across the code, breaking things willy-nilly and adding
* 512x342 & 640x480 digital output on HSTX * 512x342 & 640x480 digital output on HSTX
* PIO USB * PIO USB
* PSRAM support * PSRAM support
* Some Sound support * Some Sound support on the onboard I2S DAC (speaker and headphones)
* To enable that, some VIA timer 2 support
The two main variants offered are the "400kB" mac with a 640x480 resolution & a Several pre-compiled variants are offered:
4MB mac with 512x342 resolution (presented centered on a 640x480 display). * 400kB or 4096kB (the latter uses PSRAM, and may perform slower overall but can run more software)
* 512x342 or 640x480 desktop resolution (512x342 is more compatible but has black screen margins)
For now, I2S is on pins A1 (data) A2 (LRCK) A3 (bit clock). With any luck it'll be moved to the on-board I2S soon. * overclocked or not (overclocked may run faster but may be less reliable)
What works? What works?
* System beep * System beep
* A fair amount of hypercard, though not playing melodies with 'play "Boing" "a b c"'
* Hypercard 'play "Boing"' does play audio though (as does 'beep')
* Dark Castle including audio * Dark Castle including audio
* After Dark screensavers including audio * After Dark screensavers including audio
* Glider works, but without sound
What almost works What doesn't work?
* Glider was working, but my sound changes made it boot with an error about missing coprocessor?? (appears linked to the timer2 implementation) * Hypercard "play" and some hypercard screen transitions
There are artifacts that you can grab from the latest Actions build, at least until they expire. Some of the software I tested with:
Some good Mac software:
* https://archive.org/details/HyperCardBootSystem7 * https://archive.org/details/HyperCardBootSystem7
* https://archive.org/details/mac_DarkCastle_1_2 * https://archive.org/details/mac\_DarkCastle\_1\_2
* https://archive.org/details/AfterDark2 * https://archive.org/details/AfterDark2
Plug mouse & keyboard into the USB ports of the fruit jam.
Put the software (a mac HFS volume with no additional headers or metadata) on a
SD card as "umac0w.img" (if you want to be able to write files) or
"umac0ro.img" (if you want the drive to be read only) and press the reset
button to start.
**Important note on overclocking:** The "oc" uf2 files overclock your RP2 chip to 264MHz. Simply including the `<Adafruit_dvhstx.h>` header enables this overclocking, separate from the option in the Arduino Tools menu.
Just like PC overclocking, there’s some risk of reduced component lifespan, though the extent (if any) can’t be precisely quantified and could vary from one chip to another.
Proceed at your own discretion.
v0.21 20 December 2024 v0.21 20 December 2024