Code: |
AS + 701 |
Symbolic: |
bccProcessInfo |
This command will request information about a specific remote user process, with the following parameters:
Offset |
Type |
Label |
Description |
---|---|---|---|
0 |
U32 |
DSID |
Debug session ID (0=Use read-only session if available) |
4 |
U32 |
FLAGS |
Operating flags: 0x00000001 Search by name (#1) (ignore PID) 0x00000002 Search by flash filename (#1) (ignore PID) |
8 |
U16 |
PID |
Process ID |
10 |
STRZ |
NAME |
Optional search process name (if flag supplied) or flash filename (if flag supplied) |
(#1) Search flags are mutually exclusive.
On success, a bccAck is received with the following data:
Offset |
Type |
Label |
Description |
---|---|---|---|
0 |
U8 |
HH |
Time (hour) of the process |
1 |
U8 |
MM |
Time (minute) of the process |
2 |
U8 |
SS |
Time (second) of the process |
3 |
U8 |
DD |
Date (day) of the process |
4 |
U8 |
MO |
Data (month) of the process |
5 |
U8 |
YY |
Data (year - 2000) of the item |
6 |
U16 |
PID |
Process ID |
8 |
U32 |
PTYPE |
Process type: 0x00000000 Generic 0x00000001 R 16bit 0x00000002 (riservato) 0x00000003 RHLL 16bit 0x00000004 (riservato) 0x00000005 RHLL 32bit 0x00000006 DSP56 0x00000007 R, 32bit 0x00000008 R3.COF, 32bit 0x00000009 Ladder diagram 0x0000000A R3.ELF PPC, 32bit 0x0000000B R3.ELF X86, 32bit 0x0000000C R3.ELF ARM, 32bit 0x0000000D System, 32bit 0x0000000E R4.ELF ARM, 32bit |
12 |
U32 |
PCF |
Process capabilities flags: 0x00000001 Support breakpoints 0x00000002 Support trace 0x00000004 Support process control 0x00000008 Process can be stopped 0x00000010 Process can be started 0x00000020 Process can be killed 0x00000040 Support variable forcing |
16 |
U16 |
CRC16 |
Binary file crc16 value (0=Information not available) |
18 |
U16 |
- |
Reserved |
20 |
B[64] |
DATA |
Data according language type |
84 |
STRZ |
NAME |
Process name |
Specific DATA for PTYPE 0x00000007 (R):
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U16 |
PSTYPE |
Process subtype:
0x0000 = Unknown 0x0001 = Time sharing 0x0002 = Rule 0x0003 = Rule on input 0x0004 = Timed asynchronous rule 0x0006 = Periodic rule |
+2 |
U32 |
MSIZE |
Memory size [byte] |
+6 |
U32 |
STEPC |
No. of executable steps |
+10 |
B[32] |
CCID |
Compiler ID string |
Specific DATA for PTYPE 0x8 (R3.COF):
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U16 |
PSTYPE |
Process subtype:
0x0000 = Unknown 0x0001 = Time sharing 0x0002 = Rule 0x0003 = Rule on input 0x0004 = Timed asynchronous rule 0x0006 = Periodic rule |
+2 |
U32 |
MSIZE |
Memory size [byte] |
+6 |
U32 |
STEPC |
No. of executable steps |
+10 |
B[32] |
CCID |
Compiler ID string |
+42 |
U16 |
N_EXT |
No. of external symbols |
+44 |
U16 |
N_UNR |
No. of unresolved symbols |
Specific DATA for PTYPE 0x9 (Ladder diagram):
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U8 |
PTYPE |
Process type: 0 = Synchronous 1 = High priority 2 = Normal priority 3 = Low priority |
+1 |
U8 |
TID |
Target ID: 0x00 = Firmware RTE |
+2 |
U16 |
PFREQ |
Process frequency [hz] |
+4 |
B[32] |
CCID |
Compiler ID string |
+36 |
U32 |
VID |
Task version ID |
+40 |
U32 |
PLVID |
Task version ID pre live changes |
Specific DATA for PTYPE 0xA (R3.ELF PPC), 0xB (R3.ELF X86), 0xC (R3.ELF ARM), 0xE (R4.ELF ARM) and 0xD (System):
Offset |
Type |
Label |
Description |
---|---|---|---|
+0 |
U16 |
PSTYPE |
Process subtype:
0x0000 = Unknown 0x0001 = Time sharing 0x0002 = Rule 0x0003 = Rule on input 0x0004 = Timed asynchronous rule 0x0005 = (reserved) 0x0006 = Periodic rule 0x0007 = (reserved) 0x0008 = (reserved) 0x0009 = (reserved) 0x000A = (reserved) 0x000B = RPE extension 0x000C = XPL extension 0x000D = Service RTE-1 0x000E = Service RPE 0x000F = Service OB 0x0010 = Service RTE-2 |
+2 |
U32 |
MSIZE |
Memory size [byte] |
+6 |
U32 |
STEPC |
No. of executable steps |
+10 |
B[32] |
CCID |
Compiler ID string |
+42 |
U16 |
N_EXT |
No. of external symbols |
+44 |
U16 |
N_UNR |
No. of unresolved symbols |
On failure, a bccNack is received. Specific errors:
NACK code |
Description |
Extra data |
---|---|---|
nackNotFound |
Process not found |
|
nackIllegalDebug |
Illegal debug session |
|