Advanced User Guide (Remastered)

avoid work duplication! collaborate on the archival of acorn literature!
Post Reply
User avatar
dv8
Posts: 297
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Advanced User Guide (Remastered)

Post by dv8 » Mon Jun 03, 2019 3: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 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 134 times
Advanced_User_Guide.ssd
updated on 16 March 2020
(20.25 KiB) Downloaded 26 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 Mon Mar 16, 2020 7:57 pm, edited 7 times in total.


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

Re: Advanced User Guide (Remastered)

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

:shock: Amazing 8)

Lee.

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

Re: Advanced User Guide (Remastered)

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

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


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

Re: Advanced User Guide (Remastered)

Post by 0xC0DE » Mon Jun 03, 2019 7: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: 4076
Joined: Wed Jun 20, 2012 9:09 am
Location: Essex, UK
Contact:

Re: Advanced User Guide (Remastered)

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

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

User avatar
dv8
Posts: 297
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: Advanced User Guide (Remastered)

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

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

tom_seddon
Posts: 373
Joined: Tue Aug 30, 2005 12:42 am
Contact:

Re: Advanced User Guide (Remastered)

Post by tom_seddon » Wed Jun 05, 2019 12:56 am

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 Wed Jun 05, 2019 12:59 am, edited 1 time in total.

User avatar
Rich Talbot-Watkins
Posts: 1593
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 6:44 am

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!

User avatar
dv8
Posts: 297
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: Advanced User Guide (Remastered)

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

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

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

Re: Advanced User Guide (Remastered)

Post by rmbrowngr » Wed Jun 05, 2019 2: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 27 times
Richard B
Acorn Electrons issue 4 and 6, MRB, Plus 1, AP6, AP5, Pegasus 400, BeebSCSI, Gotek, Raspberry Pi, GoSDC MBE.
BBC B+ 64K (128K upgraded) with Duel OS, Raspberry Pi and Gotek.

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

Re: Advanced User Guide (Remastered)

Post by vanekp » Wed Jun 05, 2019 2: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: 297
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Tue Jun 11, 2019 11: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: 297
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Jul 01, 2019 9: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: 297
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: Advanced User Guide (Remastered)

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

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

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

Re: Advanced User Guide (Remastered)

Post by soviet » Mon Jul 01, 2019 9: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 8: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: 297
Joined: Mon Jun 22, 2009 10: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

chrisn
Posts: 573
Joined: Sat Apr 19, 2014 12:31 pm
Location: UK
Contact:

Re: Advanced User Guide (Remastered)

Post by chrisn » 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)

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

User avatar
RetroBob
Posts: 49
Joined: Mon Jun 26, 2017 1:00 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by RetroBob » Sun Mar 15, 2020 9:32 pm

Wow, this is incredible work, bravo.

User avatar
dv8
Posts: 297
Joined: Mon Jun 22, 2009 10:07 pm
Contact:

Re: Advanced User Guide (Remastered)

Post by dv8 » Mon Mar 16, 2020 8:16 pm

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.

Post Reply

Return to “scanning of books, magazines, ads and letters”