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.

mpod.cpp

@@ -35,7 +35,7 @@ SNMP::Message *MPOD::read(uint16_t channel) {
 }
 
 // Create an SNMP SETREQUEST message to switch on or off the specified channel
-SNMP::Message *MPOD::output(const uint16_t channel, const bool on) {
+SNMP::Message *MPOD::setChannelState(const uint16_t channel, const bool on) {
     SNMP::Message *message = new SNMP::Message(SNMP::Version::V2C, "guru", SNMP::Type::SetRequest);
     // In SETREQUEST, use node type and set the value.
     // OUTPUT SWITCH, integer type, 0 is OFF and 1 is ON.
@@ -45,6 +45,17 @@ SNMP::Message *MPOD::output(const uint16_t channel, const bool on) {
     return message;
 }
 
+// Create an SNMP SETREQUEST message to set the channel voltage
+SNMP::Message *MPOD::setTargetVoltage(const uint16_t channel, const float targetVoltage) {
+    SNMP::Message *message = new SNMP::Message(SNMP::Version::V2C, "guru", SNMP::Type::SetRequest);
+    // In SETREQUEST, use node type and set the value.
+    // OUTPUT VOLTAGE, float type.
+    String snmp_cmd = OID::NAMES[OID::OUTPUTVOLTAGE];
+    snmp_cmd += channel;
+    message->add(snmp_cmd.c_str(), new OpaqueBER(new OpaqueFloatBER(targetVoltage)));
+    return message;
+}
+
 // Parse incoming message
 bool MPOD::message(const SNMP::Message *message) {
     unsigned int found = 0;
@@ -194,9 +205,9 @@ void initializeSNMP() {
 /* setChannelAndWait
  * Set a channel's parameters and wait until it's settled.
  */
-void setChannelAndWait(const IPAddress *ipAddr, const uint16_t channel, const uint8_t output) {
+void setChannelStateAndWait(const IPAddress *ipAddr, const uint16_t channel, const uint8_t output) {
     // Send set command
-    SNMP::Message *snmp_msg = mpod.output(channel, output);
+    SNMP::Message *snmp_msg = mpod.setChannelState(channel, output);
     snmp.send(snmp_msg, *ipAddr, SNMP::Port::SNMP);
     delete snmp_msg;
 
@@ -213,3 +224,26 @@ void setChannelAndWait(const IPAddress *ipAddr, const uint16_t channel, const ui
         snmp.loop();
     } while (mpod.isOn() != (bool)output || mpod.isRampingDown() || mpod.isRampingUp());
 }
+
+void setChannelVoltageAndWait(const IPAddress *ipAddr, const uint16_t channel,
+                              const float targetVoltage) {
+    // Send set command
+    SNMP::Message *snmp_msg = mpod.setTargetVoltage(channel, targetVoltage);
+
+    snmp.send(snmp_msg, *ipAddr, SNMP::Port::SNMP);
+    delete snmp_msg;
+
+    // wait for channel reply
+    delay(MPOD_UPDATE_LATENCY);
+    snmp.loop();
+
+    // Poll channel until it's settled
+    do {
+        SNMP::Message *snmp_msg = mpod.read(channel);
+        snmp.send(snmp_msg, *ipAddr, SNMP::Port::SNMP);
+        delete snmp_msg;
+        delay(MPOD_UPDATE_LATENCY);
+        snmp.loop();
+    } while (mpod.isRampingDown() ||
+             mpod.isRampingUp());  // TODO check applied voltage close to target voltage
+}