Shop OBEX P1 Docs P2 Docs Learn Events
Let's make a P2 hardware cookbook — Parallax Forums

Let's make a P2 hardware cookbook

Andrey DemenevAndrey Demenev Posts: 419
edited 2026-06-06 13:21 in Propeller 2

I started putting together a simple web site that will serve as a community maintained Propeller 2 hardware cookbook.

The idea is this: a git repository with a bunch of markdown files, each file being a recipe. Recipe can belong to one or more topics and a difficulty level. There is some code that converts the file into a site where visitors can browse the recipes by topic and/or difficulty. Contributors can fork the repository, add recipe(s) and submit a pull request

I am just getting started, the site is not available online, I just want to validate the idea. Please let me know if you think this can be useful, and more importantly if you would contribute.

Comments

  • JonnyMacJonnyMac Posts: 9,839
    edited 2026-06-06 15:02

    I like your idea. I'm constantly reminding my new/inexperienced programming friends to just "play" with small experiments and small bits of hardware -- it all adds up in the end.

    BTW, with the pin functions in the P2, you don't have to set the dir bit -- it's handled by the function.

    Also, newcomers might be confused by the schematic having two boxes marked LED. May I suggest:

        Px ----[220R]----[+ LED -]---- GND
    

    Ada created a neat website for P2 assembly instructions that allows one to type and find -- it's very convenient. That kind of site with small examples for instructions would be excellent for new Spin2 programmers.

    -- https://p2docs.github.io/

  • JonnyMacJonnyMac Posts: 9,839
    edited 2026-06-06 17:38

    I wonder... can you have multiple code sections so that you can move from verbose to refined?

    If I may, I'd like to see a little more whitespace in listings. It costs nothing and aids readability.

    Very small contribution attached. This shows three iterations of the same button input program. I don't know the rules of the mark-up language you're using so I just tried to mimic what you did in your example.

  • @JonnyMac Thanks

    I am not ready to add actual recipes yet, I want to make the app first. Actually, that single recipe I have was ai generated, I just needed something that looks realistic, not necessarily correct or polished

    @JonnyMac said:
    I wonder... can you have multiple code sections so that you can move from verbose to refined?

    Yes, absolutely. As many code sections as needed.

  • RaymanRayman Posts: 16,457

    Maybe a web version of something like this:
    https://forums.parallax.com/discussion/175417/

  • There are already so many places where some information might be hidden for P2. Isn't it possible to use obex or the forum? Perhaps a new category has to be implemented?

Sign In or Register to comment.