Skip to content

COMiX Commands

Marcel van Tongeren edited this page Dec 3, 2023 · 13 revisions

Auto baud

The default baud rate (on power on and reset) is set to 9600 baud for a COMiX running a CPU on 2.8 MHz.

To change the baud rate setting or when using different CPU speeds first type the following on the COMX: BAUD

The COMiX is now waiting for a 'return' character from the terminal, type the return (on the terminal) and the COMiX will come back with the READY prompt. The new baud rate should now be set. After every restart or power on the baud rate will be set to default value of 9600 baud.

We have tested the following:

  • Default setting, COMiX CPU 2.8 MHz - 9600 Baud
  • COMiX CPU 6 MHz - 9600 baud
  • COMiX CPU 6 Mhz - 19200 baud

Program files

Save

The following types of programs can be saved:

  1. a BASIC program
  2. a BASIC program using DEFUS and including a machine language program at @4400 - DEFUS
  3. a Machine language program anywhere in COMiX memory

For any of the 3 file types, first set the terminal SW in receiving mode (turn log mode on in TeraTerm and specify a filename):

Then for types 1 and 2, on the COMiX type: PSAVE

And for type 3, on the COMiX type: PSAVE start address, end address, execution address

Where start address/end address indicate machine language start and end location and execution address the optional execution address. If execution address is not specified the start address value will be saved as the execution address.

When the COMiX returns with the READY prompt stop the receiving mode in the PC terminal SW (turn off log mode in TeraTerm).

Load

On the COMiX type: PLOAD

In the terminal use the binary file send option to transfer a .comx files to the COMiX, in TeraTerm:

When the COMiX returns with the READY prompt the file is loaded.

When loading type 1 and 2 (no additional info shown before READY), use RUN to start the program.

When loading type 3, the execution address will be printed as: EXEC: @xxxx, use CALL(@xxxx) to start the program (where xxxx is the execution address as specified by the PLOAD command.

A machine language example is ‘F&M Monitor English.comx’ which when loaded with PLOAD will load to address @9900-@A7FF and show EXEC: @A000. To start the program use: CALL(@A000).

Data files

Save

First set the terminal SW in receiving mode (turn log mode on in TeraTerm).

On the COMiX type: DSAVE

When the COMiX returns with the READY prompt stop the receiving mode in the PC terminal SW (turn off log mode in TeraTerm).

Note the following when using DSAVE&DLOAD:

  1. If the user memory space contains both a program and data, any editing of the program will wipe out the data. Therefore, before any editing is done, do a DSAVE to save the data (if desired), edit the program, and do a DLOAD to return the data.
  2. Doing a DLOAD automatically dimensions any arrays within the stored data.
  3. Strings are placed at the end of the array space. If additional arrays are dimensioned after the strings have been generated, the strings will be wiped out by the growing array space. For this reason, all array dimensioning should be done before any strings are generated.

Before doing a DSAVE of course data should have been stored.

For example: DIM A(3) A(1) = 1 A(2) = 2 A(3) = 3 A$ = “SOME DATA” DSAVE

Load

On the COMiX type: DLOAD

In the terminal use the binary file send option to transfer a data .comx file.

Try loading back the DSAVE example above: DLOAD PR A$ PR A(1) PR A(2) PR A(3)

Note that .comx files saved with DSAVE on Emma 02 or the COMX SuperBoard, can currently not be loaded with DLOAD. Compatible versions for both will be released later.

Clone this wiki locally