Jump to main content

# 1.2.7.3.4 Commands List

Some commands include indexes or passwords and parameters.

In older versions of the interpreter, indexes or passwords were expected to be sent enclosed with “[]”. Parameters were expected to be enclosed with “()”. And Case was checked for commands.

This is not needed using the current interpreter, and every parameter can be separated using spaces. In addition, case is not checked anymore so lower case can be used, this is explained in Terminal Interpreter Interface Notes.

In some of the provided examples along this guide, the old format is used just for reference.

The default password is “PIC” but can be changed modifying the application source code.

Examples:

- Example 1: DCW [10] (100000) writes 0x100000 in the control register with index 10
- Example 2: IDW [PIC] (12345Q) sets the Meter Identifier to 12345Q

If the command is not properly received, decoded, or processed by the application, the console will return an error message, such as Unsupported Command, Password Error, and so on.

The following are the supported commands:

CMD | Function | Example | Type | Frame
--- | --- | --- | --- | ---
DCR | Read DSP_CONTROL registers | Read DSP_CONTROL P_K_t register | Frame sent | DCR [09]
Answer | 09 P_K_t 500000
Note | This command can be sent without index. In this case, all the control registers values will be displayed
DCW | Write DSP_CONTROL register | Write DSP_CONTROL P_K_t register | Frame sent | DCW [09] (A00000)
Answer | Set Is Ok !
DCM | Write DSP_CONTROL, multiple registers | Write DSP_CONTROL registers 38 to 41 | Frame sent | DCM(38:7B6310; 39:0; 40:51B7E89; 41:4A9D4CA)
Answer | Set 38 Is Ok ! Set 39 Is Ok ! Set 40 Is Ok ! Set 41 Is Ok !
DSR | Read DSP_ST register | Read DSP_ST STATE_FLAG register | Frame sent | DSR [02]
Answer | 02 STATE_FLAG 7180020
Note | This command can be sent without index. In this case, all the status registers values will be displayed
DAR | Read DSP_ACC register | Read DSP_ACC V_A register | Frame sent | DAR [00]
Answer | 00 V_A 45B051F9B426
Note | This command can be sent without index. In this case, all the accumulator registers values will be displayed
DPCAR | Read Per-Cycle DSP_ACC register | Read Per-Cycle DSP_ACC V_A register | Frame sent | DPCAR [00]
Answer | 00 CYCLE_V_A 164BFA1E2CD
Note | This command can be sent without index. In this case, all the per-cycle accumulator registers values will be displayed
HAR | Read harmonic register | Read third harmonic register | Frame sent | HAR [03]
Answer | 000 I_A_m_R 031 V_A_m_R 062 I_B_m_R 093 V_B_m_R 0 0 0 0 124 I_C_m_R 155 V_C_m_R 186 I_N_m_R 217 I_A_m_I 0 0 0 0 248 V_A_m_I 279 I_B_m_I 310 V_B_m_I 341 I_C_m_I 0 0 0 0 372 V_C_m_I 403 I_N_m_I 0 0
Note | This command can be sent without index. In this case, all the harmonic registers values will be displayed
HRR | Read harmonic calculated Irms/Vrms | Read third harmonic calculated Irms/Vrms | Frame sent | HRR [03]
Answer | Irms_Har_A(A), bitmap: 0x00000004 0.000 0.000 0.057 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Irms_Har_B(A), bitmap: 0x00000004 0.000 0.000 0.029 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Irms_Har_C(A), bitmap: 0x00000004 0.000 0.000 0.028 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Irms_Har_N(A), bitmap: 0x00000004 0.000 0.000 0.004 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Vrms_Har_A(V), bitmap: 0x00000004 0.000 0.000 2.552 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Vrms_Har_B(V), bitmap: 0x00000004 0.000 0.000 1.262 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Vrms_Har_C(V), bitmap: 0x00000004 0.000 0.000 1.298 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000
HRRX | Extended version of HRR, using Harmonics bitmap and Start/Stop functionality | Start Harmonics calculation. Read third and fifth harmonic calculated Irms/Vrms. And leave Harmonics calculation active | Frame sent | HRRX 1 [00000014]
Answer | Irms_Har_A(A), bitmap: 0x00000014 0.000 0.000 0.057 0.000 0.025 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Irms_Har_B(A), bitmap: 0x00000014 0.000 0.000 0.029 0.000 0.013 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Irms_Har_C(A), bitmap: 0x00000014 0.000 0.000 0.028 0.000 0.012 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Irms_Har_N(A), bitmap: 0x00000014 0.000 0.000 0.004 0.000 0.002 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Vrms_Har_A(V), bitmap: 0x00000014 0.000 0.000 2.552 0.000 1.224 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Vrms_Har_B(V), bitmap: 0x00000014 0.000 0.000 1.262 0.000 0.631 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 Vrms_Har_C(V), bitmap: 0x00000014 0.000 0.000 1.298 0.000 0.649 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000
Start Harmonics calculation. Read all harmonics without providing bitmap. And leave Harmonics calculation active. | Frame sent | HRRX 1
Stop Harmonics calculation | Frame sent | HRRX 0
IDR | Read meter id | Frame sent | IDR
Answer | Meter ID is: 12345Q
IDW | Write meter id (id length limited to 6 characters) | Frame sent | IDW[PIC](PI3456)
Answer | Set Meter ID is ok
RST | Perform System Reset | Frame sent | RST[PIC]
Answer | Reset Command is Ok !
RLD | Reset Core 1 and its peripherals. Reload Core 1 metrology library | Frame sent | RLD[PIC]
Answer | Reloading Metrology...
DCB | Go to Low-Power mode | Frame sent | DCB
RTCW | Write meter RTC | Write RTC 20-10-19 01 09:59:00 | Frame sent | RTCW[PIC](20-10-19 01 09:59:00)
Answer | Set RTC is OK
RTCR | Read meter RTC | Frame sent | RTCR
Answer | Present RTC (yy-mm-dd w hh:mm:ss): 20-07-07 2 12:44:54
TOUW | Write meter TOU | Write TOU=8:30 T2 10:30 T3 18:30 T1 22:00 T4 | Frame sent | TOUW [PIC] (08:30 02 10:30 03 18:30 01 22:00 04)
Answer | Set TOU is OK
TOUR | Read meter TOU | Frame sent | TOUR
Answer | TOU table is: TOU1=08:30 T2 TOU2=10:30 T3 TOU3=18:30 T1 TOU4=22:00 T4
ENR | Read energy stored data | Read current month energy | Frame sent | ENR [0]
Answer | Last 0 Month Energy is: TT=4.10kWh T1=1.09kWh T2=1.65kWh T3=0.01kWh T4=1.35kWh
ENC | Clear all energy stored data | Frame sent | ENC [PIC]
Answer | Clear Energy is ok !
EVER | Read single event record | Read last 2 times Ub sag event | Frame sent | EVER[UbSag][2]
Answer | Last 2 times Ub Sag is: Total Num=0003 start time is 10-08 12:25 End time is 10-08 16:23
EVEC | Clear all event record | Frame sent | EVEC [PIC]
Answer | Clear All Event is ok !
MDR | Read maximum demand | Read previous 1 month maximum demand and occurrence time | Frame sent | MDR [1]
Answer | Last 1 Month MaxDemand is: TT=26.325kW 8-4 18:45 T1=26.325kW 8-2 18:45 T2=12.350kW 8-9 14:30 T3= 8.627kW 8-6 11:15 T4= 9.483kW 8-18 23:15
MDC | Clear all maximum demand and occurrence time | Frame sent | MDC [PIC]
Answer | Clear MaxDemand is ok
PAR | Read measure parameter | Read voltage | Frame sent | PAR [U]
Answer | Present voltage is: Ua=221.317V Ub=223.213V Uc=219.248V
Read current | Frame sent | PAR [I]
Answer | Present current is: Ia=4.0114A Ib=5.0125A Ic=4.5844A Ini=0.8289A Inm=0.9491A Inmi=0.1202A
Read active power | Frame sent | PAR [P]
Answer | Present active power is: Pt= 750.1W Pa= 250.2W Pb= 250.8W Pc= 249.1W
Read reactive power | Frame sent | PAR [Q]
Answer | Present reactive power is: Qt= 360.6Var Qa=120.2Var Qb=120.3 Var Qc=120.1Var
Read apparent power | Frame sent | PAR [S]
Answer | Present apparent power is: St=900.8VA Sa=300.1VA Sb=300.5VA Sc=300.2VA
Read voltage (Fundamental only) | Frame sent | PAR [UF]
Answer | Present voltage (fundamental) is: Ua=219.917V Ub=222.013V Uc=218.018V
Read current (Fundamental only) | Frame sent | PAR [IF]
Answer | Present current (fundamental) is: Ia=4.0001A Ib=4.9725A Ic=4.0024A Ini=0.6985A Inm=0.9336A Inmi=0.2351A
Read active energy (Fundamental only) | Frame sent | PAR [PF]
Answer | Present active power (fundamental) is: Pt= 744.1W Pa= 248.2W Pb= 248.8W Pc= 247.1W
Read reactive energy (Fundamental only) | Frame sent | PAR [QF]
Answer | Present reactive power (fundamental) is: Qt= 355.6Var Qa=118.2Var Qb=118.3 Var Qc=119.1Var
Read apparent energy (Fundamental only) | Frame sent | PAR [SF]
Answer | Present apparent power (fundamental) is: St=894.8VA Sa=299.1VA Sb=298.5VA Sc=297.2VA
Read frequency in dominant phase | Frame sent | PAR [F]
Answer | Present frequency is: Freq=50.01Hz
Read dominant frequency and frequency per phase | Frame sent | PAR [FT]
Answer | Dominant frequency is: Freq=50.01Hz FreqA=50.00Hz, FreqB=0.00Hz, FreqC=0.00Hz
Read angle | Frame sent | PAR [A]
Answer | Voltage and current angle is : Angle_A= 4.704 Angle_B= 160.699 Angle_C= 0.000 Angle_N= 0.000
PARC | Read per-cycle measure parameter | Same options as for PAR Command | Same as for PAR Command | Responses similar to PAR Command but adding the “per-cycle” indication
DCD | Load default metrology control register values | Frame sent | DCD
Answer | Load Default Is Ok !
DCS | Save metrology constants to non-volatile memory | Frame sent | DCS
Answer | Save Data Is Ok !
CAL | Automatic calibration | Single phase example | Frame sent | CAL (Ua=220.01,Ia=4.999,Aa=59.99)
Answer | Calibrating... Calibrating Done!
Poly phase example | Frame sent | CAL (Ua=220.01,Ia=4.999,Aa=59.99, Ub=220.01,Ib=4.999,Ab=59.99,Uc=220.01, Ic=4.999, Ac=59.99)
Answer | Calibrating... Calibrating Done!
DEV | Get the connected AFE and Channels configuration | Frame sent | DEV
Answer | AFE device: 1 ATSENSE301 (type 0) Channel X: Name GAIN SENSOR TYPE Channel 0: I_N GAIN_1 CT Channel 1: I_A GAIN_1 CT Channel 2: V_A GAIN_1 VRD Channel 3: I_B GAIN_1 CT Channel 4: V_B GAIN_1 VRD Channel 5: I_C GAIN_1 CT Channel 6: V_C GAIN_1 VRD
CAPT | Launch Wavefor Capture and check status | Enable on Channel 1, source: 16 kHz data before DSP filtering, type: One Shot, length: 256 samples | Frame sent | CAPT 1 1 0 0 256
Answer | Launched Waveform capture
Check Capture Status after launching it | Frame sent | CAPT
Answer | Waveform capture is COMPLETE
BUF | Read waveform capture data (if a parameter is used, only a 512 samples sector is returned) | Frame sent | BUF
Answer | Waveform Capture Data... FF89BEE4 A928D0C4 …

Rev: E