Code: |
AS + 420 |
Symbolic: |
bccOscCreate |
This command will try to create a new variable oscilloscope on the connected device. Request parameters are the following:
OIffset |
Type |
Label |
Description |
|---|---|---|---|
0 |
U32 |
OWNER |
Owner identification ID |
4 |
U8 |
NT |
Number of tracks (1-24) |
5 |
VAR0 |
Variable for track 1 |
|
15 |
VAR1 |
Variable for track 2 (opt) |
|
.... |
... |
... |
... |
... |
VAR{NT-1} |
Variable for track NT (opt) |
Notes:
•The maximum value for NT is 24. Size is calculated as 5 + NT * 10.
On success, a bccAck is received with the following data:
Offset |
Type |
Label |
Description |
|---|---|---|---|
0 |
U32 |
ID |
Oscilloscope identification ID |
4 |
U8 |
SIZE |
Total data size, calculated by device (must match your request resulting data size). |
On failure, a bccNack is received. Specific errors:
NACK code |
Description |
Extra data |
|---|---|---|
nackOutOfResource |
No more resource to create a new oscilloscope, |
|
nackDataOverflow |
Data for monitor is exceeding the maximum limit (for BCC3 is 255 bytes) |
|
nackIllegalArgs |
Illegal parameter |
U16 What illegal 1=(unused) 2=Field count 10+N=Bad variable {N} U16 Variable error code 1=Unkown type 2=Bad index 3=Bad address 4=Bad repeat counter 5=Variable data too long |
Notes:
•Don't make any assumption about oscilloscope ID assignment: they are strictly depending to a specific implementation of the BCC3 protocol and can be both in sequential or random order.
•Don't make any assumption of oscilloscope definition persistence: if oscilloscope structures - on a device - run out of space, the specific implementation of the BCC3 protocol can act in different way:
1.Reply with a nackOutOfResouce error.
2.Reuse oscilloscope entries not yet started (older or in an arbitrary order).
•Oscilloscope does not accept multiple value variables, but only those one with single value: if you need multiple value, consider using a monitor instead.
•All variable value are transmitted as float value so if your query double variables you can lost precision.
•Oscilloscopes can use not initialized variables in reading, but they always have conventional 0 value.
