DEPFET Q2M1 Power Procedure

Description

This MR offers a validated power up and down procedure for the DSSC2 for a single module (Q2M1).

How Has This Been Tested?

The MPOD is powered through Karabo using the DETLAB_DSSC2/PSC/MPOD2, DETLAB_DSSC2/PSC/TAG_GROUP_Q2, and Manual Powering Instructions. Only a single module, M1 was powered up and down.

Shutdown order matters.

Validation of channel order done while powering up:

import requests
from time import monotonic                      
def power_all_on():                              
     tstart = monotonic()                         
     print(requests.get("http://192.168.140.67/power?group=AON&output=on"))  # Group does not exist, validate that error handled, expect HTTP 406                                   
     print(requests.get("http://192.168.140.67/power?group=ASICS&output=on"))                                 
     print(requests.get("http://192.168.140.67/power?group=HV&output=on"))                                    
     print(requests.get("http://192.168.140.67/power?group=ISVOLTAGE&output=on"))                             
     print(requests.get("http://192.168.140.67/power?group=PLCSOURCE&output=on"))                             
     print("Took ", monotonic() - tstart) 

Command used for triggering power down from microcontroller:

import requests
from time import monotonic
def off():
     tstart = monotonic()
     print(requests.get("http://192.168.140.67/alloff?token=CWH").json()['groups'])
     print("Took ", monotonic() - tstart)

Test Protocol:

• Power auto-on from Karabo, trigger complete shutdown from microcontroller: AON channels go down.
• Power auto-on, ASICs from Karabo, trigger complete shutdown from microcontroller: IOBA, IOB, RB, MBJT, AON channels go down.
• Power auto-on, ASICs, HV from Karabo, trigger complete shutdown from microcontroller: BACK, RING2, RING1, IS, IOBA, IOB, RB, MBJT, AON channels go down.
• Power all on: auto-on, ASICs, HV, PLC, SG from Karabo, trigger complete shutdown from microcontroller: SG, PLC, IS (set to 2.5v), BACK, RING2, RING1, IS (off), IOBA, IOB, RB, MBJT, AON channels go down.

TODOs:

• Implement voltage check on power up (is sense voltage == target voltage?):
  Not strictly needed as channel goes from RAMPING to ON when setting voltage, but would not hurt. A feature on its own, better handled in separate MR.
• Implement way to trigger power down from serial interface to testing purposes:
  Outside of scope of this MR. Will be done in subsequent MR.

powerproc.cpp

@@ -7,21 +7,35 @@ PowerProcedure::PowerProcedure(const IPAddress& ipAddr)
     stages = new Stage[stagesCount];
 
     stages[0].name = "ASICS";
+    stages[0].type = SWITCH;
     stages[0].size = 9;
     stages[0].channels = new int[stages[0].size]{508, 708, 502, 503, 504, 501, 507, 607, 608};
 
     stages[1].name = "HV";
+    stages[1].type = SWITCH;
     stages[1].size = 10;
     stages[1].channels = new int[stages[1].size]{1, 2, 101, 103, 102, 104, 105, 106, 107, 108};
 
-    stages[2].name = "PLCSOURCE";
-    stages[2].size = 9;
-    stages[2].channels = new int[stages[2].size]{701, 801, 802, 803, 804, 301, 302, 303, 304};
+    stages[2].name = "ISVOLTAGE";
+    stages[2].type = VOLTAGE;
+    stages[2].size = 2;
+    stages[2].channels = new int[stages[2].size]{1, 2};
+    stages[2].onValue = new float[stages[2].size]{10, 10};
+    stages[2].offValue = new float[stages[2].size]{2.5, 2.5};
+
+    stages[3].name = "PLCSOURCE";
+    stages[3].type = SWITCH;
+    stages[3].size = 9;
+    stages[3].channels = new int[stages[3].size]{701, 801, 802, 803, 804, 301, 302, 303, 304};
 }
 
 PowerProcedure::~PowerProcedure() {
     for (size_t stageIdx = 0; stageIdx < stagesCount; stageIdx++) {
         delete[] stages[stageIdx].channels;
+        if (stages[stageIdx].type == VOLTAGE) {
+            delete[] stages[stageIdx].onValue;
+            delete[] stages[stageIdx].offValue;
+        }
     }
     delete[] stages;
 }
@@ -33,6 +47,9 @@ String PowerProcedure::toJSON() {
 
     for (size_t stageIdx = 0; stageIdx < stagesCount; stageIdx++) {
         Stage* currentStage = &stages[stageIdx];
+        if (currentStage->type == VOLTAGE) {
+            continue;
+        }
 
         json += "{\"name\":\"" + currentStage->name + "\",";
         json += "\"channels\":[\n";
@@ -67,7 +84,12 @@ bool PowerProcedure::powerOn(const String& stage) {
         Stage* currentStage = &stages[stageIdx];
         if (currentStage->name == stage) {
             for (size_t chIdx = 0; chIdx < currentStage->size; chIdx++) {
-                setChannelAndWait(&ipAddr, currentStage->channels[chIdx], 1);  // 1 == ON
+                if (currentStage->type == SWITCH) {
+                    setChannelStateAndWait(&ipAddr, currentStage->channels[chIdx], 1);  // 1 == ON
+                } else if (currentStage->type == VOLTAGE) {
+                    setChannelVoltageAndWait(&ipAddr, currentStage->channels[chIdx],
+                                             currentStage->onValue[chIdx]);
+                }
             }
             return true;
         }
@@ -80,7 +102,12 @@ bool PowerProcedure::powerOff(const String& stage) {
         Stage* currentStage = &stages[stageIdx];
         if (currentStage->name == stage) {
             for (int chIdx = currentStage->size - 1; chIdx >= 0; chIdx--) {
-                setChannelAndWait(&ipAddr, currentStage->channels[chIdx], 0);  // 0 == OFF
+                if (currentStage->type == SWITCH) {
+                    setChannelStateAndWait(&ipAddr, currentStage->channels[chIdx], 0);  // 0 == OFF
+                } else if (currentStage->type == VOLTAGE) {
+                    setChannelVoltageAndWait(&ipAddr, currentStage->channels[chIdx],
+                                             currentStage->offValue[chIdx]);
+                }
             }
             return true;
         }