Menu
JAQForum Ver 19.10.27

Forum Index : Microcontroller and PC projects : PicoMite Draft manual V6.00.02 - please review

   Page 1 of 5    
Posted: 10:54am
01 Jun 2025
Copy link to clipboard
matherp
Guru

PicoMite User manual 6.00.02.pdf


Attached is the first cut at a manual for version 6.00.02. This has not yet been tidied up by Geoff (indexing etc.) but please review to see if any new functionality you are aware of is missing or any comments you have raised are now covered.
 
Posted: 01:39pm
01 Jun 2025
Copy link to clipboard
Plasmamac
Guru


if you want the direct reading from the ADC you can use the raw mode by using the AEAW option to the
SETPIN command:
SETPIN pinno,ARAW
typo in Page 47
 
Posted: 03:31pm
01 Jun 2025
Copy link to clipboard
matherp
Guru

Minor updates
AEAW fixed
RAM command added
Changes to SUB and FUNCTION definitions to support BYVAL

PicoMite User manual 6.00.02.pdf
 
Posted: 03:56pm
01 Jun 2025
Copy link to clipboard
Nimue
Guru


Still reading - but need to acknowledge the huge amount of work that this represents.

I have a printed / bound v5.07.07 manual that I adore (if that's not too sad).

The work in bringing together a 240 page manual should not be underestimated. Plus the coding / curation in MMBasic that this represents.

Geoff / Peter (and the army of others - sorry for not listing them all) - thank you.

I've dipped into many coding/hardware communities since my Usenet / Newsgroup days in the 1990's and the community here is the most supportive and least toxic I've come across.  Reading the posts of an evening is like dropping down the pub with a pint or 2.
 
Posted: 05:05pm
01 Jun 2025
Copy link to clipboard
Mixtel90
Guru


The PIN() function entry says that it might return the wrong value, especially if configured as an open collector output. Unless someone knows differently, you can't configure a PicoMite pin as OC.
 
Posted: 06:47pm
01 Jun 2025
Copy link to clipboard
JanVolk
Senior Member

Peter,

There is no mention on page 44 and page 91 that there is also I2S support for the RP2040.

Greetings,

Jan.
 
Posted: 07:20pm
01 Jun 2025
Copy link to clipboard
matherp
Guru

  Quote  There is no mention on page 44 and page 91 that there is also I2S support for the RP2040.

Yes there is
 
Posted: 09:05pm
01 Jun 2025
Copy link to clipboard
Amnesie
Guru

  Nimue said  I've dipped into many coding/hardware communities since my Usenet / Newsgroup days in the 1990's and the community here is the most supportive and least toxic I've come across.  Reading the posts of an evening is like dropping down the pub with a pint or 2.


Same here. Never ever came across such an fantastic community.
 
Posted: 07:49am
02 Jun 2025
Copy link to clipboard
disco4now
Guru


LINE command
If width is given as a -ve value then width will apply to lines in all directions and they are centered on the given coordinates.
 
Posted: 09:49am
02 Jun 2025
Copy link to clipboard
circuit
Senior Member

On page 61, it is stated;

"The syntax is:
OPTION LCDPANEL controller, orientation [,backlightpin] [,DCpin] [,NORESET]
[DB0pin]"

But in your original announcement of the new parameter, DB0pin, you added;

"The new parameter only applies to the RP2350B and allows the starting pin for the 8 or 16 data pins to be specified (defaults to GP0)."

Does the new parameter DB0pin now apply to all or is it still specific to the 2350B?  Perhaps this needs a line in the text.
 
Posted: 10:03am
02 Jun 2025
Copy link to clipboard
Volhout
Guru

Working on it, expect more to come, but here is some already.

Page 16: OPTION CPUSPEED speed
        replace by a different example, since CPUSPEED is not available in all picomite platforms.

Page 16: Add note : VAR SAVE is cleared when a new program is loaded.

Generic: no bookmarks found

Page 94: 2x OPTION HEARTBEAT

Page 94/95: confusing OPTION KEYBOARD (includes repeat rate of USB KB) and OPTION KEYBOARD REPEAT (for USB keyboard)

Page 102: Add NEXT LINE as in PIO(NEXT LINE)

Page 185: Add PIO(NEXT LINE)


Volhout
 
Posted: 10:50am
02 Jun 2025
Copy link to clipboard
matherp
Guru

Thanks for the comments which I will either incorporate without commenting or if I'm not intending to make the change I will say why here.

  Quote  Does the new parameter DB0pin now apply to all or is it still specific to the 2350B?  Perhaps this needs a line in the text.

It is there on page 62 in the same section

  Quote  confusing OPTION KEYBOARD (includes repeat rate of USB KB) and OPTION KEYBOARD REPEAT (for USB keyboard)

The manual is correct. For USB keyboards you can set the repeat rates either way. The OPTION KEYBOARD REPEAT is a legacy setting that I will leave in this release

  Quote  Generic: no bookmarks found

Geoff will add these when I hand over the source file
Edited 2025-06-02 20:52 by matherp
 
Posted: 02:26pm
02 Jun 2025
Copy link to clipboard
Peter63
Regular Member

  Quote    Quote  
There is no mention on page 44 and page 91 that there is also I2S support for the RP2040.

Yes there is


the question that JanVolk asked was whether RP2040 is supported, I think

/Peter63
 
Posted: 06:37pm
02 Jun 2025
Copy link to clipboard
Mixtel90
Guru


On the issue of bookmarks, I seem to remember that Geoff addressed this a while ago. I think it was something about the format of the manual making it very difficult to get Word to bookmark now. If I'm wrong I'm sure someone will correct me. :)
 
Posted: 07:22pm
02 Jun 2025
Copy link to clipboard
EDNEDN
Senior Member

It would seem to me that the new RAM command should really be named PSRAM.

It doesn't really do anything with the internal RAM memory.   All of the options affect the PSRAM (if attached).    

And given the fact the PSRAM can't be used the same way as the internal RAM memory is used it is confusing to have the commands that affect it given a name of 'RAM'.
 
Posted: 08:38pm
02 Jun 2025
Copy link to clipboard
toml_12953
Guru

  matherp said  PicoMite User manual 6.00.02.pdf


Attached is the first cut at a manual for version 6.00.02. This has not yet been tidied up by Geoff (indexing etc.) but please review to see if any new functionality you are aware of is missing or any comments you have raised are now covered.


On a scan I see:

Page 5: Change references from 6.00.01 to 6.00.02

Page 93: The AUDIO ON/OFF is spelled AUDIO ON/OFFF. Is this the Oz spelling? I'll have to go over my grandkids' Bluey recordings to check.

Page 182: While not an error, it would be good to change

Returns the standard deviation

to
Returns the sample standard deviation
 
Posted: 08:46pm
02 Jun 2025
Copy link to clipboard
Nimue
Guru


  toml_12953 said  

Returns the standard deviation

to
Returns the sample standard deviation



An unbiased opinion there.... (drops the mic and walks out...    )
 
Posted: 08:49pm
02 Jun 2025
Copy link to clipboard
Volhout
Guru

Hi Peter,

Here are my votes: 12 points assigned to UK (and Australia) for creating such a wonderful extensive language. Wow.. in reading through the manual one is impressed by the wealth of MMBasic on pico. It will take years before I have used all these commands and functions....

Page 102: add also .LINE NEXT

Page 14: what if CPUSPEED too high, do you need CLEAR FLASH to erase the OPTION CPUSPEED toohigh before re-loading MMBasic ?

Page 12: is it an idea to move "new CPU variations" (related to non RP boards, and RP2350B) to a new appendix?

Page 20: F4 deletes and copies to the clipboard, F5 = PASTE clipboard back into text.
Actually F4 acts line <ctlr>X and F5 acts like <ctrl>V.
Remarkable that this has been in there for so long. Description differs from implementation.

This also applies for the mouse operation.

Page 30: As this runs independently of the main RP2040.. include RP2350

Page 34: Because the USB connector is used for other duties the Pico must be powered via 5V applied to the VSYS pin...add: or the Vbus pin if you desire to power the external hub/keyboard from the pico.

Page 40: add MM.INFO(path)

Page 40: Maybe create "LOAD BMP fname$" alias to "LOAD IMAGE fname$" to make it compatible with CMM2 ?

Page 41: PRINT #1, dat$ + SPACE$(64 – LEN(dat$); is missing a trailing bracket.

Page 44: I2S DAC audio is also supported on RP2040. But does not support MP3 playback on RP2040.

Page 44: Mention requirement for OPTION MODBUFF when playing MOD files here...

Page 45: PLAY NEXT, PLAY PREVIOUS, do they also work on MP3 ?

Page 48: Maybe you should add SETPIN GP7,PIN in the test describing period measurement, similar to the SETPIN GP7,CIN 3 lines lower.

Page 48: 12 PWM on RP2350A ? According datasheet only on RP2350B

Page 70: BLIT buffers are stored in native colourspace. In 2040 VGA they are in RGB121, this is most obvious when using blit to scroll the screen in a framebuffer that is RGB121.

Page 81: is MQTT still supported.?

Page 84: Naming conventions: look at the reserved keywords. Maybe the PIO list should be included, and the "HELP, BYTE, BIT etc.." command...

Page 85: program size update ? RP2040 VGA = 98kB (not 100). Others may also be affected.

Page 86: MM.VER = 6.0002

Page 96: for VGA and HDMI the OPTION LCDPANEL CONSOLE is not logical OPTION SCREEN CONSOLE would be more logical.

Page 96: OPTION LEGACY could be moved to the section "legacy commands". I tried it in MAXITREK and it does leave so many incompatibilities that I would not promote it.

Page 103: ADC START list of arrays... Explain what "Chan4arr!()" is.

Page 105: BITBANG may not be converted to DEVICE, but omitted.

Page 111: the DEVICE command is only still used for SERIALTX, SERIALRX and BITSTREAM. Maybe omit it ?

Page 113: DRIVE can also accept A: without quotes as described "A:"

Page 115: by some sort of democratic vote (who-ever shouts loudest) FLAG was revoked to BIT... correct ?

Page 126: LINE PLOT, in explanation replace "ydata" with "ydata()" to identify it is the array

Page 127: Adapt LOAD IMAGE to LOAD BMP if above is chosen to do so.

Page 147: maybe copy the PIO CONFIGURE example to the appendix on PIO
Page 147: PIO configure may benefit from the " _" line extension option.

Page 157: SERVO command can have values between -120 and 120 (not -20).

Page 160: SETPIN PIOn.. add a note how PIO2 is accessed in a RP2350B

Page 178: DEVICE(WII NUNCHUCK) text refers to WII classic.


Edited 2025-06-03 06:49 by Volhout
 
Posted: 09:08pm
02 Jun 2025
Copy link to clipboard
toml_12953
Guru

  matherp said  PicoMite User manual 6.00.02.pdf


Attached is the first cut at a manual for version 6.00.02. This has not yet been tidied up by Geoff (indexing etc.) but please review to see if any new functionality you are aware of is missing or any comments you have raised are now covered.


On page 113, DO UNTIL and LOOP WHILE aren't mentioned although they work fine.
 
Posted: 09:55pm
02 Jun 2025
Copy link to clipboard
phil99
Guru


Loop While works but Do Until doesn't.
> a=-3
> do until a=>0 :print a, :pause 1000 :inc a : loop
-3      -2      -1       0       1       2       3       4       5
> a=-3
> do :print a, :pause 1000 :inc a : loop while a=<0
-3      -2      -1       0
>

> a=-3 : do until a > 0 :print a, :pause 1000 :inc a : loop while a < 6
-3      -2      -1       0       1       2       3       4       5
>

Edited 2025-06-03 08:03 by phil99
 
   Page 1 of 5    
The Back Shed's forum code is written, and hosted, in Australia.
© JAQ Software 2025