diff --git a/Doc/RomWBW Applications.pdf b/Doc/RomWBW Applications.pdf index c6956ff5..7044b669 100644 Binary files a/Doc/RomWBW Applications.pdf and b/Doc/RomWBW Applications.pdf differ diff --git a/Doc/RomWBW Disk Catalog.pdf b/Doc/RomWBW Disk Catalog.pdf index 099d95d0..78de71c3 100644 Binary files a/Doc/RomWBW Disk Catalog.pdf and b/Doc/RomWBW Disk Catalog.pdf differ diff --git a/Doc/RomWBW Hardware.pdf b/Doc/RomWBW Hardware.pdf index c817385e..e1ca69a0 100644 Binary files a/Doc/RomWBW Hardware.pdf and b/Doc/RomWBW Hardware.pdf differ diff --git a/Doc/RomWBW Introduction.pdf b/Doc/RomWBW Introduction.pdf index 8f30726e..aecd65ef 100644 Binary files a/Doc/RomWBW Introduction.pdf and b/Doc/RomWBW Introduction.pdf differ diff --git a/Doc/RomWBW System Guide.pdf b/Doc/RomWBW System Guide.pdf index 81002f7f..730634c5 100644 Binary files a/Doc/RomWBW System Guide.pdf and b/Doc/RomWBW System Guide.pdf differ diff --git a/Doc/RomWBW User Guide.pdf b/Doc/RomWBW User Guide.pdf index f768f691..91c05a23 100644 Binary files a/Doc/RomWBW User Guide.pdf and b/Doc/RomWBW User Guide.pdf differ diff --git a/Source/Doc/SystemGuide.md b/Source/Doc/SystemGuide.md index 7ab3290c..ef780f7e 100644 --- a/Source/Doc/SystemGuide.md +++ b/Source/Doc/SystemGuide.md @@ -659,8 +659,10 @@ latter version of the SBC. On systems with RTC devices (that have Non-Volatile RAM), RomWBW supports storing some limited configuration option options inside this RAM. -Several configuration options are currently supported; these are known as Switches. -The following switch ID's are defined, and described in sections below. +Several configuration options are currently supported; these are +referred to as Switches. In this case the term Switches refers to "soft" +switches stored in NVRAM, not physical panel switches. The following +switch ID's are defined, and described in sections below. | Switch Number | Name | Description | |---------------|--------------|-----------------------------------------------| @@ -683,6 +685,11 @@ the bytes in NVRAM to check for authenticity before using the configuration. The above data is copied into the HBIOS Configuration Block (HCB) at startup at the location starting at CB_SWITCHES. +Although the switch data is stored in NVRAM, it is intended that you +use [SYSGET Subfunction 0xC0 -- Get Switches (SWITCH)] or +[SYSSET Subfunction 0xC0 -- Set Switches (SWITCH)] to read or write +the switch values described here. + ### Boot Options (NVSW_BOOTOPTS) 16 bit Switch defining the ROM application or Disk device to boot if @@ -705,13 +712,15 @@ automatic booting is enabled. ### Status Reset (0xFF) -The Status Reset switch is not a general purpose switch, it is a control mechanism -to allow the global status of all switches to be determined. The meaning of the switch -is different for Read (Get Status) and Write (Reset NVRAM) +The Status Reset switch is a virtual switch that does not have a +corresponding stored value. It is a control mechanism to allow the +global status of all switches to be determined. The meaning of the +switch is different for Read (Get Status) and Write (Reset NVRAM) #### GET (Get Status) -The read Get Status of switches. This returns very specific values from the function call. +When the switch number 0xFF is read (using the Get Switches function), +the status of the NVRAM switches will be returned as follows: | Status | A Register | Z / NZ Flag | |----------------------------------------------|------------|--------------| @@ -721,8 +730,10 @@ The read Get Status of switches. This returns very specific values from the func #### SET (Reset NVRAM) -Reset NVRAM to default values. This will wipe any existing data and set default -values into NVRAM. +When the switch number 0xFF is written (using the Set Switches +function), the stored values of all switches will be reset to their +default values. This will wipe any existing data and set default values +into NVRAM. # Driver Model