Grass Valley K2 Edge Protocol Manual v1.0 - Manual (Page 26)

K2 Edge Protocol Manual – document version 1.0 – Page 26
5.9.2. Feedback level 'basic'
Coverage from the reception point up to and including the start point, spanning only part of the first
preload phase. Any event beyond the start point is suppressed in the feedback. The only information the
initiator will receive is whether or not the (preload part of) the command was successfully started.
The following tables show feedback messages for all possible paths through the life cycle of the
command. There is only one success path, and there are always several failure paths. Select a path and
read from left to right to see which messages can be expected for which events. The bold text indicates
the terminating feedback message.
path note field reception start error ready play error safe stop
success (1) fb-event
fb-stat
ack
ok
start
ok
failure (2) fb-event
fb-stat
nak
error
failure (3) fb-event
fb-stat
ack
ok
start
error
Notes:
1) The command is considered valid at the reception point and the preload phase started
successfully. No feedback is provided on any of the following events, including possible errors.
The template will run until it reaches the stop point, possibly with limited functionality due to
errors encountered during the preload and/or playback phase of the command.
2) The command is considered invalid at the reception point. The command is not executed.
3) The command is considered valid at the reception point, but failed to start (for example due to a
bad template name). The command is not executed.
Example:
Here is an example of a preload-play command sent to nexos, and the two feedback messages
received from nexos in the default basic feedback level. The command instructs nexos to preload and
play a template called ShowLogo, instance number 42.
{cmd=nre; subcmd=preload-play; template=ShowLogo; inst=42; exid=1;
fb-sw=true; fb-lev=basic;}
The feedback messages from nexos, assuming the success path, are these:
{cmd=nre; subcmd=preload-play; template=ShowLogo; inst=42; exid=1;
fb-sw=true; fb-lev=basic; fb-event=ack; fb-stat=ok;}
{cmd=nre; subcmd=preload-play; template=ShowLogo; inst=42; exid=1;
fb-sw=true; fb-lev=basic; fb-event=start; fb-stat=ok; fb-term-sw=true;}
The messages above were wrapped for layout purposes. Newlines do not exist in K2 Edge API
commands.