Difference between revisions of "MC-Basic:SYSTEM.DIPSWITCH"

From SoftMC-Wiki
Jump to: navigation, search
m (Text replace - "Read-Only" to "Read only")
(Described simulated DIP switch and Inputs)
Line 16: Line 16:
  
 
|DESCRIPTION=
 
|DESCRIPTION=
SYSTEM.DIPSWITCH reads the value of one or more of the 8 DIPswitch inputs. The variable contains the values of the individual bits in the DIPswitch byte. If SYSTEM.DIPSWITCH is qualified by a bit number, only that input bit is read. SYSTEM.DIPSWITCH returns the value 1 or 0, depending on the setting of the switch.
+
SYSTEM.DIPSWITCH reads a value of simulated DIP-Switch from file IO.DAT. It contains the values of the individual bits in the DIPswitch byte. If SYSTEM.DIPSWITCH is qualified by a bit number, only that input bit is read. SYSTEM.DIPSWITCH.<bit_number> returns the value 1 or 0, depending on the setting of the switch.
 +
 
 +
<br>File IO.DAT is generated '''automatically''' if it does not exist on the flash disk.
 +
<br>''Format of IO.DAT''
 +
<br>DIP=0x0
 +
<br>INP=0x0
 +
 
 +
Value of simulated DIP-Switch is read via SYSTEM.DIN
 +
Value of simulated Inputs is read via SYSTEM.DIN.1 trough  SYSTEM.DIN.23
  
 
Bit # 6 directs the system not to load the Config.prg file during system startup.<br>
 
Bit # 6 directs the system not to load the Config.prg file during system startup.<br>
       0= Config.prg is not loaded.<br>
+
       0= Config.prg and Autoexec.prg are not loaded.<br>
       1 = Config.prg is loaded. Default value should be 1 during normal operation.
+
       1 = Config.prg and Autoexec.prg are loaded. Default value should be 1 during normal operation.
 
 
Bit # 7 directs the system to run using the firmware backup file (VxBackup) during system startup.<br>
 
       0 = VxWorks is loaded. Default value should be 0 during normal operation.<br>
 
       1= VxBackup is loaded
 
  
Bit # 8 is reserved for system use.
+
Other bits reserved for system use.
  
 
|TYPE=
 
|TYPE=

Revision as of 11:10, 9 April 2014

SYSTEM.DIPSWITCH reads a value of simulated DIP-Switch from file IO.DAT. It contains the values of the individual bits in the DIPswitch byte. If SYSTEM.DIPSWITCH is qualified by a bit number, only that input bit is read. SYSTEM.DIPSWITCH.<bit_number> returns the value 1 or 0, depending on the setting of the switch.


File IO.DAT is generated automatically if it does not exist on the flash disk.
Format of IO.DAT
DIP=0x0
INP=0x0

Value of simulated DIP-Switch is read via SYSTEM.DIN Value of simulated Inputs is read via SYSTEM.DIN.1 trough SYSTEM.DIN.23

Bit # 6 directs the system not to load the Config.prg file during system startup.
       0= Config.prg and Autoexec.prg are not loaded.
       1 = Config.prg and Autoexec.prg are loaded. Default value should be 1 during normal operation.

Other bits reserved for system use.

Syntax

System.DipSwitch{.<bit number>}

Sys.DipSwitch{.<bit number>}

?System.DipSwitch{.<bit number>}

?Sys.DipSwitch{.<bit number>}

Availability

All versions; PCI and Standalone only

Type

<bit number>: Long

Value: Long

Range

<bit number>: 1 to 8

Value: 0 to 255 (0xFF)

Default

See description.

Scope

Configuration, Task or Terminal

Limitations

Read only

Examples

MyVar = System.DipSwitch

'MyVar is assigned the value of the input word

MyVar = System.DipSwitch.1

'MyVar is assigned 0 or 1, according to the value of the switch