Command:              CMD_CNVT_REQ_MODIFY
Destination:          SD_CNVT
Destination Channel:  Channel ID

Description

Clients use this command to modify one or more previously requested signal conversions.

A list of up to 255 signals, identified by the combination of a Signal Request Index and a Signal Index, may be included in the request.

Command data format

Number of Signals	First Signal Request Index	First Signal Index	First Request Flag	First Request Value	...	Last Signal Request Index	Last Signal Index	Last Request Flag	Last Request Value	Padding
1 byte	1 byte	1 byte	1 byte	2 bytes	...	1 byte	1 byte	1 byte	2 bytes	0-3 bytes

Number of Signals

The number of signals to follow.

Signals

Each signal is identified by a pair of numbers, a Signal Request Index and a Signal Index. The Signal Request Index is the first byte of the response to a CMD_CNVT_REQ_VALUES command. The Signal Index is the index of the desired signal in that CMD_CNVT_REQ_VALUES command. The first signal of a request has a Signal Index value of zero.

Request Flag

Specifies when the signal is to be reported.

1:   The signal is to be reported every time it appears in the defined message.
2:   The signal is to be reported every time it changes value.
3:   The signal is to be reported when a counter set to the Request Value is decremented to zero. The counter is decremented every time the defined message appears. The counter is reset to its original value when it reaches zero. Ex. if the counter is set to ten, a new signal message will be sent every tenth message that contains the signal.
4:   The signal is to be blocked from being reported for the number of milliseconds present in Request Value. The result is that the signal is reported approximately once per the specified period.

Request Value

Parameter used for some Request Flag values. (Network byte order.)

none

RESP_OK	Execution of the command was successful.
RESP_INVAL_CHAN	The specified channel is invalid.
RESP_UNSUPPORTED	This command is not supported on the specified channel.
RESP_UNREG	The specified source channel is not registered with the server.
RESP_UNKNOWN_ERR	An unknown error occurred.