Home
JAQForum Ver 24.01
Log In or Join  
Active Topics
Local Time 08:19 26 Nov 2024 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/WebMite/PicoMiteVGA - please post any know manual issues here

     Page 1 of 5    
Author Message
matherp
Guru

Joined: 11/12/2012
Location: United Kingdom
Posts: 9115
Posted: 11:06am 16 Oct 2023
Copy link to clipboard 
Print this post

 
matherp
Guru

Joined: 11/12/2012
Location: United Kingdom
Posts: 9115
Posted: 11:08am 16 Oct 2023
Copy link to clipboard 
Print this post

As per the title. I'm updating the manuals for V5.07.08 functionality but would like to get rid of any known errors as well. Rather than me trying to go back through all the posts since V5.07.07, if you are aware of any manual typos/bugs or omissions please post them on this thread

Thanks
 
Frank N. Furter
Guru

Joined: 28/05/2012
Location: Germany
Posts: 828
Posted: 11:24am 16 Oct 2023
Copy link to clipboard 
Print this post

In the example "LCD Display" (page 43 above PicoMite and page 37 PicoMiteVGA) GP23 and GP24 are used (BITBANG LCD INIT GP2, GP3, GP4, GP5, GP23, GP24), which are used internally in the Pico...

Frank
 
LouisG
Senior Member

Joined: 19/03/2016
Location: Australia
Posts: 124
Posted: 12:56pm 16 Oct 2023
Copy link to clipboard 
Print this post

In the function FORMAT$(nbr[,fmt$]) in sub-paragraph 'precision', it says
"If specified, the precision must be preceded by a dot (.)."

I tried not specifying precision because I was dealing with integers but kept getting  a decimal point and four decimal places (all showing zeros). In the end, to make it work I had to specify a precision of ".0" in order to display integers without any decimal fraction places. That fixed it.

You might want to clarify the wording. Perhaps the four decimal places is the default case when precision is not specified?

Regards and bon courage with the manual!
... Louis
 
NPHighview

Senior Member

Joined: 02/09/2020
Location: United States
Posts: 200
Posted: 02:59pm 16 Oct 2023
Copy link to clipboard 
Print this post

It would be absolutely wonderful to have an index. I've downloaded Word versions of the manuals, and started creating my own indices, but that's tedious work. I'd be happy to help. My process included developing a word-frequency list, knocking out the prepositions, adjectives, and adverbs, and starting from the remainder.

I also "gamed" the Amazon publishing-on-demand system by uploading a PDF version of the WebMite manual to their system so I could get a handy book format printed version.

To make this more useful as a bound volume, I modified the layout by setting left-page and right-page margins to provide more room for the binding, and page numbers at the bottom).

I put a copy of the fonts page on one of the inside covers, and pin-out diagram for the WebMite on the back cover.

As a "creator", I got a bound, printed review copy of the manual for a few dollars. (Previously, I'd paid big bucks to get a spiral-bound version from the local copy shop). Once the book arrived, I tabbed the "MM.Info", "Options", "Commands", and "Functions" sections for easy access.

It's still available on Amazon, but lost in the sea of other self-published stuff. It's only ever been printed once, for my "review" copy :-)

If that's of any interest, I'd be happy to do this again for our community.
Edited 2023-10-17 01:05 by NPHighview
Live in the Future. It's Just Starting Now!
 
lizby
Guru

Joined: 17/05/2016
Location: United States
Posts: 3150
Posted: 03:59pm 16 Oct 2023
Copy link to clipboard 
Print this post

  NPHighview said  I also "gamed" the Amazon publishing-on-demand system by uploading a PDF version of the WebMite manual to their system so I could get a handy book format printed version.


Good idea. Do you have a link? I searched for "WebMite Manual" and various other possibilities, but got nothing related. I don't want to buy that version, but might be interested in an edition for the upcoming manual.
PicoMite, Armmite F4, SensorKits, MMBasic Hardware, Games, etc. on fruitoftheshed
 
Amnesie
Guru

Joined: 30/06/2020
Location: Germany
Posts: 396
Posted: 04:31pm 16 Oct 2023
Copy link to clipboard 
Print this post

Peter mentioned that there exists:

mm.info(sound)


but it isn't in the manual at all. I searched for it, 0 results.

Greetings
Daniel
 
Volhout
Guru

Joined: 05/03/2018
Location: Netherlands
Posts: 4233
Posted: 05:50pm 16 Oct 2023
Copy link to clipboard 
Print this post

In the chapter about PIO, change the font of the code examples to match the rest of the manual (courier?)

Volhout
PicomiteVGA PETSCII ROBOTS
 
JanVolk
Senior Member

Joined: 28/01/2023
Location: Netherlands
Posts: 144
Posted: 07:22pm 16 Oct 2023
Copy link to clipboard 
Print this post

This is from my own manual:

Module works LCD1602 or HD44780 on 5V! Can also sometimes work on 3V3 with contrast at max. and reduce series resistance for LED. All I/O pins on the PicoMite can be used
and you don't have to set them in advance (the LCD command does that for you automatically).
It is better to use an 8 channel level shifter because the 5V is placed on RS, EN, D4-D7 and the gate breaks above 3V6!

But an I2C to parallel module on the back of the LCD can also remove the 2 x 4k7 on the module and connect it to the 3V3 bus.
And use a sub routine for i2c_lcd. This is somewhere on this forum with some minor adjustments. Works for 16x2 and 20x4 and also custom characters.

Jan
 
Andrew_G
Guru

Joined: 18/10/2016
Location: Australia
Posts: 847
Posted: 08:43pm 16 Oct 2023
Copy link to clipboard 
Print this post

Good idea Peter.
My suggestions are:
1. links to important source material on TBS e.g.:
 - Geoff's Projects
 - Updates for firmware, changes.txt and manuals
 - Fruit of the Shed
 - . . .
(These become second nature, after a while, but are important to newcomers or rank amateurs like me)

2. Important differences between PicoMite, PicoMiteVGA and WebMite. This is important to making the trade-offs between the mites.
(This might be expanded to the wider MMBasic family but that is a lot of work).

3. a link to Geoff's video on GUI Controls as per page 48 of the MicroMite+ manual and his code on the following pages.
You are welcome to adapt and use my edited code (updated today) that runs on a 480x320 display here without any attribution.

The next two suggestions have been discussed before and have reasons for and against - I just raise them for the 'editorial committee' to consider again:

4. There used to be a two-page summary sheet for MMBasic - is that too hard to do, say, for the Pico family?

5. An index. Yes all the manuals are searchable but an index would be useful.  
This is a lot of work, particularly keeping up with changes.
It may best be tackled by 'others' but in close collaboration with the manual authors.
If it were produced as a 'brother document' it might lag the manual but be able to be subsequently incorporated into a pdf and printed by users.
Printing an index of say 10 pages would make the pdf so much more useful.

Cheers,

Andrew
Edited 2023-10-17 06:45 by Andrew_G
 
NPHighview

Senior Member

Joined: 02/09/2020
Location: United States
Posts: 200
Posted: 09:24pm 16 Oct 2023
Copy link to clipboard 
Print this post

Lizby - The book evidently got pulled by Amazon, perhaps because I listed Peter, Geoff, et. al as authors instead of me. Here's what I see:


Live in the Future. It's Just Starting Now!
 
lizby
Guru

Joined: 17/05/2016
Location: United States
Posts: 3150
Posted: 10:12pm 16 Oct 2023
Copy link to clipboard 
Print this post

  NPHighview said  The book ...


I've never had a printed copy of a MMBasic manual, but I'd spring for one at that price if updated for PicoMite 5.07.08.
PicoMite, Armmite F4, SensorKits, MMBasic Hardware, Games, etc. on fruitoftheshed
 
JanVolk
Senior Member

Joined: 28/01/2023
Location: Netherlands
Posts: 144
Posted: 11:51pm 16 Oct 2023
Copy link to clipboard 
Print this post

  JanVolk said  This is from my own manual:

Module works on 5V! Can also sometimes work on 3V3 with contrast at max. and reduce series resistance for LED. All I/O pins on the PicoMite can be used
and you don't have to set them in advance (the LCD command does that for you automatically).
It is better to use an 8 channel level shifter because the 5V is placed on RS, EN, D4-D7 and the gate breaks above 3V6!

But an I2C to parallel module on the back of the LCD can also remove the 2 x 4k7 on the module and connect it to the 3V3 bus.
And use a sub routine for i2c_lcd. This is somewhere on this forum with some minor adjustments. Works for 16x2 and 20x4 and also custom characters.

Jan
 
JanVolk
Senior Member

Joined: 28/01/2023
Location: Netherlands
Posts: 144
Posted: 11:54pm 16 Oct 2023
Copy link to clipboard 
Print this post

Small adjustment.
 
LouisG
Senior Member

Joined: 19/03/2016
Location: Australia
Posts: 124
Posted: 04:42am 17 Oct 2023
Copy link to clipboard 
Print this post

In the section "Connecting an SSD1963 Based LCD Panel"
the SSD1963 connection table shows:

  LED_A    Backlight control for an unmodified display panel    Configurable

However, the relevant OPTION command is:

  OPTION LCDPANEL controller, orientation

That's it. No additional parameters. No way to tell the Picomite what pin was selected for connecting to LED_A. I looked at other OPTION commands but couldn't find anything.

Need a way to tell Picomite the pin selected for LED_A (if it doesn't already exist).

... Louis
 
Mixtel90

Guru

Joined: 05/10/2019
Location: United Kingdom
Posts: 6786
Posted: 07:34am 17 Oct 2023
Copy link to clipboard 
Print this post

There isn't one. ;)
From the manual:
  Quote  For the ILI9163, ILI9341, ST7735, ST7735S, SSD1331, ST7789, ILI9481, ILI9488, ILI9488W, ST7789_135 and
ST7789_320 displays an optional parameter ‘, backlight’ can be added to the end of the configuration parameters
which specifies a pin to use to control the brightness of the backlight. This will setup a PWM output on that pin
with a frequency of 1KHz and an initial duty cycle of 99%.


BUT see page 51 of the manual, which is specific to backlight control of the SSD1963. I don't really see how these could be combined as the SSD1963 actually works in a different way.
Edited 2023-10-17 17:37 by Mixtel90
Mick

Zilog Inside! nascom.info for Nascom & Gemini
Preliminary MMBasic docs & my PCB designs
 
matherp
Guru

Joined: 11/12/2012
Location: United Kingdom
Posts: 9115
Posted: 07:42am 17 Oct 2023
Copy link to clipboard 
Print this post

  Quote  There isn't one. ;)


There is one but it isn't properly documented. Just append the backlight pin to the end of the command.

e.g.

OPTION LCDPANEL SSD1963_7,l,backlightpinno

Re: the purpose of the thread. I'm looking for errors/typos and functional omissions (e.g MM.INFO(SOUND). Major restructuring, incorporating chunks of Raspberry Pi documentation and probably an index (unless Geoff knows how and wants to tackle it) are out of scope.
 
Andrew_G
Guru

Joined: 18/10/2016
Location: Australia
Posts: 847
Posted: 10:30am 17 Oct 2023
Copy link to clipboard 
Print this post

Peter,
And the other suggestions? are they recorded? Noting that you have a volunteer to do the index.

Andrew
Edited 2023-10-17 20:30 by Andrew_G
 
cosmic frog
Senior Member

Joined: 09/02/2012
Location: United Kingdom
Posts: 284
Posted: 11:23am 17 Oct 2023
Copy link to clipboard 
Print this post

Page 84 of the Pico VGA manual -
PLAY FLAC - "The extension of .WAV will be appended if..."

Should this be "The extension of .FLAC will be appended if..."

Dave.
 
cosmic frog
Senior Member

Joined: 09/02/2012
Location: United Kingdom
Posts: 284
Posted: 11:29am 17 Oct 2023
Copy link to clipboard 
Print this post

Page 110 of the Pico VGA manual -
PIXEL(x,y[,page_number])

Tells us what x and y is for but nothing about the optional [page_number].

Dave.
 
     Page 1 of 5    
Print this page
© JAQ Software 2024