6 get string – Kramer Electronics SP-14 User Manual

Page 18

Advertising
background image

The parameter request packet takes the following format:

1

2

3

4

5

6

7

8

9

10 11 12 13 14 15 16

‘A’

‘P’ ‘C’

paramID

attribute

value

‘A’

Where

‘A’, ‘P’, ‘C’

are literal ASCII characters.

paramID

is the parameter identifier. (see 3.2.1.2 Parameter Identifier)

attribute

is the attribute identifier. (see 3.2.1.3 Attribute)

value

is a value.

Only the avParamAttr_value and avParamAttr_e2value attributes may be set and these must be use

together. The avParamAttr_value attribute changes the specified parameters’ value. The

avParamAttr_e2value attribute either writes the specified value into persistent storage or writes the

value that was previously set using the avParamAttr_value attribute. Writing to persistent storage can

be slow therefore the recommended usage is to use the avParamAttr_value attribute for interactive

adjustment and then complete the adjustment with one set of the avParamAttr_e2value attribute.

It is advisable follow the example scenario presented in this document (see 3.3.5.3.1) when creating

user interfaces using the protocol.

Only the values between the minimum and maximum values (obtained using the get function) are

valid.

The set function on successful completion will return a successful reply packet. See “3.2.2.1 Success

Reply Packet”.

3.2.6 Get String
The get string function is used to obtain a string value. This may be used to convert the numeric value

into a string or it may be used to obtain information in the form of a string (in this case the get value

function will not be implemented).

The parameter request packet takes the following format:

1

2

3

4

5

6

7

8

9

10 11 12 13 14 15 16

‘A’

‘P’ ‘D’

paramID

attribute

Value

‘A’

Where

‘A’, ‘P’, ‘D’

are literal ASCII characters.

paramID

is the parameter identifier. (see 3.2.1.2 Parameter Identifier)

attribute

is the attribute identifier. (see 3.2.1.3 Attribute)

value

is a value.

There is no difference between the avParamAttr_value and avParamAttr_e2value attributes. The

current recommendation is to set attribute to avParamAttr_value.

For the reply packet see

3.2.2.3 Success Reply Packet with string returned”.

Advertising