home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 4 / AUCD4.iso / acorn / documents / appnotes / 031-045 / 031c.arc / Text
Encoding:
Text File  |  1989-11-28  |  18.9 KB  |  355 lines
  1.  
  2.                           Acorn Computers Ltd.
  3.                     British Broadcasting Corporation
  4.                        Master Series Microcomputer
  5.  
  6.        Functional differences between Master 128 and Models B & B+
  7.  
  8. Operating system version:
  9. New Series 3 OS for the Master 128/512/Sc/Turbo
  10. New Series 4 OS for the Master Econet Terminal.
  11.  
  12. Operating System changes:
  13.  As version 1.2 with following extensions:
  14.          * Shadow Screen - Use of MODE 128 to 135 instead of MODE 0 to 7
  15.            results in the use of a section of memory for the screen separate 
  16.            from the main area of RAM. This allows more room for user Progs. 
  17.          * Real-time clock - the status of a Real-time clock can be called 
  18.            from the MOS. The OSWORD calls &E and &F Read & Write the clock 
  19.            in BCD or text formats.
  20.          * Default command line interpreter if no language present or *GO
  21.            used.
  22.          * Configure CMOS RAM commands - the state of the CMOS RAM can be
  23.            set for both reserved and unreserved Bits. Reserved Bits include: 
  24.                  * Start-up mode                         MODE <0-7,128-135> 
  25.                  * File-Server station number            FS <0-255[.0-255]> 
  26.                  * Printer-Server station number         PS <0-255[.0-255]> 
  27.                  * Econet station ID                     Transient Command 
  28.                  (Must be set by Net Manager)
  29.                  * Start-up language ROM number          LANG <ROM>
  30.                  * Start-up filing system ROM number     FILE <ROM>
  31.                  * *TV position & Interlace state        TV [<Dec>[,<Dec>] 
  32.                  * Auto-repeat delay                     DELAY <0-255>
  33.                  * Auto-repeat rate                      REPEAT <0-255>
  34.                  * Default printer (*FX5 type)           PRINT <0-255>
  35.                  * Print ignore char.(no param=no ignore)IGNORE <0-255>
  36.                  * Tube selected (Internal/External)     EXTUBE/INTUBE
  37.                    (Looks for int Tube if no ext fitted)
  38.                  * Tube ON/OFF                           TUBE/NOTUBE
  39.                    (TUBE defaults to I/O Proc if no Co-proc fitted)
  40.                  * Serial baud rate (Both ways)          BAUD <1-8>
  41.                  * Serial data format                    DATA <0-7>
  42.                  * Boot status                           BOOT/NOBOOT
  43.                    (Reverses BRK and SHIFT + BRK action)
  44.                  * Scroll state (on/off)                 SCROLL/NOSCROLL
  45.                  * Floppy-Drive params (speed etc)       FDRIVE <0-3>
  46.                    (Use low number for highest step rate. 0 has MFM pre-
  47.                     compensation. 1 is same speed but no compensation)                                                                                 
  48.                  * Floppy or Winchester start-up         FLOPPY/HARD
  49.                    (Floppy is selected if no Winchester fitted with HARD)
  50.                  * ADFS or FADFS as default              DIR/NODIR
  51.                    (FADFS does not Mount disk automatically)
  52.                  * Bell character volume                 LOUD/QUIET
  53.                  * Caps lock on/off                      CAPS/NOCAPS/SHCAPS 
  54.                  FS & PS status bits only operational when ANFS fitted.
  55.  
  56.            Configuration is set using *CONFIGURE <param> or read using
  57.            *STATUS <param> or just *STATUS to read all.
  58.          * Soft characters fully exploded
  59.          * Improved soft-key structure with more buffer area.
  60.  
  61.          * New resident Operating System commands:
  62.                  *APPEND - functions as BUILD but appends to end of file.
  63.                  *BUILD - as DFS but control codes input by | mechanism.
  64.                  *CLOSE - closes open files on current filing system.
  65.                  *CONFIGURE - To set-up start-up option(s).
  66.                  *CREATE - creates empty file using *SAVE params.
  67.                  *DELETE - as DFS delete.
  68.                  *DUMP - <start in file> <start address on output>.
  69.                  *EX - Examine file in specified directory.
  70.                  *EXEC - Take input from file rather than keyboard.
  71.                  *GO - to enter address in language/IO processor.
  72.                  *GOIO - to enter program at address in IO processor.
  73.                  *IGNORE - as *FX6.
  74.                  *INFO - as *EX, but for single files or Wildcard use.
  75.                  *INSERT - inserts ROM number n into ROM map from reset.
  76.                  *LIST - List file in GSREAD format (*TYPE with line nos.) 
  77.                  *LIBFS - Define FS where LIB is from current FS.
  78.                  *MOVE - copies files from one name to another incl
  79.                           between filing systems.
  80.                  *PRINT - as TYPE but gets/processes vdu codes.
  81.                  *REMOVE - as DELETE but no error msg if not found.
  82.                  *ROMS - lists ROM names, skts, vers & UNPLUG/PLUG.
  83.                  *SHADOW - with 0 or no param, gives shadow on next mode.
  84.                             With 1, drops shadow on next mode.
  85.                  *SHOW - Displays soft-key contents.
  86.                  *SHUT - Close open files on all filing systems.
  87.                  *SRDATA - Reserve Sideways RAM for data use.
  88.                  *SREAD - Copy Sideways RAM to main RAM.
  89.                  *SRROM - Reserve Sideways RAM for direct addressing.
  90.                  *SRWRITE - Copy main RAM to Sideways RAM.
  91.                  *SPOOL - Direct screen output to named file.
  92.                  *SPOOLON - functions as SPOOL but appends to end of file. 
  93.                  *STATUS - Lists status of start-up option(s).
  94.                  *TIME - Displays time from Real-time clock.
  95.                  *TYPE - List file with control codes displayed as |D etc. 
  96.                  *UNPLUG - removes ROM number n from ROM map from reset.
  97.          * Numeric keypad - options to set base for range of values returned 
  98.            and set whether SHIFT/CTRL etc affect codes.
  99.          * Cassette filing system upgraded to do OSGBPB (calls 1 & 3) in
  100.            those cases where it is to write to or read from the current
  101.            pointer.
  102.            OSFSC extended for CFS to provide call 7 so that it returns
  103.            legal file handle range.
  104.            CFS will perform * EX ( but not * INFO ).
  105.            CFS can be reselected by *FX143,18,<n> where n=1 (1200 baud),
  106.            n=2 (300 baud, n=3 (ROM filing system),
  107.          * Multifiling system capability. Name of filing system can be pre- 
  108.            fixed to the file name itself. Files may be opened and kept open 
  109.            across several filing systems.
  110.            Filing names currently defined include:
  111.                  CFS (or TAPE), ROM, DFS, ADFS, NET
  112.          * Extended graphics facilities:
  113.                  * Extended Fill commands using checkerboard pattern/stipple. 
  114.                  * Mark-to-space ratio of dotted line.
  115.                  * New triangle algorithm for correct plotting under all
  116.                    conditions.
  117.                  * Parallelogram - Solid fill.
  118.                  * Rectangle - Solid fill.
  119.                  * Circle - Outline.
  120.                  * Circle - Solid fill.
  121.                  * Arc - Line fill.
  122.                  * Arc - Solid fill (Pie shape).
  123.                  * Arc - Solid fill (Chord segment).
  124.                  * Ellipse - Outline.
  125.                  * Ellipse - Solid fill.
  126.                  * Fill enclosing shape outline (flood-fill).
  127.                  * Enhanced speed of all fill operations.
  128.                  * Move/copy rectangle.
  129.                  * Extended horizontal line fill.
  130.          * Extension text:
  131.                  * Improved character draw speed ( especially VDU5 ).
  132.                  * Clear block of text window.
  133.                * Output character with no cursor move (dead key).
  134.                  * Advance left/right after drawing character.
  135.                  * Pending scroll to allow bottom right character to be
  136.                    drawn.
  137.                  * Cursor options held across mode changes.
  138.                  * Direct window scroll - left/right/up/down.
  139.          * Extra 128 standard characters in ASCII range 128 to 255.
  140.  
  141. Detailed changes:
  142. Miscellaneous:
  143.  
  144. 1) Sideways ROM headers which have been "illegal" previously on Models B & 
  145. B+, but accepted by the MOS, may not be accepted by this MOS version.
  146. 2)  The  screen  Paged  Mode algorithm  has  been  improved  in  this MOS, 
  147. resulting in slight differences in the number of displayed lines  in  some 
  148. modes compared with Model B & B+.
  149. 3) In the Econet Terminal, the  User  VIA  chip  (6522)  is  not  normally 
  150. fitted.  Application  software  intended for Econet use should not use the 
  151. VIA timer.
  152. 4) The RAM latch  at  &FE34  has  some changes and additions to the use of 
  153. each bit. Refer to the Advanced Reference Guide for more information.
  154. 5) The machine start-up mode & language are now easily reconfigured. Soft- 
  155. ware  should  always  have  an  auto-boot file which sets the language and 
  156. screen mode, without  assuming a default state. (The machine may NOT be in 
  157. Mode 7 or in BASIC at disk Boot-up).
  158. 6) Software should not use "*abbreviation" due to the risk of clashes with 
  159. other fitted ROMs with similar *commands.  In  particular,  *D.  no longer 
  160. selects the DFS! (It selects *DUMP).
  161. 7) Software should NEVER assume the position of PAGE. If  it needs to know 
  162. it should ask the operating system where OSHWM is.
  163. 8)  To  provide  conversion  compatibility  across  DFS  &  ADFS, note the 
  164. following:
  165.          *DRIVE  - ADFS does not support this. Use *DIR  :X.Y,  which  is  a 
  166.                    format common to both filing systems.
  167.          *DIR    - ADFS  does not support moves directly from one directory 
  168.                    to another, arbitrarily across  the  structure.  Use  the 
  169.                    full pathname where relevant in DFS to support ADFS.
  170. 9)  Programs  should never define soft characters by directly loading into 
  171. the soft-key definition area (&C00-&CFF).
  172. 10) The Econet Terminal is NOT upgradeable to other Master variants.
  173.  
  174. Memory map changes
  175. The Shadow screen in the Model B+ from &3000 - &7FFF (Sideways) is present 
  176. in the Master 128 machine.  The 12K of additional Paged RAM in Model B+ is 
  177. implemented  differently in the Master 128 machine  and  is  reserved  for 
  178. Operating and Filing system use as "Private RAM" (see below).
  179.  
  180. The minimum machine  configuration  is  128K,  where  64K  is allocated to 
  181. Sideways RAM (4 by 16K pages) in a similar  way  to the 128K Model B+. Use 
  182. of  internally  fitted  ROM's  in  two  of  the three sockets will require 
  183. changes to the link settings  which  will  remove  access  to  some of the 
  184. Sideways RAM. (They are ROM locations 4,5,6 & 7).
  185.  
  186.  
  187.  
  188. Memory map below OSHWM, with changes from Model B/B+ indicated:
  189. Page zero - &00-&FF
  190.  &00-&8F Language workspace. BASIC allows &70-&8F for the user.
  191.  &90-&9F ECONET workspace. Do not use.
  192.  &A0-&A7 NMI workspace. It must be claimed before use, the owner must:
  193.  
  194.   a) Have a Filing System number  allocated  to it. Note the error in
  195.  the Advanced User Guide (Bray, Dickens &  Holmes) on P. 323. The
  196.  NMI  ID  passed around by Service Calls &B  and  &C  are  Filing
  197.  System numbers not ROM numbers.
  198.   b) Be able to process ROM Service Calls &B and &C i.e. they must be
  199.  ROM's or intercept OSBYTE &8F.
  200.  
  201.  &A8-&AF MOS scratch space. Also user scratch between MOS calls.
  202.  &B0-&BF Filing System scratch space. Watch out for "hidden" filing system 
  203.            calls i.e. those produced by OSWRCH if *SPOOL used.
  204.  &C0-&CF Current Filing System PRIVATE workspace.
  205.  &D0-&FF MOS workspace  only  (see  Advanced Reference Guide, published by 
  206.            Acorn, for accurate decription of the VDU Driver use).
  207. Page one - &100-&1FF
  208.  Machine stack and error message buffer.
  209. Page two - &200-&2FF
  210.  &200-&235 Vectors.
  211.  &236-&28F Main MOS variables.
  212.  &290-&2FF MOS workspace (for MOS only).
  213. Page three - &300-&3FF
  214.  &300-&37F VDU variables (for use by graphics routines only).
  215.          In the Model B, B+  and  this  machine,  Page three is used for VDU 
  216.  workspace. Most variables are the same, with the following exceptions:
  217.                  Model B & B+                            This machine
  218.  &359 - Foreground graphics colour       Plotting foreground/background
  219.  &35A - Background graphics colour       Current graphics plot mode
  220.  &366 - Mode 7 cursor                    Cursor control flags (VDU 23,16)
  221.  &367 - Exploded font flag               Dotted line pattern (VDU23,6)
  222.  &368 - Exploded font location bytes     Current dotted line state
  223.  &369 -     "     "      "       "       Plot colour (0-solid,Not 0-pattern) 
  224.  &36A -     "     "      "       "       F/grnd col. (0-solid,Not 0-pattern) 
  225.  &36B -     "     "      "       "       B/grnd col. (0-solid,Not 0-pattern) 
  226.  &36C -     "     "      "       "       Col. 81 flag (top bit set pending) 
  227.  &36D -     "     "       "       "      Foreground graphics colour
  228.  &36E -     "     "      "       "       Background graphics colour
  229.  &380-&3DF Cassette Filing System workspace (do not use).
  230.  &3E0-&3FF Keyboard input buffer (do not use unless replacing).
  231. Page four, five, six and seven - &400-7FF
  232.  Language workspace. Do not use unless you are the current language or the 
  233. current language has allowed you to use it.
  234. Page eight - &800-&8FF
  235.  &800-&87F Sound workspace. DO NOT USE (unless you want strange noises!).
  236.  &880-&8BF Printer buffer. Useable if, and only if, no printing needed.
  237.  &8C0-&8FF Sound  workspace (envelopes 1-4).  Useable  if,  and  only  if, 
  238.            envelopes not needed.
  239. Page nine - &900-&9FF
  240.  &900-&9BF RS 423 O/P buffer, or Cassette O/P buffer (1st part), or Sound
  241.            workspace (envelopes 5 - 16). Do not use for anything else, as
  242.            this area could be re-allocated.
  243.  &9C0-&9FF Speech buffer, or Cassette  O/P  buffer  (2nd part). Do not use 
  244.              for anything else, as this area could be re-allocated.
  245. Page ten -  &A00-&AFF
  246.  RS 423 I/P buffer, or  Cassette I/P buffer. Do not use for anything else, 
  247.  as this area could be re-allocated.
  248. Page eleven - &B00-&BFF 
  249.  ECONET workspace. Do not use.
  250.       In the Model B &  B+  this  is used for the soft key buffer. In this 
  251. machine, the soft key buffer resides in the Private 12K RAM and should not 
  252. be accessed by the user. Programs directly accessing  Page  eleven  on the 
  253. Model B & B+ for soft-key purposes will be incompatible with this machine
  254.          Note: Initial Page states are:
  255.                  Model B, B+:    &B00-&BFF - &10
  256.                  This machine:   &B00-&BFF - &00
  257. Page twelve - &C00-&CFF
  258.  ECONET workspace. Do not use.
  259.          In the Model B & B+ this is used for user defined characters in the 
  260. range ASCII 224-255. In this  machine,  all characters up to ASCII 255 are 
  261. defined with a standard font. This definition  resides  in the Private RAM 
  262. area  and  should  not be accessed by the user  (the  user  can,  however, 
  263. re-define all of them  as  before with VDU23). Programs directly accessing 
  264. Page twelve on the Model B  &  B+  for  user  defined  characters  will be 
  265. incompatible with this machine.
  266.          Note: Initial Page states are:
  267.                  Model B, B+:    &C00 - &0D      &C01-&CFF - &00
  268.                  This machine:   &C00-&CFF - &00
  269. Page thirteen - &D00-&DFF
  270.  &D00-&D5F NMI routine and workspace. NMI's must  be  claimed  to use this 
  271.              area.
  272.  &D60-&D7F ECONET private workspace. Do not use.
  273.  &D80-&D91 Currently unallocated.
  274.  &D92-&D9E Reserved for Trackerball use.
  275.  &D9F-&DEF Expanded vector set.
  276.  &DF0-&DFF Paged ROM workspace, 1 byte per ROM.
  277.  
  278. 12K Private RAM:
  279.  &8000-&83FF Soft-key buffer. Do not use directly.
  280.  &8400-&87FF VDU  workspace. Reserved for routines that need a large area
  281.                such as Flood-fill. Do not use directly.
  282.  &8800-&88FF VDU variables and workspace. Do not use directly.
  283.  &8900-&8FFF Character definitions. Do not use directly.
  284.  &C000-&DBFF Paged ROM workspace, claimed via a Service Call.
  285.  &DC00-&DCFF MOS CLI buffer. Corrupted by '*' commands.
  286.  &DD00-&DEFF Transient utility workspace e.g. *MOVE.
  287.  &DF00-&DFFF MOS private workspace.
  288.  
  289. PCB Link settings:
  290. IMPORTANT!
  291. These  links  will  not  normally  need adjustment. If they should require 
  292. changing, the Mains Supply MUST be disconnected before removing the top of 
  293. the computer case using the 4  screws  on  the  underside marked FIX. Take 
  294. note of any warning labels within the case.
  295.  
  296. Link  1 - Audio to 1 Mhz. bus. Normally set for input. Can be changed to
  297.             audio output by cutting track link A and linking B.
  298. Link  2 - Cartridge -5V decoupler. Fit R9 and break track link to enable
  299.             capacitive decoupling within cartridge.
  300. Link  3 - Not present.
  301. Link  4 - Allocated  for  advanced  software use. Enables real-time clock
  302.             Alarm facility to be used. Not normally fitted.
  303. Link  5 - Sync polarity. Cut track link and join other side to invert
  304.             from negative to positive sync.
  305. Link 60/61 - Normally AB only linked. Link CD in addition for 8 Mhz output 
  306.             to Cartridges.
  307.             WARNING!  The  lack  of a clock supply to the computer can cause 
  308.             damage to the computer's dynamic RAM. Link AB should not be
  309.             removed as it would result in the loss of a clock supply.
  310. Link  7 - Video polarity. Cut track link and join other side to invert the 
  311.             video output.
  312. Link  8 - Not present.
  313. Link  9 - Not present.
  314. Link 10 - Channel  select.  Selects  one  of  two VHF channels when VHF
  315.             modulator fitted.
  316. Link 11 - Not present.
  317. Link 12 - Composite Sync output to Cartridge. Normally set to B. This
  318.             provides a logic LOW at cartridge pin A10. In position A, a
  319.             connection is provided to the computer CSYNC for GENLOCK.
  320. Link 13 - Change Link when fitting a different Reference Diode on the A/D
  321.             input. This diode should be fitted at position PR1.
  322. Link 14 - Used when Chroma MSI chip not fitted.
  323. Link 15 - Select PAL or NTSC TV system encoding.
  324. Link 16 - Not normally fitted.
  325. Link 17 - Not present.
  326. Link 18 - Set East for ROM socket IC 41 active.  Normally  set  West  for
  327.           sideways RAM active.
  328. Link 19 - Set  East  for  ROM socket IC 37 active. Normally set West for
  329.             sideways RAM active.
  330. Link 20 - Not present.
  331. Link 21 - Not  normally  fitted. Links  Light-pen   strobe   into  the
  332.             intercartridge link pin 10. Can be used for Genlock sync via
  333.             LPSTB.
  334.  
  335. Cartridge sockets:
  336. The cartridge socket specification is a superset  of  the  Electron Plus-1 
  337. specification.  All  Electron  Cartridges should work in this machine, but 
  338. may run faster. The  converse  may  not  be  true  unless  a specification 
  339. sub-set  is  used.  Ask for the new Cartridge Specification or consult the 
  340. appropriate Reference Guide.
  341.  
  342. For further technical information on  the  Master 128 machine, consult the 
  343. following:
  344.          Master Series Welcome Guide - Product Code ADJ01
  345.          Master Series Reference Manual Part 1 - Product Code ADJ22
  346.          Master Series Reference Manual Part 2 - Product Code ADJ23
  347.          Master Series Advanced Reference Manual - Product Code ADJ24
  348.  
  349. This information is subject to  change  without  notice. No responsibility 
  350. can  be taken for any errors or omissions.  The  user  or  program  writer 
  351. should verify  that  any  application program is suitable for the intended 
  352. environment(s).
  353.  
  354. DJBELL
  355.