Alcorn Mcbride V+ series, Руководство пользователя

Страница: 241 / 276

15-5 Appendix A
– Adding User-Defined Serial Protocols
Ap
p
end
ice
s
A
sub-name is required only when you have several versions of the same event.
This sub-name should be unique from other sub-names of this same event, and
should also be as meaningful as possible. In this case [
Play:UntilFrame ]
means play the disc until a certain frame is reached ( which is an argument to the
event ). The colon is only required when a sub-name is included.
The Description field becomes the explanatory text that is displayed in Event
Wizard.
The
Supported
field has the same purpose as it does in the [Device] header
except for it applies to the event itself. Therefore it is possible to have a
Protocol file that is defined to be supported under firmware revision 5.30, but
some of the events only work under revision 5.50 and later. The compiler first
checks the Protocol, and then the individual event. Under most circumstances,
the
Supported
field is not needed in each event for user defined protocols, and
can be omitted.
The Param fields of the event have four purposes:

Qualify the data, making sure it conforms to the requested type

Translate the actual data the user entered into a particular format in the
compiler's temporary buffer.

Describe an error message to display if the data does not qualify correctly

Describe the correct parameter to enter in the field (used by Event Wizard)
param1=port, "A valid Port"
param2=framestring, "A valid Frame number"
In this case, the first parameter must be a valid port name. The compiler looks
up the text put into the first parameter and verifies that there is a valid port with
that name in the
Configuration | Ports window. If there is no port with that
name, the compiler will display the error following the qualifier. If there is, the
compiler will stuff one byte into the compiler's temporary buffer—which will be
the index of the port in question. The second parameter must be a valid frame
number-- the compiler confirms that the text entered is all digits, and less than
the maximum number of frames. If it is, it stuffs the frame number in ASCII
into the compiler's temporary buffer. If it isn't, the error message will be
displayed.