Editing SmartBox AlbertLink (section)

== Idle ==

At this point the system is idling, both ends are waiting to originate a "event" or receive one.

The remote end should check the serial port as often as possible, if it detects a byte then it should read it, check it is in range, and transmit a 0 (byte) back, then it should do one of the following "event" types according to the byte it received:

=== File ===

1 +byte +string

* byte = channel reference (1 to 10)
* string = file name
* the file should then be opened and a FileBack event made or a Error event, to signal a error

=== Close ===

2 +byte

* byte = channel reference

=== Store === 

3 +byte +data (terminated by NUL)

* byte = channel reference
* data = data to put to file

=== Trace ===

==== Old ====

4 +string

* string = string to print

==== New ====

4 +string +double byte

* string = procedure name
* double byte = line number

Return: byte
* byte = flag
*: 0, no stepping
*: 1, wait for tracecont

=== Print ===

5 +[characters terminated by NUL, CR expand to CRLF]

* do not CRLF after this, keep cursor position

=== Error ===

6 +string +string2 +string3       (to change)

* string = procedure name (blank if from cmd line)
* string2 = error
* string3 = line containing error (blank if from cmd line)

=== Ask ===

7 +byte

* byte = 'S', 'N' or 'T' (input type)

Return
* use AskBack to return input string

=== Inkey ===

8

Return: byte
* 0 -> no key
* #0 -> key value

=== Cmd ===

9

* this means that command mode is ready

=== Build ===

10 +string

* string = proc to edit

=== Edit ===

11 +string

* string = proc to edit

=== Quit ===

12

* user has typed QUIT, use Quit to quit system

=== TraceFl ===

13 +byte

* byte = trace flag (0 -> off, #0 -> on)

=== Load ===

14 +string

* string = filename
* use Put
* use Error for filing errors
* string can be blank

=== Save ===

15 +string +string2

* string = filename
* string2 = procedure to save (or blank for all)
* use Error for filing errors
* use Get/List to get procedures

=== Control ===

16 +byte

* byte = control parameter, if out of range, return 0 and then use Error

Return: byte
* byte = value of control option

=== Rtc ===

17

Return: byte +byte2 +byte3 +byte4
* byte = hours
* byte2 = minutes
* byte3 = seconds
* byte4 = centiseconds

Cause Error AFTER returning 0 for all if not supported.

=== Printer ===

18

* as Print

=== Altered ===

19 +byte

* byte = flag
*: bit 0 : procedure list changed
*: bit 1 : labels changed

when you get this you should use List and/or ReadLabels to update yourself

=== Custom ===

20 +data (NUL terminated)

=== Custom2 ===

21 +data (NUL terminated)

=== Customfn ===

22 +string

Return : byte
* byte = fn value

=== Prompt ===

23 +string

* string = prompt string

NB: "string" is a group of characters terminated by CR.

Any other codes should be ignored.