Operating instructions - arup-group/pqm-hellebores GitHub Wiki

⚠ Safety instructions

Hazardous voltage is present inside including the measurement PCB. Operate only with cover closed.
Maximum continuous load is 650W (230V). IEC inlet assembly is fused with 3.15A slow blow HRC fuse. Do not replace with a higher rating.
The IEC power connection is subject to pull-out forces so check the fitment. If there is any loose movement at all, you must not use the equipment until this is rectified with compressible adhesive strip at the fixing surfaces.
The power switch does not isolate the load and in fact the switch contact is bridged with an RC snubber for EMI control: loads must therefore be physically disconnected to isolate.
This research device must be used only by instructed people in a controlled setting. It is NOT suitable for site or field use.
Allow air movement around the device, so that heat can dissipate.

Starting and stopping

Connect input and output IEC leads and apply power. The switch on the box controls output power to the load. After the Raspberry Pi has booted, a launcher should appear on the screen from where you can start the application. Alternatively, find the software under the 'Other' menu category.

Shut down the Raspberry Pi from within the application ('Options') menu, the launcher or the Raspberry Pi menu. To avoid SD card corruption, wait for the green LED to stop flashing on the rear of the Raspberry Pi, approximately 5 seconds after the screen goes dark. Switch off the power at the socket outlet.

Operating modes

Waveform mode

The machine will start in a waveform capture and display mode. You can display up to four different time-correlated waveforms: voltage, current, power and earth leakage current. The selection of waveforms and the vertical and horizontal scales are available on the 'Horizontal' and 'Vertical' controls.

If you want to freeze the image on the display, use the 'Start/Stop' button.

To change the waveform alignment/trigger point, use the 'Trigger' button. You can also disable the trigger entirely by selecting 'Free run'.

Multimeter mode

Use the 'mode' button to switch to multimeter mode. The software will analyse a 2 second buffer of sample readings and update the display every 1 second.

Measurements include: RMS voltage, RMS current and RMS earth leakage current, instantaneous power, VAR and VA, power factor, crest factor, total harmonic distortion (V and I), cumulative Wh, VARh and VAh. The multimeter also tracks maximum and minimum extrema of several measurements.

The hardware has two current ranges, 'low' and 'full' range. A warning indication will show on the display if you are in low range. The low range will provide enhanced resolution at very low levels of load, which can be useful for quiescent/standby power measurements. However if instantaneous current exceeds 0.2A then the ADC channel and protection circuit is liable to saturate. The 'full' range should therefore be used for the majority of measurements.

Multimeter calculations including cumulative measurements continue regardless of the display mode, to allow long term measurements to be made while using other functions. Cumulative measurements and max/min extrema can be cleared using the 'Reset' button.

Harmonic voltage mode

Individual harmonic voltages are displayed from h0 (DC) through to h50. The software will analyse a 1 second buffer of sample readings and update the display every 1 second.

Harmonic magnitudes are displayed as a dimensionless percentage of the RMS voltage of the system. In the internal FFT analysis, harmonic frequency bins are approximately 1 Hz wide. The appropriate bin for each harmonic frequency is determined dynamically based on the measured fundamental frequency of the system.

Harmonic current mode

Individual harmonic currents are displayed from h0 (DC) through to h50.

As per harmonic voltage display, the harmonic current magnitudes are displayed as a dimensionless percentage of the RMS current of the load, and the FFT bin selection is automatic.

Measurement logging

Measurements of selected multimeter readings are automatically cached in a .csv file whenever the instrument software is running. The filename includes a number based on the process ID (PID) of the CSV generating program.

The measurement log file is stored in RAMdisk and is not preserved during power down or through a re-boot.

Measurement entries do include a timestamp for each row. However, the timestamp correctness depends on the device being network connected and able to access a NTP server to set the clock.

New readings are appended at an interval of 1 second.

Measurement accuracy can be affected by the interactive selection of 'full range' or 'low range' current measurement modes. For the majority of logging use-cases, make sure you are in full range mode, to avoid saturation.

If the device is on wifi and you know the IP address, you can retrieve the measurement log file(s) into a command shell as follows (scp is available on Windows, Mac, Linux, WSL):

scp [email protected]:/run/shm/pqm-hellebores/*csv .

Your computer has to be on the same wifi network as the power quality monitor. Alternatively transfer the file via Bluetooth file transfer.

Remote access

You can connect remotely to a shell on the machine using SSH.

ssh [email protected]

You'll need to know the IP address of the device and password.

You can also view the display remotely using VNC. Again, you'll need to know the IP address and password to make a connection. For best performance (ie frame rate), try setting picture quality to 'medium' and encryption to 'prefer off'.