Home
JAQForum Ver 24.01
Log In or Join  
Active Topics
Local Time 07:45 07 Jun 2025 Privacy Policy
Jump to

Notice. New forum software under development. It's going to miss a few functions and look a bit ugly for a while, but I'm working on it full time now as the old forum was too unstable. Couple days, all good. If you notice any issues, please contact me.

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

     Page 1 of 3    
Author Message
matherp
Guru

Joined: 11/12/2012
Location: United Kingdom
Posts: 10134
Posted: 10:54am 01 Jun 2025
Copy link to clipboard 
Print this post

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.
 
Plasmamac

Guru

Joined: 31/01/2019
Location: Germany
Posts: 573
Posted: 01:39pm 01 Jun 2025
Copy link to clipboard 
Print this post

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
Plasma
 
matherp
Guru

Joined: 11/12/2012
Location: United Kingdom
Posts: 10134
Posted: 03:31pm 01 Jun 2025
Copy link to clipboard 
Print this post

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

PicoMite User manual 6.00.02.pdf
 
Nimue

Guru

Joined: 06/08/2020
Location: United Kingdom
Posts: 411
Posted: 03:56pm 01 Jun 2025
Copy link to clipboard 
Print this post

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.
Entropy is not what it used to be
 
Mixtel90

Guru

Joined: 05/10/2019
Location: United Kingdom
Posts: 7681
Posted: 05:05pm 01 Jun 2025
Copy link to clipboard 
Print this post

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.
Mick

Zilog Inside! nascom.info for Nascom & Gemini
Preliminary MMBasic docs & my PCB designs
 
JanVolk
Senior Member

Joined: 28/01/2023
Location: Netherlands
Posts: 231
Posted: 06:47pm 01 Jun 2025
Copy link to clipboard 
Print this post

Peter,

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

Greetings,

Jan.
 
matherp
Guru

Joined: 11/12/2012
Location: United Kingdom
Posts: 10134
Posted: 07:20pm 01 Jun 2025
Copy link to clipboard 
Print this post

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

Yes there is
 
Amnesie
Guru

Joined: 30/06/2020
Location: Germany
Posts: 549
Posted: 09:05pm 01 Jun 2025
Copy link to clipboard 
Print this post

  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.
 
disco4now

Guru

Joined: 18/12/2014
Location: Australia
Posts: 988
Posted: 07:49am 02 Jun 2025
Copy link to clipboard 
Print this post

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.
Latest F4 Latest H7 FotS
 
circuit
Senior Member

Joined: 10/01/2016
Location: United Kingdom
Posts: 272
Posted: 09:49am 02 Jun 2025
Copy link to clipboard 
Print this post

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.
 
Volhout
Guru

Joined: 05/03/2018
Location: Netherlands
Posts: 4954
Posted: 10:03am 02 Jun 2025
Copy link to clipboard 
Print this post

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
PicomiteVGA PETSCII ROBOTS
 
matherp
Guru

Joined: 11/12/2012
Location: United Kingdom
Posts: 10134
Posted: 10:50am 02 Jun 2025
Copy link to clipboard 
Print this post

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
 
Peter63
Regular Member

Joined: 28/07/2017
Location: Sweden
Posts: 51
Posted: 02:26pm 02 Jun 2025
Copy link to clipboard 
Print this post

  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
 
Mixtel90

Guru

Joined: 05/10/2019
Location: United Kingdom
Posts: 7681
Posted: 06:37pm 02 Jun 2025
Copy link to clipboard 
Print this post

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. :)
Mick

Zilog Inside! nascom.info for Nascom & Gemini
Preliminary MMBasic docs & my PCB designs
 
EDNEDN
Senior Member

Joined: 18/02/2023
Location: United States
Posts: 134
Posted: 07:22pm 02 Jun 2025
Copy link to clipboard 
Print this post

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'.
 
toml_12953
Guru

Joined: 13/02/2015
Location: United States
Posts: 405
Posted: 08:38pm 02 Jun 2025
Copy link to clipboard 
Print this post

  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
 
Nimue

Guru

Joined: 06/08/2020
Location: United Kingdom
Posts: 411
Posted: 08:46pm 02 Jun 2025
Copy link to clipboard 
Print this post

  toml_12953 said  

Returns the standard deviation

to
Returns the sample standard deviation



An unbiased opinion there.... (drops the mic and walks out...    )
Entropy is not what it used to be
 
Volhout
Guru

Joined: 05/03/2018
Location: Netherlands
Posts: 4954
Posted: 08:49pm 02 Jun 2025
Copy link to clipboard 
Print this post

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
PicomiteVGA PETSCII ROBOTS
 
toml_12953
Guru

Joined: 13/02/2015
Location: United States
Posts: 405
Posted: 09:08pm 02 Jun 2025
Copy link to clipboard 
Print this post

  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.
 
phil99

Guru

Joined: 11/02/2018
Location: Australia
Posts: 2508
Posted: 09:55pm 02 Jun 2025
Copy link to clipboard 
Print this post

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 3    
Print this page
The Back Shed's forum code is written, and hosted, in Australia.
© JAQ Software 2025