User Tools

Site Tools


command_line

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
command_line [2020/02/15 14:32]
adminz [Signature Calculation Mode]
command_line [2020/04/12 11:54] (current)
jtwine [Signature Calculation Mode]
Line 24: Line 24:
  
 <​code>​ <​code>​
-  -v, --Verbosity ​   (Default: Warning) Compiler verbosity (message level) +  -v, --Verbosity ​       (Default: Warning) Compiler verbosity (message level) 
-  -n, --NoColor ​     (Default: false) No color - do not colorize console output +  -n, --NoColor ​         (Default: false) No color - do not colorize console output 
-  -o, --Options ​     (Default: None) Compiler options +  -o, --Options ​         (Default: None) Compiler options 
-  -f, --File         Required10LC files to compile +  -w, --DisableWarnings ​ (Default: None) Disable specified warnings (message numbers) 
-  --help ​            ​Display this help screen. +  -f, --Files            ​Required ​10LC files to compile 
-  --version ​         Display version information.+  --help ​                ​Display this help screen. 
 +  --version ​             Display version information.
 </​code>​ </​code>​
  
Line 39: Line 40:
 | ''​-N''​ | ''​%%--%%NoColor''​ | Disables the coloring of console output. ​ By default, console output is colored according to the severity of the output (i.e. errors in red, warnings in yellow, etc.) | | ''​-N''​ | ''​%%--%%NoColor''​ | Disables the coloring of console output. ​ By default, console output is colored according to the severity of the output (i.e. errors in red, warnings in yellow, etc.) |
 | ''​-O''​ | ''​%%--%%Options''​ | Sets one or more compiler options. ​ Supported options are listed below. | | ''​-O''​ | ''​%%--%%Options''​ | Sets one or more compiler options. ​ Supported options are listed below. |
 +| ''​-W''​ | ''​%%--%%DisableWarnings''​ | Sets one or more warnings that are to be disabled (suppressed). |
 | ''​-F''​ | ''​%%--%%File''​ | Indicates the files (one or more) that are to be compiled | | ''​-F''​ | ''​%%--%%File''​ | Indicates the files (one or more) that are to be compiled |
  
-Compiler Options:+== Compiler Options ​==
 ^ Option ​ ^ Description ​ ^ ^ Option ​ ^ Description ​ ^
 | WarningsAreErrors | Treats all warnings as errors and stops compilation when the first warning is emitted | | WarningsAreErrors | Treats all warnings as errors and stops compilation when the first warning is emitted |
Line 49: Line 51:
 | DisableOptimizations | This option disables all optimizations |  | DisableOptimizations | This option disables all optimizations | 
 | EnableIntrinsicCommands | This option enables the new intrinsic statements supported by 10LC. When this option is enabled, program 99 is reserved and used for the implementation of intrinsic statements. | | EnableIntrinsicCommands | This option enables the new intrinsic statements supported by 10LC. When this option is enabled, program 99 is reserved and used for the implementation of intrinsic statements. |
-| DebugStep | This option causes generation of a special program (program 98) and inserts calls to this program between lines of code.  The program shows the program line number and waits for you to press <​Enter/​Yes>​ or <​Clear/​No>​ and stores the result in Register E.  Better to use Compiler Directives for this option so it can be turned on and off selectively. |+| DebugStep | This option causes generation of a special program (program 98) and inserts calls to this program between lines of code.  The program shows the program line number and waits for you to press **<​Enter/​Yes>​** or **<​Clear/​No>​** and stores the result in Register E.  Better to use Compiler Directives for this option so it can be turned on and off selectively. |
  
  
Line 89: Line 91:
  
 <​code>​Fluke10LCCompiler Transmit --port COM3 -b9600 -f C:​\TenLCStuff\Script.mrec</​code>​ <​code>​Fluke10LCCompiler Transmit --port COM3 -b9600 -f C:​\TenLCStuff\Script.mrec</​code>​
- 
-A small reminder that when connecting the 9010A to your PC, you will also need a **null modem** adapter or cable. ​ I am personally using a **DTech 10' USB 2.0 to RS232 DB9 Serial Port Adapter Cable** which uses an FTDI chipset, so I would guess that any other adapter that also uses an FTDI chipset would work as well.  Be sure to get that null modem adapter/​cable,​ too. 
  
 ==== Receive Mode ==== ==== Receive Mode ====
Line 100: Line 100:
 | ''​-B''​ | ''​%%--%%Baud''​ | Sets the baud rate to use (max should be 9600) | | ''​-B''​ | ''​%%--%%Baud''​ | Sets the baud rate to use (max should be 9600) |
 | ''​-S''​ | ''​%%--%%Settings''​ | Specifies advanced COM port settings (described below) | | ''​-S''​ | ''​%%--%%Settings''​ | Specifies advanced COM port settings (described below) |
-| ''​-F''​ | ''​%%--%%File''​ | Indicates the file that should be used to store the received data, or "-- -" to indicate the received data should be output to the console| +| ''​-F''​ | ''​%%--%%File''​ | Indicates the file that should be used to store the received data, or "%%-- -%%" to indicate the received data should be output to the console| 
-| ''​-R''​ | ''​%%--%%Raw''​ | Indicates that the data being received should not be processed as MREC|+| ''​-R''​ | ''​%%--%%Raw''​ | Indicates that the data being received should not be processed as MRec (this option cannot be used with the Decode option below) | 
 +| ''​-D''​ | ''​%%--%%Decode''​ | Indicates that the MRec data being received should be further processed and decoded into human readable format (I plan to turn this feature into a decompiler that produces round-trippable code)|
  
 +By default, MRec data is expected to be received from the 9010A. ​ This is the data format that is sent when you use the ''<​AUX/​IF>​ <​WRITE>''​ combination on the 9010A. ​ When MRec data is being sent, the data can be verified via the checksum values in the data records being sent, and the end of the transmission can be detected.
 +
 +If you are receiving text data, like if you are just listing programs or address space information,​ using the raw option allows this data to be received normally and not undergo the additional processing that happens with MRec data.  ​
  
 For example, to receive a complete data dump from a 9010A connected to using serial port COM3, baud rate of 9600, using the default serial configuration of N81 and dumping the received data to the console: For example, to receive a complete data dump from a 9010A connected to using serial port COM3, baud rate of 9600, using the default serial configuration of N81 and dumping the received data to the console:
Line 109: Line 113:
  
 ==== Signature Calculation Mode ==== ==== Signature Calculation Mode ====
-Serial Transmit ​mode is specified by passing "transmit" as the first command line parameter. ​ After that, the following switches are supported:+Signature Calculation mode calculates 9010A signature values that can be used with the ROM Test to verify the integrity of ROM data that is present on a UUT.  Signature Calculation ​mode is specified by passing "signature" as the first command line parameter. ​ After that, the following switches are supported:
  
 ^Short Form  ^Long Form  ^Description ​ ^ ^Short Form  ^Long Form  ^Description ​ ^
-| ''​-V''​ | ''​%%--%%Verbosity''​ | Sets the verbosity of the compiler. ​ Supported verbosity values are ''​Debug'',​ ''​Verbose'',​ ''​Info'',​ ''​Warning'',​ and ''​Error''​. ​ The default verbosity setting is ''​Warning''​. | +| ''​-M''​ | ''​%%--%%Minimal''​ | Specifies ​minimal output ​
-| ''​-P''​ | ''​%%--%%Port''​ | Specifies ​the name of the serial port to use (e.g. COM1, COM2, etc.) | +| ''​-C''​ | ''​%%--%%CSV''​ | Specifies ​CSV output ​
-| ''​-B''​ | ''​%%--%%Baud''​ | Sets the baud rate to use (max should be 9600) +| ''​-F''​ | ''​%%--%%File''​ | Indicates the files that should be processed ​|
-| ''​-S''​ | ''​%%--%%Settings''​ | Specifies ​advanced COM port settings (described in [[Command Line#​Transmit Mode]]) ​+
-| ''​-F''​ | ''​%%--%%File''​ | Indicates the file that should be sent |+
  
-For example, ​to transmit a compiled MREC file located at ''​C:​\TenLCStuff\Script.mrec''​ using serial port COM3, baud rate of 9600, using the default serial configuration of N81:+This feature is able to reach into ZIP files and perform ​the calculations on them as well.
  
-<​code>​Fluke10LCCompiler ​Transmit --port COM3 -b9600 ​-f C:​\TenLCStuff\Script.mrec</​code>​+For example, to calculate the signatures for all files contained in a ZIP file located at ''​C:​\TenLCStuff\MyGamesRoms.zip'':​ 
 + 
 +<​code>​Fluke10LCCompiler ​Signature ​-f C:​\TenLCStuff\MyGamesRoms.zip</​code>​
  
  
command_line.1581798768.txt.gz · Last modified: 2020/02/15 14:32 by adminz