[{"element_type":"text","content":"\n        \u003cp style=\"text-align: center;\"\u003e\u003cem\u003eThis is a quick overview of using Pico-Mac.\u003c/em\u003e\u003c/p\u003e\n      ","metadata":{}},{"element_type":"text","content":"\n  \n  \n  \n  \n  \n        \u003cp\u003eIf you're a certain age, this project will take you right back to the 11th grade computer lab, full of black \u0026amp; white Macintosh computers with floppy disks.\u003c/p\u003e\n\u003cp\u003eWe took the excellent pico-mac emulator and fine tuned a few things for the Adafruit Fruit Jam:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eThe RP2350's HSTX peripheral is used to create a digital video signal on the board's DVI-D video output (compatible with HDMI monitors)\u003c/li\u003e\n\u003cli\u003eThe on board USB hub is supported, so you can connect a keyboard \u0026amp; mouse to the two USB ports\u003c/li\u003e\n\u003cli\u003eThe SD card is supported, so you can load your favorite Macintosh software\u003c/li\u003e\n\u003cli\u003eThe PSRAM chip is supported and can emulate a 4MB Macintosh (otherwise, up to 400kB of RAM can be emulated)\u003c/li\u003e\n\u003cli\u003eThe I2S audio chip is supported, so you can hear the basic system beep (as well as digital audio from\u0026nbsp;\u003cem\u003esome\u003c/em\u003e games and applications) on the internal speaker or via the external speaker/headphone jack\u003c/li\u003e\n\u003c/ul\u003e\n      \n\n\n\n\n","metadata":{}},{"element_type":"text","content":"\n        \u003ch2\u003eInstall the Emulator\u003c/h2\u003e\n\u003cp\u003eThere are multiple emulator images provided, each with different settings:\u003ca class=\"Truncate\" href=\"https://github.com/adafruit/pico-mac/releases/download/1.0.0-alpha.0/pico-mac-adafruit_fruit_jam-4096k-640x480-psram.uf2\"\u003e\u003cspan class=\"Truncate-text text-bold\"\u003e\u003c/span\u003e \u003cspan class=\"Truncate-text\"\u003e\u003c/span\u003e \u003c/a\u003e \u003cspan class=\"color-fg-muted text-right flex-shrink-0 flex-grow-0 ml-2 ml-sm-3 ml-md-4\"\u003e\u003c/span\u003e\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\"4096k\" emulates a Mac with 4MB RAM, using the psram chip, while \"400k\" emulates a non-standard mac with 400kB RAM without using psram. For applications that do not need much RAM, the \"400k\" emulator may be faster. \"-psram\" accompanies \"4096k\" as a reminder that this uses the PSRAM chip.\u003c/li\u003e\n\u003cli\u003e\"640x480\" emulates a Mac with a standard VGA resolution screen. \"512x342\" emulates the original Mac desktop resolution precisely.\u003c/li\u003e\n\u003cli\u003e\"-oc\" overclocks the Fruit Jam to 264MHz for faster emulation. This overclocks the RP2350 chip that powers the Fruit Jam. 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. (\u003cem\u003e-oc -psram\u003c/em\u003e\u003cem\u003e builds, if added, also overclock the PSRAM chip to 133MHz\u003c/em\u003e)\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eIf you're not sure which image you want, choose 4096-512x342-psram.\u003c/p\u003e\n\u003cp\u003ePlug the Fruit Jam into your computer with a good USB C data cable. While holding down the UF2 button (Button #1), slide the power switch from OFF to ON. Or, if your Fruit Jam was already powered on, hold the UF2 button and press the reset button briefly.\u003c/p\u003e\n\u003cp\u003eYour Fruit Jam will connect in bootloader mode, adding a drive called \"RP2350\" to your computer. Simply drag or copy the umac uf2 file to this drive.\u003c/p\u003e\n\u003cp\u003eAfter the firmware loads, the device will reboot into the umac emulator.\u003c/p\u003e\n      ","metadata":{}},{"element_type":"text","content":"\n  \n        \u003ch2\u003eUsing the built-in image\u003c/h2\u003e\n\u003cp\u003eThe built in image is simply the \u003ca href=\"https://archive.org/details/mac_MacOS_6.0.8\"\u003eSystem 6.0.8 Startup disk from archive.org\u003c/a\u003e. It's useful for checking out whether your keyboard \u0026amp; mouse work, but it doesn't have any useful applications on it.\u003c/p\u003e\n\u003cp\u003e\u003cem\u003eWe can relatively easily package any bootable disk image e.g., from archive.org instead, as long as it fits within about 5MB. Just update the URL in \u003ccode\u003efetch-rom-dsk.sh\u003c/code\u003e and the checksums in \u003ccode\u003eroms.sha256sum\u003c/code\u003e.\u003c/em\u003e\u003c/p\u003e\n      \n","metadata":{}},{"element_type":"text","content":"\n  \n  \n  \n  \n  \n  \n  \n  \n  \n        \u003ch2\u003eUsing an SD card image\u003c/h2\u003e\n\u003cp\u003eumac uses \"raw disc images\". These images can be any size, from 400kB to 1.44MB and even hard drive size. These images will always begin with the two bytes \"LK\" and often have the \".img\" suffix.\u003c/p\u003e\n\u003cp\u003eCopy your selected disc image to the root folder of the sd card and rename it to have exactly one of these two names:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eumac0.img, if the emulator is allowed to make changes to the disc image\u003c/li\u003e\n\u003cli\u003eumac0ro.img, if the emulator must treat the image as read only\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e\u0026nbsp;\u003c/p\u003e\n      \n\n\n\n\n\n\n\n\n","metadata":{}},{"element_type":"text","content":"\n  \n  \n  \n  \n  \n  \n  \n  \n        \u003ch2\u003eSome images that work well with the emulator\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003eglider (sounds don't work right)\u003c/li\u003e\n\u003cli\u003edark castle\u003c/li\u003e\n\u003cli\u003esystem 7 hypercard (sounds and some card transitions don't work right)\u003c/li\u003e\n\u003c/ul\u003e\n      \n\n\n\n\n\n\n\n","metadata":{}},{"element_type":"text","content":"\n  \n  \n        \u003ch2\u003eLimitations \u0026amp; problems\u003c/h2\u003e\n\u003cp\u003eDue to a limitation of the HSTX peripheral in \"1bpp\" color mode, it's not possible to achieve \"fully black\" and \"fully white\" pixels. You can have white \u0026amp; grey, or black \u0026amp; grey. As a result, the PSRAM builds and 512x342 builds have their \"black\" pixels actually appear as grey; and the 640x480, 400kB build has its \"white\" pixels appear as grey.\u003c/p\u003e\n\u003cp\u003e\u003cem\u003eIn my opinion the \"white \u0026amp; grey\" mode is actually evoking the feel of a CRT with the brightness pushed up too far, it's kinda charming retro. But maybe I'm fooling myself.\u003c/em\u003e\u003c/p\u003e\n\u003cp\u003eSometimes the keyboard or mouse misbehave. I've found that using the on/off switch to fully power cycle everything will usually fix it. Hot plugging keyboard \u0026amp; mouse should also be possible.\u003c/p\u003e\n      \n\n","metadata":{}},{"element_type":"text","content":"\n  \n  \n  \n        \u003ch2\u003eOther things a full guide might touch on ...\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003eHow to use a PC or modern Mac to copy items to a floppy image\u003c/li\u003e\n\u003c/ul\u003e\n      \n\n\n","metadata":{}}]