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 … | |||