Advanced User Guide (Remastered)

These forums are for community collaboration on archiving, magazine scanning etc. to avoid work duplication and agree conventions / define standards
Post Reply
User avatar
dv8
Posts: 254
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Advanced User Guide (Remastered)

Post by dv8 » Mon Jun 03, 2019 2:34 pm

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. Enter the command *TYPE !INDEX to see a list of programs on the disc and which section of the guide they correspond to.

Advanced_User_Guide.pdf
Fourth revision (November 2019)
(1.34 MiB) Downloaded 23 times
Advanced_User_Guide.ssd
(19.75 KiB) Downloaded 89 times

Other remastered user guides in this series:

New Advanced User Guide
BBC Micro User Guide (Model B and B+ editions)
Last edited by dv8 on Fri Nov 22, 2019 8:16 pm, edited 6 times in total.


User avatar
leenew
Posts: 3988
Joined: Wed Jul 04, 2012 3:27 pm
Location: Doncaster, Yorkshire
Contact:

Re: Advanced User Guide (Remastered)

Post by leenew » Mon Jun 03, 2019 3:09 pm

:shock: Amazing 8)

Lee.

User avatar
MartinB
Posts: 5250
Joined: Mon Mar 31, 2008 9:04 pm
Location: Obscurity
Contact:

Re: Advanced User Guide (Remastered)

Post by MartinB » Mon Jun 03, 2019 6:02 pm

What I said in the Remastered NAUG thread... =D>


User avatar
0xC0DE
Posts: 372
Joined: Tue Mar 19, 2019 7:52 pm
Location: The Netherlands
Contact:

Re: Advanced User Guide (Remastered)

Post by 0xC0DE » Mon Jun 03, 2019 6:22 pm

Fantastic, thank you so much! :D
0xC0DE
:idea: Follow me on Twitter :idea: Visit my YouTube channel featuring my demos for Acorn Electron and BBC Micro

User avatar
Elminster
Posts: 3978
Joined: Wed Jun 20, 2012 8:09 am
Location: Essex, UK
Contact:

Re: Advanced User Guide (Remastered)

Post by Elminster » Mon Jun 03, 2019 7:49 pm

Yikes. Downloaded...... Last one. What tome of law is next?

User avatar
dv8
Posts: 254
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Jun 03, 2019 10:35 pm

Elminster wrote:
Mon Jun 03, 2019 7: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 :)

tom_seddon
Posts: 346
Joined: Mon Aug 29, 2005 11:42 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by tom_seddon » Tue Jun 04, 2019 11:56 pm

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!
Last edited by tom_seddon on Tue Jun 04, 2019 11:59 pm, edited 1 time in total.

User avatar
Rich Talbot-Watkins
Posts: 1556
Joined: Thu Jan 13, 2005 5:20 pm
Location: Palma, Mallorca
Contact:

Re: Advanced User Guide (Remastered)

Post by Rich Talbot-Watkins » Wed Jun 05, 2019 5:44 am

tom_seddon wrote:
Tue Jun 04, 2019 11:56 pm
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!

User avatar
dv8
Posts: 254
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Wed Jun 05, 2019 8:58 am

tom_seddon wrote:
Tue Jun 04, 2019 11:56 pm
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 5: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).

User avatar
rmbrowngr
Posts: 328
Joined: Sat Jan 13, 2018 12:46 pm
Location: Dionysos, Greece
Contact:

Re: Advanced User Guide (Remastered)

Post by rmbrowngr » Wed Jun 05, 2019 1:10 pm

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 13 times
Richard B
Acorn Electrons issue 4 and issue 6 with Master RAM Board, Acorn Plus 1, AP6, AP5, Pegasus 400, BeebSCSI, Gotek, Raspberry Pi 2nd Processor, GoSDC MBE with Elk2GoSDC and Cart2GoSDC.
BBC B+ 64K (128K upgraded) with Duel OS

User avatar
vanekp
Posts: 666
Joined: Thu Nov 30, 2000 7:09 am
Location: The Netherlands
Contact:

Re: Advanced User Guide (Remastered)

Post by vanekp » Wed Jun 05, 2019 1:32 pm

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

User avatar
dv8
Posts: 254
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Tue Jun 11, 2019 10:29 am

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

User avatar
dv8
Posts: 254
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Jul 01, 2019 8:20 am

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

User avatar
dv8
Posts: 254
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Jul 01, 2019 8:23 am

rmbrowngr wrote:
Wed Jun 05, 2019 1:10 pm
Any thoughts on the Electron User Guide?
Coming soon... :)

soviet
Posts: 93
Joined: Tue Dec 04, 2018 10:05 pm
Location: Montevideo, Uruguay
Contact:

Re: Advanced User Guide (Remastered)

Post by soviet » Mon Jul 01, 2019 8:25 pm

Awesome work, it's gonna be very useful to my have a lot lo learn.
=D>

User avatar
AndyF
Posts: 1276
Joined: Sat Feb 23, 2008 10:16 pm
Location: Derby
Contact:

Re: Advanced User Guide (Remastered)

Post by AndyF » Mon Jul 22, 2019 7:40 pm

I concur, excellent work. :) :) :)

Thank you!
Andy

* NEW * The Jetset Willy and Manic Miner community :)

Adventure games ported across to the BBC (in progress) as soon as I can find some time!

User avatar
dv8
Posts: 254
Joined: Mon Jun 22, 2009 9:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Fri Nov 22, 2019 8:32 pm

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

Post Reply