Unigraf UCD-240, User Manual

Page: 58 / 78

UCD Console for UCD-340 User Manual | Unigraf Oy
58.
Key is usually a configuration item write command from this manual (such as
TSI_W_USBC_CABLE_CONTROL ) or " .read " or " .loadtd " and Value is the value you want
to set or get (also from this manual).
For example, to disconnect CC lines, you would use the following command:
-c TSI_W_USBC_CABLE_CONTROL=5;
.Expression (optional) selects the bits of Value that you want to test or modify for the
configuration item in question.
Expressions for commands that write to configuration items are dot-separated keywords of
the form
.startbit.number1.length.number2
where the first number1 is the first bit of the sequence and number2 is the length in bits of
the sequence.
For example, to change the color space, one of the KVE’s in a chain the might be
TSI_PG_CUSTOM_TIMING_FLAGS=1.startbit.11.length.4;
The above KVE sets the TSI_PG_CUSTOM_TIMING_FLAGS configuration item flags 11-
12-13-14 to 1 (0001), which is color space YCbCr 4:4:4. Note that the configuration item
value will be read and bits 11-12-13-14 will be modified and the resulting value will be
written back to the configuration item.
Commands of the form:
-c .read = Value;
are used to read the value of a configuration item. For example
-c .read = TSI_R_USBC_DP_ALT_MODE_STATUS;
will output the value of the configuration item in decimal format.
Commands of the form:
-c .read = Value.Expression;
are used to check values and bits. The configuration item Value modified by Expression up
to a relational operator ( eq , gt or lt ) is used to determine if Value.Expression is true or false.
Expressions for .read commands are dot-separated modifier keywords (at, bitson, bitsoff,
startbit, length and gt, lt, eq) and integer values:
•
.bytes selects the maximum number of bytes to be read with ARRAY_XX types. It
must come right after the Value.
• .at selects the CI via an index for .read KV’s when reading ARRAY_32 types. It
must come right after .bytes if present and right after Value if bytes is not present.
•
.bitson.1.22 is true when bits 1 and 22 are set.
• .bitsoff.1.22 is true when bits 1 and 22 are off.
• .and is used to chain exppressions.
• .eq . .lt . and .gt are relational operators for “equal”, “less than”, or “greater than”.
Example:
-c .read=TSI_R_USBC_DP_ALT_MODE_STATUS.bitson.0.and.startbit.8.length.4.eq.4;
The above command reads the usbc alt-mode status configuration item and will be true if bit
0 is on and bits 8-11 have a value of 4 (“D”: DisplayPort v1.3 2 lanes + USB 3.1 (USB Type
C cable)).
Example:
-c .read=TSI_R_DPRX_ERROR_COUNTS.at.1;