FlexGUI 4.3.1: Program your P2 in Spin, BASIC, or C
ersmith
Posts: 6,038
The latest version of FlexGUI is available at:
https://github.com/totalspectrum/flexgui/releases/.
Get the "flexgui.zip" file from the latest release, and unpack it anywhere convenient (it should be a location that you have read/write access to, e.g. your desktop, rather than a system folder like "Program Files"). Both Windows and Macintosh binaries are included with this release.
NOTE: FlexGUI is not in any way affiliated with Parallax, and please do not direct any questions about it to Parallax support.
FlexGUI supports programming both the P1 and the P2, in BASIC, Spin, and C, and also comes with interfaces for Python, Forth, and Lisp programming (those last 3 languages rely on an interpreter to run on the P2, rather than compiling the code directly). The Spin support comes in two flavors: Spin 1 with extensions (if the file has a .spin suffix) and Spin 2 with extensions (if it has a .spin2 suffix). Either one can be compiled for either P1 or P2. There's not a lot of difference between them, mostly it's in the operators, e.g. to use the keyword operators like FRAC you'll have to use .spin2.
It's very easy to get started with FlexGUI. Just run flexgui.exe (or flexgui.tcl for the Mac). You'll see a window open. Type something like:
This release has a lot of improvements compared to earlier versions of FlexGUI. The BASIC language has many more operators and built-in functions (thanks in part to contributions by @JRoark ) and now supports multiple assignment and functions which return multiple values. The Spin language supports more of Chip's proposed Spin2 syntax, including method pointers. There have been many bug fixes, especially in the C compiler.
In the GUI, the Help menu has been expanded to allow easy access to language references. It's now possible to set the command output font in the "Editor Options..." menu, and there's also an option there to automatically reload files if they are changed in an external editor (e.g. if you're using the PropTool to edit Spin files but want to program them to your P2). The "Special" menu has options for downloading MicroPython, FORTH, or Lisp programs. The "Serial" menu now has an option for setting the baud rate. Under "Commands" are options for programming the flash; the "Flash program" can also be changed to an SD card loader to allow programming of binaries to SD cards.
Have fun, and please report any problems you run into either here or on the github issues page.
https://github.com/totalspectrum/flexgui/releases/.
Get the "flexgui.zip" file from the latest release, and unpack it anywhere convenient (it should be a location that you have read/write access to, e.g. your desktop, rather than a system folder like "Program Files"). Both Windows and Macintosh binaries are included with this release.
NOTE: FlexGUI is not in any way affiliated with Parallax, and please do not direct any questions about it to Parallax support.
FlexGUI supports programming both the P1 and the P2, in BASIC, Spin, and C, and also comes with interfaces for Python, Forth, and Lisp programming (those last 3 languages rely on an interpreter to run on the P2, rather than compiling the code directly). The Spin support comes in two flavors: Spin 1 with extensions (if the file has a .spin suffix) and Spin 2 with extensions (if it has a .spin2 suffix). Either one can be compiled for either P1 or P2. There's not a lot of difference between them, mostly it's in the operators, e.g. to use the keyword operators like FRAC you'll have to use .spin2.
It's very easy to get started with FlexGUI. Just run flexgui.exe (or flexgui.tcl for the Mac). You'll see a window open. Type something like:
print "hello from the P2"into the window, then press the "Compile & Run on P2" button. It'll prompt you for a name to save the file as (it needs to save the file before compiling); enter something like "hello.bas", since this is a BASIC program. You'll then get a terminal window popping open with the "hello from the P2" message. If you prefer C or Spin, you can also enter those languages instead; just name the file appropriately with a ".c" or ".spin" extension.
This release has a lot of improvements compared to earlier versions of FlexGUI. The BASIC language has many more operators and built-in functions (thanks in part to contributions by @JRoark ) and now supports multiple assignment and functions which return multiple values. The Spin language supports more of Chip's proposed Spin2 syntax, including method pointers. There have been many bug fixes, especially in the C compiler.
In the GUI, the Help menu has been expanded to allow easy access to language references. It's now possible to set the command output font in the "Editor Options..." menu, and there's also an option there to automatically reload files if they are changed in an external editor (e.g. if you're using the PropTool to edit Spin files but want to program them to your P2). The "Special" menu has options for downloading MicroPython, FORTH, or Lisp programs. The "Serial" menu now has an option for setting the baud rate. Under "Commands" are options for programming the flash; the "Flash program" can also be changed to an SD card loader to allow programming of binaries to SD cards.
Have fun, and please report any problems you run into either here or on the github issues page.
Comments
On the FlexBASIC-side of the house, a quick look through the manual shows we have a bunch of new toys to play with.
The new functions available are: BIN$(), COS(), Decuns$(), Delete$(), EXP(), HEX$(), Insert$(), Instr$(), InstrREV$(), LOG(), Oct$(), PinRND(), _Reboot(), SHR aka >>, SHL aka <<, Sin(), Tan(), WaitX(), WRPin(), WXPin(), WYPin()
We also have a new emerging datatype: LongInt and ULongInt (64 bits!, early support)
It's going to be a fun day!...
EDIT: HA! Eric included an "easter egg" in the form of "\include\libsys\stringlibp2.bas". If you INCLUDE this in your code like this: ...then you also get these new functions: LCase$(), LPad$(), LTrim$(), Reverse$(), RPad$(), RTrim$(), Space$(), Trim$(), UCase$()
I recall seeing a starting clock frequency calculator. Basically Chip's idea to give a frequency and have it calculate the dividers and multipliers internally and set it during program startup.
Sorry, yes, I forgot to put that in the release notes -- the Spin compiler in P2 now works like Chip's Spin2, and can calculate a starting mode based on the desired clock frequency and input frequency (the input frequency defaults to 20MHz). Most of the Spin samples have been ported to use that method of setting the clock.
It is supply voltage, temperature, and batch sensitive.
Right, I was referring to the calculation of the PLL mode setting bits. Just as Chip described for his Spin2 compiler, fastspin will take a block like: and figure out the bits to use in hubset to set the clock to the desired frequency (and set this at boot time). If _xinfreq is not given it defaults to 20 MHz.
RCFAST is a different kettle of fish, but calculating the mode value for that is easy since it's just 0x0
Any chance of getting a similar functionality in FlexBASIC? This could be very useful.
A 100% chance
fastspin
- Fixed Spin REV operator to match PNut's Spin2 definition.
- Optimize some P2 moves into BMASK or DECOD instructions
- Allow the word "asm" to be used as a label in Spin
- Allow use of _ in integers in BASIC DATA/READ
loadp2
- Reduced the timeout used when searching for a P2 (if a comm port is explicitly given then the behavior should be the same as before)
flexgui
- Fixed a packaging bug where some demo files were missing
- Fixed a problem with the "Spin" help menu item
In the console: Looking through the Makefile, I don't see anything that produces and copies .html files to the flexgui doc directory. I do see the .md files and something about pandoc. Is that supposed to create the .html's? After installing pandoc, I get an error about pdflatex... Are PDFs supposed to be created? The .md files are copied to flexgui's doc directory, should they be opened when the Help menus are selected? Currently installing MacTeX to see if that solves the problem...
dgately
dgately
The most recent FlexGUI .zip file has Mac binaries, so if you run into a problem building anything you could always install the binary
dgately
The flexgui.zip file includes both Windows and MacOSX binaries, and is available from my Patreon page or from:
https://github.com/totalspectrum/flexgui/releases
ERROR: timeout waiting for initial checksum: got -1
I had a very solid P2 download when using older tools (my loadp2 was v 0.017 IIRC) prior to using this later version. What's changed with these timeouts since then? It would be good to have a reliable download tool working again. Something is timing out too soon by the looks of it, or the downloader is not starting up correctly every time. Loader baud rate is just the default (i.e. was not setup in loadp2 command string).
Here's the relevant code in the download sequence...the code appears to either not be waiting long enough for the response, the auto baud space character is sent too soon (50ms wait not enough for the COG to be ready?), or received too late, or the P2 reset is not working. Not sure what else would cause it. I think if a wait_drain() is added after the transmission of the "~" and before the 50ms sleep it might be better, so we know that the ~ has been sent out the wire and received by the COG before we send the auto baud char and expect a response. This would remove any serial buffering lag affecting the transaction. It's a better way to go than put in hardcoded 50ms delays etc. Same probably goes for the 10ms sleeps in the retries.
Roger.
tx((uint8_t *)"> Prop_Hex 0 0 0 0", 18); txstring((uint8_t *)MainLoader1_bin, MainLoader1_bin_len); txval(clock_mode); txval(flag_bits()); tx((uint8_t *)"~", 1); { int retry; // receive checksum, verify it's "@@ " msleep(50); tx_raw_byte(' '); for (retry = 0; retry < 5; retry++) { // send autobaud character tx_raw_byte(' '); msleep(10); num = rx_timeout((uint8_t *)buffer, 3, 200); if (num == 3) break; } if (num != 3) { printf("ERROR: timeout waiting for initial checksum: got %d\n", num); promptexit(1); } if (buffer[0] != '@' || buffer[1] != '@') { printf("ERROR: got incorrect initial chksum: %c%c%c (%02x %02x %02x)\n", buffer[0], buffer[1], buffer[2], buffer[0], buffer[1], buffer[2]); promptexit(1); } }First batch is with the loader default download rate, second is with it set to 2000000 which is visibly faster to download.
So maybe the download rate has something to do with it? I noticed that the flexgui defaults only set the operational baud rate (-b) in the command line not the loader rate (-l) so perhaps the default download rate is different now via flexgui. This was without the auto detection variable in play.
Sometimes the errors seem to bunch up and then there are periods where it is not behaving as bad. I wonder if it might be background OS CPU load activity affecting the timeout...though my MAC is about 97% idle. When it kicks in it seems pretty bad.
64 SUCCESS
65 ERROR: timeout waiting for initial checksum: got -1
66 Warning: Unknown version , assuming CHIP
ERROR: got incorrect initial chksum: G
(47 0d 0a)
diff --git a/loadp2.c b/loadp2.c index e541f3c..2d16722 100644 --- a/loadp2.c +++ b/loadp2.c @@ -523,11 +523,13 @@ int loadfile(char *fname, int address) { int retry; // receive checksum, verify it's "@@ " + wait_drain(); msleep(50); tx_raw_byte(' '); for (retry = 0; retry < 5; retry++) { // send autobaud character tx_raw_byte(' '); + wait_drain(); msleep(10); num = rx_timeout((uint8_t *)buffer, 3, 200); if (num == 3) break;Raw results:
Is that using the P2 boot loader ?
I see a comment about autobaud, but the P2 boot autobaud is ">" not " " ?
Does change of clock mode also send a new autobaud char ? (should be before any other chars, but after P2 has had time to change speed )
General Chip comments have suggested to use autobaud refresh, but I'm not sure how critical that is, as the P2 oscillators are quite stable ( < 1% short term ?)
Maybe it actually does matter, and the slower downloads mean more time to drift, so have lower yields ?
What size is your download ?
The downloaded image file size in the above cases was 288384 bytes.
CON tx_pin = 62 rx_pin = 63 dbg_pin = 56 FLAGBIT_ZERO = $1 ' if set, zero HUB memory FLAGBIT_PATCHED = $2 ' if set, clock frequency was patched into binary '' smart pin modes ser_txmode = %0000_0000_000_0000000000000_01_11110_0 'async tx mode, output enabled for smart output ser_rxmode = %0000_0000_000_0000000000000_00_11111_0 'async rx mode, input enabled for smart input DAT org begin hubset clkmode_ 'set up oscillator waitx ##25_000_000/100 'wait >10 ms or clkmode_, #3 'enable XI+PLL mode hubset clkmode_ 'enable oscillator test flagbits, #FLAGBIT_ZERO wz if_z jmp #skipzero '' zero out memory wrfast #0,#0 mov pb, ##$7c000/16 zeroloop wflong zeros wflong zeros wflong zeros wflong zeros djnz pb, #zeroloop rdfast #0,#0 ' wait for last byte to be written skipzero restart '' set up uart smart pins '' we don't know for sure what the frequency is, so use '' auto baud rate detection for this dirl #rx_pin dirl #tx_pin call #autobaud mov pa, waitbit ' autobaud set waitbit shl pa, #16 or pa, #7 ' set for 8 bits wrpin ##ser_txmode, #tx_pin wxpin pa, #tx_pin dirh #tx_pin wrpin ##ser_rxmode, #rx_pin wxpin pa, #rx_pin dirh #rx_pin '' try to receive a space '' if it works, autobaud is OK, otherwise re-try .space testp #rx_pin wc if_nc jmp #.space rdpin rxbyte, #rx_pin shr rxbyte, #24 cmp rxbyte, #$20 wz if_nz jmp #restart '' send 0 to host to indicate we are ready setup mov chksum, #0 call #send_chksum read_file mov chksum, #0 '' read file address call #ser_rx_long mov loadaddr, rxlong '' if first time through, set starting address cmp startaddr, ##-1 wz if_z mov startaddr, loadaddr '' read file size call #ser_rx_long mov filesize, rxlong wrfast #0,loadaddr 'ready to write entire memory starting at address nop ' give time to settle .mainloop call #ser_rx wfbyte rxbyte 'write to hub add chksum, rxbyte djnz filesize,#.mainloop 'loop until all bytes received rdfast #0,#0 'wait for last byte to be written '' respond to host call #send_chksum '' check host response '' if they send "+" then look for another file call #ser_rx cmp rxbyte, #"+" wz if_z jmp #read_file waitx ##80_000_000/10 ' short pause to ensure sync '' shut down smart pins dirl #tx_pin dirl #rx_pin wrpin #0, #tx_pin wrpin #0, #rx_pin ' switch back to rcfast mode, maybe ' if the binary was patched with -PATCH then we skip this test flagbits, #FLAGBIT_PATCHED wz if_nz jmp #start_cog ' patched, so start right now ' go back to rcfast mode andn clkmode_, #3 hubset clkmode_ hubset #0 start_cog waitx ##25_000_000/10 coginit #0,startaddr 'launch cog 0 from starting address send_chksum mov temp, chksum shr temp, #4 and temp, #$f add temp, #"@" call #ser_tx mov temp, chksum and temp, #$f add temp, #"@" call #ser_tx mov temp, #" " jmp #ser_tx ser_tx wypin temp, #tx_pin waitx #20 .txflush testp #tx_pin wc if_nc jmp #.txflush ret ' receive a byte from serial ser_rx testp #rx_pin wc if_nc jmp #ser_rx rdpin rxbyte, #rx_pin _ret_ shr rxbyte, #24 ' receive a long from serial ser_rx_long call #ser_rx mov rxlong, rxbyte call #ser_rx shl rxbyte, #8 or rxlong, rxbyte call #ser_rx shl rxbyte, #16 or rxlong, rxbyte call #ser_rx shl rxbyte, #24 _ret_ or rxlong, rxbyte ' automatically detect baud rate ' based on length of shortest 1 or 0 ' we see next autobaud dirl #rx_pin waitx ##1000 mov mask, ##(1<<(rx_pin-32)) mov port, #1 test port, #1 wc ' set C to distinguish INA/OUTA test port, #2 wz ' set Z (match on =) setpat mask, #0 ' wait for pin lo (start bit) waitpat setpat mask, mask ' wait for pin hi (first 1) waitpat getct a setpat mask, #0 ' wait for pin lo again (following 0) waitpat getct b setpat mask,mask ' wait for pin hi again (end of 0 sequence) waitpat getct waitbit sub waitbit, b sub b, a fle waitbit, b mov a, waitbit shl a, #3 waitx a ret zeros long 0 startaddr long -1 'starting address waitbit long 99999 orgf $100 clkmode_ res 1 'clock mode flagbits res 1 'flag bits, see definitions above loadaddr res 1 'address for load filesize res 1 'binary file size in bytes count res 1 rxbyte res 1 'received byte rxlong res 1 'received longword temp res 1 chksum res 1 mask res 1 port res 1 a res 1 b res 1Also it's a lot slower but just got 100 resets in a row working fine with -SINGLE and the current 4.1.2 loadp2 codebase without my other wait_drain() modifications. That way uses the inbuilt loader and takes a different path in the software. So it looks like the timeout error is only related to this new protocol invented for new features etc. Something new in the MainLoader1.Spin2 file or the C file has got out of whack and causing timeouts, at least on my Mac, perhaps Linux too though the serial software pipeline in the OS could be different there vs the Mac implementation.
I'm also running on a MacBook Pro, but not seeing any loader failures. This is with loadp2 version 0.042 built on my Mac today (Feb 3 2020)... Your failures may not be caused by loadp2 itself. There may be some other system-related issue that you are seeing? Bad USB cable?
dgately
Intel(R) Core(TM) i5-5287U CPU @ 2.90GHz
Looking at the MainLoader1.Spin2 code in some more detail here is the fix I've found that I now think solves the issue...using it I now have 100% success with the download at both 2Mbps and the default (which I think might be 921600bps). This was with 100 iterations each.
What seems to be happening is that on my machine the two space characters being transmitted from the loadp2 code get buffered together (one space initially then the first one from the retry loop) and are arriving back to back on the P2 and in the PASM code the 8 bit waitx delay after auto baud means that the smartpin rx is not always ready for the 2nd space to arrive and it can get missed. Adding a wait_drain() in the right spot plus a 1ms delay solves it.
A slower machine that introduces longer gaps into the serial transmission between these space characters, or one with no buffering, may not see this problem.
From MainLoader1.spin2:
' automatically detect baud rate
' based on length of shortest 1 or 0
' we see next
autobaud
dirl #rx_pin
waitx ##1000
mov mask, ##(1<<(rx_pin-32))
mov port, #1
test port, #1 wc ' set C to distinguish INA/OUTA
test port, #2 wz ' set Z (match on
setpat mask, #0 ' wait for pin lo (start bit)
waitpat
setpat mask, mask ' wait for pin hi (first 1)
waitpat
getct a
setpat mask, #0 ' wait for pin lo again (following 0)
waitpat
getct b
setpat mask,mask ' wait for pin hi again (end of 0 sequence)
waitpat
getct waitbit
sub waitbit, b
sub b, a
fle waitbit, b
mov a, waitbit
shl a, #3
waitx a
ret
diff --git a/loadp2.c b/loadp2.c index e541f3c..c03da76 100644 --- a/loadp2.c +++ b/loadp2.c @@ -523,11 +523,15 @@ int loadfile(char *fname, int address) { int retry; // receive checksum, verify it's "@@ " + wait_drain(); msleep(50); tx_raw_byte(' '); + wait_drain(); + msleep(1); for (retry = 0; retry < 5; retry++) { // send autobaud character tx_raw_byte(' '); + wait_drain(); msleep(10); num = rx_timeout((uint8_t *)buffer, 3, 200); if (num == 3) break;