added apl tests

.gitignore

@@ -4,7 +4,7 @@ docs/_build/*
 forge_modules/
 *.idea
 exodriver-master
-master.zip
+master.zip*
 *#
 vagrant/.vagrant
 *.log

cleanup.sh

@@ -24,6 +24,7 @@ rm -rf /root/puppet
 rm -rf /root/.joule
 rm -rf ~/.joule
 
-echo "Remember to remove ubuntu user and /home/ubuntu!"
-echo "Also check if any user with uid of 999 exists"
+echo "If any user shows up below delete with deluser command:"
+cat /etc/passwd | grep 999
+echo "From cubic remove the ubuntu user with [deluser --remove-home ubuntu]"
 history -c

tests/apl_nilm_testing/README

+1.) Run setup script. This creates the joule and lumen user accounts
+    and loads the meters.yml script into /opt/configs
+
+$> sudo ./setup.sh
+
+2.) Flash microcontrollers using bank#.bin files. Do this by only
+    connecting the bank1 device and run:
+    
+    $> dmesg 
+    .... other output ...
+    [ 4216.087922] usb 1-7: New USB device found, idVendor=03eb, idProduct=6124, bcdDevice= 1.10
+    [ 4216.087931] usb 1-7: New USB device strings: Mfr=0, Product=0, SerialNumber=0
+    [ 4216.089682] cdc_acm 1-7:1.0: ttyACM0: USB ACM device
+
+    The last line shows the serial device, replace the ttyACM# in the
+    command below with this value (eg ttyACM0). If the command fails,
+    wait a bit and try again or remove the USB cable and plug it back
+    in.
+    
+    $> sudo ./bossac -e -w -v -b bank1.bin -p /dev/ttyACM#
+
+    If the programming is successful you should see output similar to:
+    
+       Erase flash
+
+       Done in 1.285 seconds
+       Write 61960 bytes to flash (122 pages)
+       [==============================] 100% (122/122 pages)
+       Done in 0.864 seconds
+       Verify 61960 bytes of flash
+       [==============================] 100% (122/122 pages)
+       Verify successful
+       Done in 0.729 seconds
+       Set boot flash true
+
+    Then connect bank2 and run dmesg again to find its port and flash it with
+
+    $> sudo ./bossac -e -w -v -b bank2.bin -p /dev/ttyACM#
+
+3.) Disconnect both devices (remove USB cables) and reconnect
+    them. This will reboot the devices so they run the new
+    firmware. They should be recognized as NILM devices and listed in
+    /dev/nilm:
+
+    $> ls /dev/nilm
+    meter1000-ctrl  meter1000-data
+    meter2000-ctrl  meter2000-data
+
+4.) View sensors using nilm-scope. Connect sensors to the bank1 and
+    run the following command (omit channels as appropriate):
+
+    $> nilm scope meter1 -c 0 1 2 3 4 5 6 7
+
+    To test bank2 just change meter1 to meter2.
+
+5.) Verify voltage sensor selector switch on the PCB, this alternates
+    between ch7 on the bank port and the LEM voltage. The LEM voltage
+    should be very high (clipped on the waveform viewer)
+    
+    Recommended testing with a triac dimmed resistive load (eg
+    incandescent lightbulb). Current should be chopped and voltage
+    should be complete waveform with ripples depending on the harmonic
+    content of the utility.
\ No newline at end of file

tests/apl_nilm_testing/meters.yml

+meter1:
+  type: noncontact
+  path: /meters/bank1                # database location for meter streams
+  enabled: false                      # set to false to disable this meter
+  serial_number: meter1000           # found on the meter case
+  phases: 2                          # 1 - 3
+  sensors:
+    voltage:
+      sensor_index: 0               # electric field sensor
+      digitally_integrate: true     # if true, integrate using FIR filter
+      nominal_rms_voltage: 120      # used to scale the electric field
+    current:                        # --uncomment a line below, or customize--
+      sensor_indices: [1,3,5,7]     # D-Board with 4 A-Boards
+  calibration:
+    duration: 9                    # length of calibration in seconds
+    on_duration: 1
+    off_duration: 2
+    watts: 200                      # power consumed by calibration load
+    has_neutral: true               # [false] if the system has no neutral bus
+  streams:
+     sinefit:
+       decimate: true                # if [false] only the base stream will be saved
+       keep: 1m                      # how much data to keep as [amount][units]
+     iv:                             #     h: hours, d: days, w: weeks,
+       decimate: true                #     m: months, y: years
+       keep: 1w                      # if [false] no data will be saved
+     prep:
+       decimate: true
+       keep: 3w
+       nshift: 1
+       goertzel: false
+     sensor:
+       keep: false
+
+meter2:
+  type: noncontact
+  path: /meters/bank2                # database location for meter streams
+  enabled: false                      # set to false to disable this meter
+  serial_number: meter2000           # found on the meter case
+  phases: 2                          # 1 - 3
+  sensors:
+    voltage:
+      sensor_index: 0               # electric field sensor
+      digitally_integrate: true     # if true, integrate using FIR filter
+      nominal_rms_voltage: 120      # used to scale the electric field
+    current:                        # --uncomment a line below, or customize--
+      sensor_indices: [1,3,5,7]     # D-Board with 4 A-Boards
+  calibration:
+    duration: 9                    # length of calibration in seconds
+    on_duration: 1
+    off_duration: 2
+    watts: 200                      # power consumed by calibration load
+    has_neutral: true               # [false] if the system has no neutral bus
+  streams:
+     sinefit:
+       decimate: true                # if [false] only the base stream will be saved
+       keep: 1m                      # how much data to keep as [amount][units]
+     iv:                             #     h: hours, d: days, w: weeks,
+       decimate: true                #     m: months, y: years
+       keep: 1w                      # if [false] no data will be saved
+     prep:
+       decimate: true
+       keep: 3w
+       nshift: 1
+       goertzel: false
+     sensor:
+       keep: false

tests/apl_nilm_testing/setup.sh

+#!/bin/bash
+
+
+export LC_ALL=C.UTF-8
+export LANG=C.UTF-8
+
+joule admin authorize
+joule master add lumen 127.0.0.1
+
+cat meters.yml > /opt/configs/meters.yml