Shop Learn
Propeller 2 Users: Get Started Here! — Parallax Forums

Propeller 2 Users: Get Started Here!

Ken GraceyKen Gracey Posts: 7,246
edited 2021-02-25 05:18 in Propeller 2

Get Started with the Propeller 2! This thread is the complete getting started resources, as designed by the community. Please reply and post your additions/changes/improvements and I (or another moderator) will continue to modify this first post.

These forums are a very valuable resource and are community managed and supported. The backgrounds include many engineers, hobbyists, and educators who also participated in the development of Propeller 2. When you ask questions, the P2 community will likely provide a detailed answer. Please thank them for their support along the way!

Ken Gracey, CEO
Parallax Inc.
(916) 625-3010 Direct line


  • Place holder

  • Got it, @ersmith.


  • Thanks for this, Ken! I'm very late to the party, and this entry ramp onto the P2 expressway will help me to catch up.


  • RamonRamon Posts: 461

    Hello, I want to get started with Propeller Tool but can not !

    Propeller Tool 2.5.2 doesn't recognize Retroblade2 board. This seems a SW bug in Propeller Tool.

    Command 'Run > Identify hardware (F7)' reports 'No Propeller found on any serial port. Scanned COM4.'

    Hardware and serial driver (CP2102) are correctly working. The Propeller Serial Terminal (inside Propeller Tool) is able to connect and transfer data (tested at 9600 and 115200 bauds). Flexprop/loadp2 do not have any problem to compile code and load into p2.

    Thank you!

  • Cluso99Cluso99 Posts: 17,660

    Jeff is working on it.
    Just to make sure we are talking about the same problem, do you have an SD card plugged in, and if so, is it formatted FAT32 and does not have either boot files "_BOOT_P2.BIX" or "_BOOT_P2.BIY" in the root directory.
    I presume you are using the CP2102 and have the transistor link enabled as per the diagram on the RetroBlade2 thread?

  • RamonRamon Posts: 461

    Yes, I have the SD card plugged in, and transistor reset jumper is in "Q" position (close to pin 04).

    Wait, I have just removed the SD card and it now works!

    Why this happens? Flexprop/loadp2 can compile with the SD card plugged in.

    Thank you so much !!

  • evanhevanh Posts: 10,789
    edited 2021-03-13 05:14

    If the SD has a valid boot file then that takes precedence. Same happens for loadp2. This has stopped me using SD cards because I like to try lots of combinations in quick fire.

  • @"Ken Gracey" said:
    Get Started with the Propeller 2! ...

    • Documentation - Spin2 Programming Guide, PASM Documentation, Datasheet

    I've just noticed that a real datasheet is still missing. What happened to Sams (sjgallagher2) work?

  • @ManAtWork said:

    @"Ken Gracey" said:
    Get Started with the Propeller 2! ...

    • Documentation - Spin2 Programming Guide, PASM Documentation, Datasheet

    I've just noticed that a real datasheet is still missing. What happened to Sams (sjgallagher2) work?

    Sam's work and others has been brought into our own process. Every Wednesday, our team meets at 8:00 am Pacific to further the datasheet and Propeller 2 manual along their critical paths. Chip has defined the test procedures for electrical characteristics, Jeff and Stephanie have developed the process for iterative releases, and we should show some results soon. My request of the team has been to make frequent releases and involve the community in a perpetual feedback cycle.

    Two weeks ago I was told we'd see some early results about now.

    Ken Gracey

  • RamonRamon Posts: 461

    Please, help!

    I cannot find the ROM BOOT process documentation.
    Some information bits dispersed over the forum here and there, but no link on :

    How is the BOOT process? Default register (Program counter) state after reset?
    Interrupt vectors initialization, how to RESET?, or how to HALT the MCU?. How user code can be uploaded/executed ...

    ... The kind of things that a new MCU usually explains in the very first chapter.

    There is a comment (last paragraph: by David Betz, 2018-12-24) that suggest that there was once a document. Where to find it?

    (sorry for markdown mess, tried many times, but I was not able to frame all the following text into 'CODE')


    P2 BOOT:

    if "> Prop_Chk 0 0 0 0" then print "Prop_Ver G" (and then does it HALTS? How to go into TAQOZ or MONITOR?)

    if ">" ESC then GOTO TAQOZ ' from TAQOZ, if Ctrl-D then GOTO ROM MONITOR

    if "> " Ctr-D then GOTO ROM MONITOR ' From MONITOR, if ESC CR then GOTO TAQOZ


                               '    A = rev A silicon
                               '    B..F = various FPGA boards
                               '    G = rev B silicon


    xxxxxx : xx xx xx xx ... <cr>  DOWNLOAD:  to   cog/lut/hub {addr1} following {byte(s)}
    xxxxxx - [xxxxxx] [L] <cr>     MEM LIST:  from cog/lut/hub {addr1} to < {addr2}  L=longs
    xxxxxx G <cr>                  GOTO:      to   cog/lut/hub {addr1}
    Q <cr>                         QUIT:      Quit Rom Monitor and return to the User Program
                                                 {addr} is on the stack<cr>              LOAD:      Load file from SD   (8.3 filename)
                                                 returns "=" on success, "!" on failure<cr>              RUN:       Run  file from SD   (8.3 filename)
                                                 returns "!" on failure
    <esc><cr>                      TAQOZ:     goto TAQOZ
    <cr>                                      will repeat last MEM LIST command

    P2 chip reset : HUBSET ##$1000_0000 ' what is the HEX OPCODE? Propeller tool doesn't recognize this instruction

    P2 chip halt : ??????

    P2 RAM binary upload : (ozpropdev python implementation)

    sp1.write(b'> Prop_Txt 0 0 0 0 ')
    sp1.write(b'~')  #run code

    "I just read the documentation and the "~" character that the Python loader
    uses to end the program loading command bypasses checksum validation. You
    can also end the command with "?" which will result in a "." response if
    the load was success and the program started and "T" if the checksum
    failed. So it seems you can get a positive ACK. I withdraw my comment."

  • I've finally got a project in mind that's worthy of the P2. But please bear with me. It's gonna take some time, along with some rather exotic hardware.

    Hint: it involves optics.


  • evanhevanh Posts: 10,789

    Boot precess is at the end of the hardware doc. Parts of it are in Verilog. Ah, looking at it now, I see someone has messed it up a little by inserting the whole assembly table verbatim in the middle.

    Halt!? Not really one, as the architecture is not of a CPU type. Switching off the clock would do it ... hard-reset needed to recover though. :D There is of course low power options.

    Why wouldn't Proptool not be able to do a reset? HUBSET is used for many things, the reset function is just another number.

  • evanhevanh Posts: 10,789

  • SuracSurac Posts: 144
    edited 2021-04-09 16:40

    Is the Google Document "Parallax Propeller 2 Documentation v35 - Rev B/C Silicon" still maintained?
    Suggestions and changes are not getting approved or dismissed for a long time now.

  • I've just cleaned up some of the suggestions, but others will remain for a while as they are considered.

    If you have any particular questions please start a thread in the Propeller 2 category and we'll be sure to help if we can.
    If there's anything the community cannot answer quickly, I'll send a note for the question to be raised at the next P2 Zoom meeting so the right person can help directly.

  • @Surac Thanks for bringing this up. In addition to @VonSzarvas's suggestions, for something short/quick/direct to write, please continue to comment on the v35 - Rev B/C Silicon document as we've left it active for this purpose.

Sign In or Register to comment.