command_line
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
command_line [2020/02/15 13:42] adminz |
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 Required. 10LC 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 == | ||
| + | ^ Option ^ Description ^ | ||
| + | | WarningsAreErrors | Treats all warnings as errors and stops compilation when the first warning is emitted | | ||
| + | | NoPreDefines | Does not define the legacy Aliases for registers (''BITMASK'', ''ROMSIG'', etc.) | | ||
| + | | IgnoreMissingPrograms | Normally, if a file references a problem that is not found at the end of compilation, an error is emitted. This option causes that situation to be ignored. | | ||
| + | | UseNumericProgramNames | By default, all Program names are treated as symbolic identifiers. This causes numeric Program names to be converted to numeric program numbers and not be auto-numbered. | | ||
| + | | 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. | | ||
| + | | 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. | | ||
| + | |||
| For example, to compile a 10C file at ''C:\TenLCStuff\Script.s'' with no options and verbosity set to ''Verbose'': | For example, to compile a 10C file at ''C:\TenLCStuff\Script.s'' with no options and verbosity set to ''Verbose'': | ||
| Line 55: | Line 68: | ||
| | ''-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 sent | | | ''-F'' | ''%%--%%File'' | Indicates the file that should be sent | | ||
| + | |||
| + | Advanced Settings are a 3 character string used to configure the parity, data bits and stop bits for the serial port. Normally, these settings will not have to be changed, but you never know. The first character configures the Parity, the second configures the number of Data Bits, and the last configures the number of Stop Bits. | ||
| + | |||
| + | The following values are supported for Parity: | ||
| + | * N - None | ||
| + | * E - Even | ||
| + | * O - Odd | ||
| + | * M - Mark | ||
| + | * S - Space | ||
| + | |||
| + | The number of allowed Data Bits are 5, 6, 7 and 8. | ||
| + | |||
| + | The following values are supported for Stop Bits: | ||
| + | * N - None | ||
| + | * 1 - One | ||
| + | * 2 - Two | ||
| + | * 1.5 - 1.5 | ||
| + | |||
| + | The default value for this setting is ''N81'': **N**o Parity, **8** data bits, **1** stop bit. | ||
| 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: | 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: | ||
| Line 61: | Line 93: | ||
| ==== Receive Mode ==== | ==== Receive Mode ==== | ||
| - | Serial Transmit mode is specified by passing "transmit" as the first command line parameter. After that, the following switches are supported: | + | Serial Receive mode is specified by passing "receive" as the first command line parameter. After that, the following switches are supported: |
| ^Short Form ^Long Form ^Description ^ | ^Short Form ^Long Form ^Description ^ | ||
| Line 68: | 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 sent | | + | | ''-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 (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)| | ||
| - | 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: | + | 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. |
| - | <code>Fluke10LCCompiler Transmit --port COM3 -b9600 -f C:\TenLCStuff\Script.mrec</code> | + | 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: | ||
| + | |||
| + | <code>Receive --port COM3 -b9600 -f -- -</code> | ||
| ==== 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 below) | | + | |
| - | | ''-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.1581795767.txt.gz · Last modified: 2020/02/15 13:42 by adminz
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
