inspin

A native development environment that runs on the Propeller 2.

see:

docs/GUIDE.md

docs/BUILD.md

docs/GETTING-STARTED.md

docs/GETTING-STARTED-PASM.md

⚠ Project status: living code, no promises. This project is in active flux and changing rapidly, with no fixed roadmap and no declared end state — my own instruments are the roadmap. I (Shannon Mackey) use this driver extensively in real projects and continue to flush out issues on real hardware; interfaces move, behavior gets re-derived whenever the silicon disagrees with the documentation, and anything here may change without notice. Extensive regression harnesses live in harness/ and everything claimed below was validated on the bench when written — but I make no claims and offer no warranties of any kind: the MIT license's AS-IS terms (LICENSE) are the entirety of the promise. If it breaks on your bench, a field report with reproduction steps (see docs/feedback/) is the most valuable thing you can send.

License

MIT - see LICENSE. Files under vendor/ and the linked P2_USB_HID_CDC_ACM_MSC tree remain under their own authors' terms.

Acknowledgements

inspin stands on the work of people who shared what they built, and it is a pleasure to say so plainly:

• Chip Gracey and Parallax Inc. - for the Propeller 2 itself, the Spin2 language and PASM2 instruction set, the ROM and the v55 interpreter whose bytecode this project compiles to and steps through, the 80x40 VGA text driver (vendor/chip_vga_text.spin2), and the anti-aliased line and small-font demos this repo carries. The P2 is a singular machine; every page of this project is a thank-you note to it.
• Stephen M Moraco (Iron Sheep Productions) - for PNut-TS, the compiler gold standard this project measures itself against byte for byte, for PNut-Term-TS, which loads and flashes every image on this bench, and for the P2 Knowledge Base, from which the on-drive /REF instruction cards are generated. Faithful tools, faithfully maintained.
• Roger Loh (rogloh) - for the PSRAM driver (vendor/psram.spin2, vendor/psram16drv.spin2) that gives the graphics console its 32 MB framebuffer. It simply works, at speed, on shared pins.
• pik33 (Piotr Kardasz) - for the P2-retromachine graphics work whose geometry, desktop palette, and fonts (vendor/retromachine/) shaped gfxcon's scanout and look.
• Jon "JonnyMac" McPhalen - for jm_i2c.spin2 and jm_ds3231.spin2, the I2C and RTC objects behind the date command, and for years of exemplary Spin style the community learns from.
• Marco Maccaferri - for Spin Tools, whose spinc is the reference compiler the on-P2 Propeller 1 compiler golds against, 13 programs byte-identical.
• The Parallax P2 community and OBEX contributors - the forum threads, driver sources, and hard-won pin lore that informed the USB, video, and smart-pin work here. Where a specific technique came from a specific thread, the source comments say so.

The USB host stack is the sibling P2_USB_HID_CDC_ACM_MSC project, linked into src/usbhost and used strictly through its public API.