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

From SoftMC-Wiki
Jump to: navigation, search
m (1 revision)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{Languages|MC-Basic:SYSTEM.DIPSWITCH}}
 
{{MC-Basic
 
{{MC-Basic
 
|SHORT FORM=
 
|SHORT FORM=
Line 4: Line 5:
  
 
|SYNTAX=
 
|SYNTAX=
System.DipSwitch{.''<bit number>''}<br>
+
System.DipSwitch{.<''bit number''>}<br>
  
Sys.DipSwitch{.''<bit number>''}<br>
+
Sys.DipSwitch{.<''bit number''>}<br>
  
?System.DipSwitch{.''<bit number>''}<br>
+
?System.DipSwitch{.<''bit number''>}<br>
  
?Sys.DipSwitch{.''<bit number>''}
+
?Sys.DipSwitch{.<''bit number''>}
  
 
|AVAILABILITY=
 
|AVAILABILITY=
All versions; PCI and Standalone only
+
Since version 4.11.1
  
 
|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, from field "DIP". 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=0xXX
 +
<br>INP=0xXX
 +
 
 +
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=
''<bit number>'': Long<br>
+
<''bit number''>: Long<br>
  
 
Value: Long
 
Value: Long
  
 
|RANGE=
 
|RANGE=
''<bit number>'': 1 to 8<br>
+
<''bit number''>: 1 to 8<br>
  
 
Value: 0 to 255 (0xFF)
 
Value: 0 to 255 (0xFF)
Line 48: Line 53:
  
 
|LIMITATIONS=
 
|LIMITATIONS=
Read-Only
+
Read only
  
 
|EXAMPLE=
 
|EXAMPLE=
Line 62: Line 67:
  
  
 +
[[Category:MC-Basic:System|MC-Basic:System]]
 
}}
 
}}

Latest revision as of 02:07, 2 May 2017

Language: English  • 中文(简体)‎

SYSTEM.DIPSWITCH reads a value of simulated DIP-Switch from file IO.DAT, from field "DIP". 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=0xXX
INP=0xXX

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

Since version 4.11.1

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

See Also