User Tools

Site Tools


documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
documentation [2020/02/14 17:27]
adminz
documentation [2020/09/21 21:44] (current)
adminz [10LC Statements]
Line 1: Line 1:
 ====== Documentation ====== ====== Documentation ======
-This page covers the statements/​operations ​implemented in 10LC as well as the syntax for their usage.  ​+This page covers the statements implemented in 10LC as well as the syntax for their usage.  ​
  
 ===== 10LC Statements ===== ===== 10LC Statements =====
Line 20: Line 20:
 Are all the same and will compile identically. Are all the same and will compile identically.
  
-The only exception is a Label, which does not end with a semicolon and no space is allowed between the colon and the label name:+The only exception is a Label, ​**which does not end with a semicolon and no space is allowed between the colon and the label name**:
  
 <code c> <code c>
Line 31: Line 31:
 Additionally,​ delimiters in statements may not be omitted. ​ For example, the 9LC WRITE statement is ''​WRITE @ 1234 = AB''​ and could be shortened to ''​WRITE 1234 = AB''​. ​ 10LC's statement syntax is more rigid. ​ The WRITE statement in 10LC is ''​WRITE @ 0x100 = 0x22;''​ and cannot be shortened, nor can any parts of it be omitted. Additionally,​ delimiters in statements may not be omitted. ​ For example, the 9LC WRITE statement is ''​WRITE @ 1234 = AB''​ and could be shortened to ''​WRITE 1234 = AB''​. ​ 10LC's statement syntax is more rigid. ​ The WRITE statement in 10LC is ''​WRITE @ 0x100 = 0x22;''​ and cannot be shortened, nor can any parts of it be omitted.
  
 +From here, you can view the [[Setup Statements]],​ [[Operational Statements]],​ [[If Expressions]] or the currently supported [[Intrinsic Statements]].
  
-===== Setup Statements ​===== +===== Other Documentation and Help ===== 
-First we start with the statements that are used for configuring the unit and the compile environment.+A listing of compiler [[Errors]] ​and [[Warnings]] is available, as well as a [[FAQ]].
  
-==== SetupPod ==== 
-The ''​SetupPod''​ statement configures both the 9010A and the compile environment,​ and sets the default values for some of the other ''​Setup*''​ statements like ''​SetupBusTestAddress'',​ ''​SetupRunUUTAddress''​ and the names of Forcing Lines. 
  
-Unlike with 9LC, information on the standard Pods is stored within the compiler and no additional external files are needed. ​ If you use the SetupPod statement, it must be the first statement in a source file.  ​ 
- 
-The following Pods are supported directly by 10LC: 
-  * ''​6502''​ 
-  * ''​6800''​ 
-  * ''​6802''​ 
-  * ''​6809''​ 
-  * ''​6809E''​ 
-  * ''​8041''​ 
-  * ''​8048''​ 
-  * ''​8080''​ 
-  * ''​8085''​ 
-  * ''​8086''​ 
-  * ''​8086M''​ 
-  * ''​8088''​ 
-  * ''​8088M''​ 
-  * ''​9900''​ 
-  * ''​68000''​ 
-  * ''​Z80''​ 
-  * ''​Z8000''​ 
- 
- 
-<code c> 
-SetupPod Z80 
-</​code>​ 
- 
-If you need to create your own Pod configuration/​environment,​ you can use the ''​Setup*''​ statements directly. 
- 
- 
-==== SetupTraps ==== 
-This statement enables or disables traps associated with UUT errors. ​ This statement can be specified multiple times, and you can specify multiple traps within a single statement. 
- 
-<code c> 
-SetupTraps DataError No; 
-SetupTraps ActiveInterrupt DataError No; 
-SetupTraps BadPowerSupply ActiveInterrupt ActiveForceLine Yes; 
-</​code>​ 
- 
-==== SetupEnableFL ==== 
-This statement enables or disables Pod-specific forcing lines associated with a CPU.  You can specify forcing lines but their bit value, or by their string identifiers. ​ Like with the ''​SetupTraps''​ statement, this statement can be specified multiple times, and you can specify multiple forcing lines within a single statement. 
- 
-<code c> 
-SetupEnableFL 0x01 Yes; 
-SetupEnableFL 0x02 Ready No; 
-SetupEnableFL ​ BrAck  0x05  Yes; 
-</​code>​ 
- 
-If you use symbolic names for the forcing lines, they will be checked against the configured Pod, and if no Pod has been configured, an error will be emitted. ​ If you use the numeric bit value, it is not checked and can be used with no Pod configured. 
-  
-==== SetupBeep ==== 
-This statement sets whether the 9010A unit emits a beep on an error transition. ​ This is equivalent to the ''​BEEP''​ statement in 9LC. 
- 
-<code c> 
-SetupBeep Yes; 
-</​code>​ 
- 
-==== SetupInteractiveErrors ==== 
-This statement sets whether the 9010A pauses execution, displays an error message, and asks the user if they want to loop the last operation whenever an error is encountered. ​ This is equivalent to the ''​EXERCISE ERRORS''​ statement in 9LC. 
- 
-<code c> 
-SetupInteractiveErrors Yes; 
-</​code>​ 
- 
-==== SetupBusTestAddress ==== 
-This statement configures the default address used when a Bus Test is performed. ​ This value defaults to ''​0x0000''​ but may be changed when a Pod is specified via the ''​SetupPod''​ statement. 
- 
-<code c> 
-SetupBusTestAddress 0xFFF0; 
-</​code>​ 
- 
-==== SetupRunUUTAddress ==== 
-This statement configures the default address used when the Run UUT operation is performed. ​ This value defaults to ''​0x0000''​ but may be changed when a Pod is specified via the ''​SetupPod''​ statement. 
- 
-<code c> 
-SetupRunUUTAddress 0xFFFE; 
-</​code>​ 
- 
-==== SetupXOn ==== 
-This statement configures the serial **XOn** character used to pause transmission of serial data.  This is called the "​**STALL**"​ character in 9LC and it defaults to **<​CONTROL+S>​** (0x13). 
- 
-<code c> 
- 
-</​code>​ 
- 
-==== SetupXOff ==== 
-This statement configures the serial **XOff** character used to resume transmission of paused serial data.  This is called the "​**UNSTALL**"​ character in 9LC, and it defaults to **<​CONTROL+Q>​** (0x11). 
- 
-<code c> 
- 
-</​code>​ 
- 
-==== SetupLineSize ==== 
-This configures the serial line length used when transmitting serial data.  This is an important setting when sending/​receiving hex data from the 9010A unit as longer lines lessen the effectiveness of the per-line checksum. 
- 
-The 10LC compiler also uses this setting to determine the length of hex lines when it generates its output file.  It has a range of 10-255. ​ If not specified, the default value is 79.  This is equivalent to the ''​LINESIZE''​ statement in 9LC. 
- 
-<code c> 
- 
-</​code>​ 
- 
- 
-==== SetupPodTimeout ==== 
-This configures the amount of time the 9010A should wait for a connected Pod to respond to a requested operation. ​ 
- As of right now, there is no description for how long a single count is.serial line length used when transmitting serial data.  This is an important setting when sending/​receiving hex data from the 9010A unit as longer lines lessen the effectiveness of the per-line checksum. 
- 
-It has a range of 6-60000. ​ If not specified, the default value is 200.  This is equivalent to the ''​TIMEOUT''​ statement in 9LC. 
- 
-<code c> 
- 
-</​code>​ 
- 
-==== SetupNewline ==== 
-This configures both the character combination used to represent newlines on the serial interface as well as a configurable delay time between successive lines being transmitted. ​ The value used with this statement is a 32-bit hexadecimal value. 
- 
-The first two digits represent a delay count between transmitting successive lines. ​ Each count is ~6ms per count on firmware version 2C or later, or ~2.4ms per count on versions earlier than 2C.  The last six characters are the hexadecimal character combination that should be sent to indicate a newline. ​ A zero value indicates no character is to be sent.If not specified, the default value is 0x00000D0A. ​ This is equivalent to the ''​NEWLINE''​ statement in 9LC. 
- 
-<code c> 
- 
-</​code>​ 
- 
-==== SetupMaskFLMayBeEnabled ==== 
- 
-<code c> 
- 
-</​code>​ 
- 
-==== SetupForcingLineNames ==== 
- 
- 
-==== SetupMemMap ==== 
- 
- 
-==== Statement ==== 
- 
-===== Operation ===== 
- 
-==== Sub ==== 
  
documentation.1581722830.txt.gz · Last modified: 2020/02/14 17:27 by adminz