Page 1 of 1

Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 3:34 pm
by dv8
Here is a completely remastered PDF of The Advanced User Guide For The BBC Micro.

A huge amount of effort has been put in to fix the errors in the original book.
This PDF should be the most accurate version of the AUG available.
  • The look and layout of the original guide has been preserved.
  • A large number of error corrections have been applied to the text.
  • All diagrams have been redrawn in vectors.
  • There is extensive hyperlinking - click on any reference to a page, chapter or section number or on any OSBYTE/OSWORD reference to jump directly to the relevant page.
There is also a disc image containing all the listings from the guide. Boot the disc or enter the command *TYPE !INDEX to see a list of programs and which section of the guide they correspond to.

Advanced_User_Guide.pdf
Fourth revision (November 2019)
(1.34 MiB) Downloaded 125 times
Advanced_User_Guide.ssd
updated on 16 March 2020
(20.25 KiB) Downloaded 23 times

Other remastered user guides in this series:

New Advanced User Guide
BBC Micro User Guide (Model B and B+ editions)

Re: Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 3:58 pm
by lurkio
Wow!

:shock: =D> =D> =D>

Re: Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 4:09 pm
by leenew
:shock: Amazing 8)

Lee.

Re: Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 7:02 pm
by MartinB
What I said in the Remastered NAUG thread... =D>

Re: Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 7:06 pm
by tricky
Beautiful =D>

Re: Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 7:22 pm
by 0xC0DE
Fantastic, thank you so much! :D

Re: Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 8:49 pm
by Elminster
Yikes. Downloaded...... Last one. What tome of law is next?

Re: Advanced User Guide (Remastered)

Posted: Mon Jun 03, 2019 11:35 pm
by dv8
Elminster wrote:
Mon Jun 03, 2019 8:49 pm
What tome of law is next?
Well, the Master Welcome Guide and Reference Manuals are on the 'to-do' list but I need a break before starting another big project like that :)

Re: Advanced User Guide (Remastered)

Posted: Wed Jun 05, 2019 12:56 am
by tom_seddon
Nice work! Great to see the key numbers fixed, and for OSFILE to finally have the right address :) - I suspect this PDF will have a permanent home in my Acrobat recent files list...

I have found one new issue - on page 257, 10.2 section c should real "Locations &FD and &FE".

--Tom

P.S. A remastered version of the Master Reference Manual (volume 1 in particular) would be amazing!

Re: Advanced User Guide (Remastered)

Posted: Wed Jun 05, 2019 6:44 am
by Rich Talbot-Watkins
tom_seddon wrote:
Wed Jun 05, 2019 12:56 am
Nice work! Great to see the key numbers fixed
Yeah, I have enduring memories of 9 and I being the wrong way round in the AUG. (Were there other problems?)

Thanks a lot for doing this, it'll be my new indispensable Beeb reference!

Re: Advanced User Guide (Remastered)

Posted: Wed Jun 05, 2019 9:58 am
by dv8
tom_seddon wrote:
Wed Jun 05, 2019 12:56 am
I have found one new issue - on page 257, 10.2 section c should real "Locations &FD and &FE".
Thanks for this. I've corrected the PDF but I'll leave it a week or so before re-uploading to see if any other errors are discovered.
Rich Talbot-Watkins wrote:
Wed Jun 05, 2019 6:44 am
Yeah, I have enduring memories of 9 and I being the wrong way round in the AUG. (Were there other problems?)
I don't think there were any other mistakes in that table on p142.

There were quite a few problems with the larger keycode table in the NAUG (section 14.1), mostly internal key numbers and INKEY numbers not corresponding or decimal/hex numbers not matching. Can't remember if these errors were also present in the equivalent AUG table (appendix C).

Re: Advanced User Guide (Remastered)

Posted: Wed Jun 05, 2019 2:10 pm
by rmbrowngr
Great stuff. Any thoughts on the Electron User Guide? :-k The only copies I have are of a poor scan in pdf and a tatty copy bought from eBay.
Acorn_ElectronUG.zip
(4.73 MiB) Downloaded 26 times

Re: Advanced User Guide (Remastered)

Posted: Wed Jun 05, 2019 2:32 pm
by vanekp
Electron User guide https://www.retro-kit.co.uk/user/custom ... tronUG.pdf
you can download Electron advanced uses guide here http://stardot.org.uk/mirrors/www.bbcdo ... Issue2.pdf

Re: Advanced User Guide (Remastered)

Posted: Tue Jun 11, 2019 11:29 am
by dv8
Updated the PDF to fix a few issues. Download links in the opening post

Changes since revision 1 (June 2019)
  • p54 (56) BRK instruction, B flag : added text (set in P pushed on stack)
  • p152 (154) OSBYTE &81 Read machine type : (INKEY &FF00) changed to (INKEY -256)
  • p153 (155) OSBYTE &81 Read key : added link to 'Read machine type' entry on p152
  • p257 (259) 10.2 BRK vector (c) : 'Locations &ED and &FE' should be &FD and &FE
  • p272 (274) 11.3 Page two : &297-&27B should be &297-&29B
  • p349 (351) 16.11 ROM Filing System, 3rd para from bottom : (&43 '#') should be (&23 '#')
  • p366 (368) 18.8.1 The cursor start register (R10) : '1/16th and 1/32nd of field rate' should be '16 and 32 times field rate', added text 'When bit 6=0 and bit 5=1, the cursor is disabled.'

Re: Advanced User Guide (Remastered)

Posted: Mon Jul 01, 2019 9:20 am
by dv8
Another update with more corrections. The new PDF is in the opening post

Changes since revision 2 (June 2019):
  • p127 (129) OSBYTE &0B / *FX 11 : default setting n=32 should be n=50
  • p215 (217) OSBYTE &D4 / *FX 212 : default value 144 (&90) addded text 'amplitude -13'
  • p216 (218) OSBYTE &D5 / *FX 213 : default value 101 (&65) should be 100 (&64)
  • p217 (219) OSBYTE &D6 / *FX 214 : default value 7 should be 6
  • p226 (228) OSBYTE &E4 / *FX 228 : default value for fn+SHIFT+CTRL, &A0 should be 0 - key has no effect
  • p246 (248) OSBYTE &FF / *FX 255 : added link to Appendix J, added description for bit 7, added timing table for 1770/1772 FDC
  • p366 (368) 18.6.3 Cursor blanking delay : 'Cursor enable signal' should be 'Cursor blanking signal'
  • p483 (485) Appx.I - link options : added * to default setting for each option
  • p484 (486) Appx.I - link options, S14 : descriptions wrong way round, should be OPEN=disable JIM, CLOSED=enable JIM; in the note 'link 16 must be CLOSED' should be 'link 15 must be CLOSED and R72 fitted'
  • p485 (487) Appx.I - link options, S15 note : 'link 15 must be CLOSED when link 17 is OPEN' should be 'link 15 must be CLOSED and R72 fitted when link 14 is OPEN'
  • p485 (487) Appx.I - link options, S16 note : 'link 16 must be CLOSED if link 14 is OPEN' should be 'link 16 must be CLOSED and R73 fitted when link 17 is OPEN'
  • p485 (487) Appx.I - link options, S17 note : 'link 15 must be CLOSED' should be 'link 16 must be CLOSED and R73 fitted'
  • p489 (491) Appx.J - keyboard links : added switch orientation diagram for type 2 keyboards

Re: Advanced User Guide (Remastered)

Posted: Mon Jul 01, 2019 9:23 am
by dv8
rmbrowngr wrote:
Wed Jun 05, 2019 2:10 pm
Any thoughts on the Electron User Guide?
Coming soon... :)

Re: Advanced User Guide (Remastered)

Posted: Mon Jul 01, 2019 9:25 pm
by soviet
Awesome work, it's gonna be very useful to my have a lot lo learn.
=D>

Re: Advanced User Guide (Remastered)

Posted: Mon Jul 22, 2019 8:40 pm
by AndyF
I concur, excellent work. :) :) :)

Thank you!

Re: Advanced User Guide (Remastered)

Posted: Fri Nov 22, 2019 8:32 pm
by dv8
The PDF has been updated with some more corrections. Download link is in the opening post

Changes since revision 3 (July 2019):
  • p77 (79) LSR absolute,X : always takes 7 cycles on 6502A
  • p113 (115) OSBYTE 190 &BE : should be Read/write ADC conversion type
  • p121 (123) OSBYTE &05 (5) *FX5,2 : added hyperlink to 'OSBYTE A=3'
  • p123 (125) OSBYTE &07 (7) : added X=0 9600 baud
  • p124 (126) OSBYTE &08 (8) : added X=0 9600 baud
  • p125 (127) OSBYTE &09 (9) : duration is in vsync units not centiseconds
  • p126 (128) OSBYTE &0A (10) : duration is in vsync units not centiseconds
  • p136 (138) OSBYTE &14 (20) 3rd para from bottom : 128 (&7F) should be 127 (&7F)
  • p149 (151) OSBYTE &7E (126) : added text 'the VDU paging counter will be reset, the VDU queue will be reset, any soft key expansion will be cancelled and any sound will be terminated'
  • p153 (155) OSBYTE &81 (129) : moved Y=&FF,X=0 paragraph to bottom
  • p163 (165) OSBYTE &8B (139) entry parameters : improved formatting
  • p179 (181) OSBYTE &A0 (160) entry parameters: X contains the number of the VDU variable ; on exit: X/Y = low/high byte of variable value ; after call: removed X and Y, only C is undefined
  • p198 (200) OSBYTE &BE (190) : should be Read/write ADC conversion type
  • p228 (230) OSBYTE &E6 (230) action list : removed 'Escape cleared' ; added 'Reset VDU queue, Any current soft key expansion is cleared, Any sound being produced is terminated'
  • p249 (251) 9.5 OSWORD &3 : changed 'chapter 12' hyperlink to sec 12.10 on p291 (293)
  • p252 (254) 9.14 OSWORD &C : added hyperlink to OSWORD &B
  • p278 (280) 11.4 &364 and &365 : 'input cursor' should be 'output cursor'
  • p490 (492) Fig J.2 Keyboard Circuit Diagram : corrected keyboard rows, corrected 'I' and '9' positions

Re: Advanced User Guide (Remastered)

Posted: Sun Mar 15, 2020 3:26 pm
by chrisn
I just found a couple of errors:

Page 400, paragraph 3: "reading" should have a capital R
Page 308, line 270: LDX &16 should be LDX #16 (to read the lightpen register)

Brilliant work, btw .. this and all the other remastered books you've done!

Re: Advanced User Guide (Remastered)

Posted: Sun Mar 15, 2020 9:32 pm
by RetroBob
Wow, this is incredible work, bravo.

Re: Advanced User Guide (Remastered)

Posted: Mon Mar 16, 2020 8:16 pm
by dv8
chrisn wrote:
Sun Mar 15, 2020 3:26 pm
I just found a couple of errors:
Page 400, paragraph 3: "reading" should have a capital R
Page 308, line 270: LDX &16 should be LDX #16 (to read the lightpen register)
Thanks for the corrections.

I've gone through all the listings again and fixed this along with several other problems. An updated SSD image has been added to the top post.

On page 400 the lower case 'reading' is correct but the full-stop after 'high' should be a comma.

I'll get all these errors fixed in the next release of the PDF.

Thanks again.