Aligned APSPU/ASPCTTR.yaml with interface L2-11434/10774

pypcc/config/APSCTTR.yaml

@@ -138,6 +138,7 @@ variables:
     dim: 1
 
   - name: LMP_ID
+    description: Midplane ID (updated on startup or any method call)
     driver: LMP_GPIO
     devreg:  ROM.ID #this is ignored
     width: 6
@@ -162,7 +163,7 @@ variables:
     dtype: string
 
   - name: APSCT_PCB_number
-    description: PCB number (astron.nl/webforms/IenS-Boarden/view.php?id=xxx)
+    description: PCB number
     driver: I2C_CLK
     devreg:  ROM.Serial
     width: 0x100  #32 characters
@@ -171,7 +172,7 @@ variables:
 
 
   - name: [APSCT_PWR_PLL_200MHz_on,APSCT_PWR_PLL_160MHz_on]
-    description: CLK power status. Controlled by APSCT_xxxMHz_ON and APSCT_OFF
+    description: Clock power status. Controlled by APSCT_xxxMHz_ON and APSCT_OFF
     rw:  ro
     dtype: boolean
     driver: I2C_CLK
@@ -180,7 +181,7 @@ variables:
     width: 1
 
   - name: APSCT_PWR_on
-    description: CLK power status. Controlled by APSCT_xxxMHz_ON and APSCT_OFF
+    description: APSCT power status. Controlled by APSCT_xxxMHz_ON and APSCT_OFF
     rw:  ro
     dtype: boolean
     driver: I2C_CLK
@@ -197,6 +198,7 @@ variables:
     width: 1
 
   - name: [APSCT_INPUT_10MHz_good,APSCT_INPUT_PPS_good]
+    description: 10MHz/PPS signal detected on APSCT input (from CCD)
     rw:  ro
     dtype: boolean
     driver: I2C_CLK
@@ -207,7 +209,7 @@ variables:
 
 
   - name: [APSCT_PLL_200MHz_locked,APSCT_PLL_160MHz_locked]
-#    description: First status pin give lock status
+    description: Indicate current status of clock
     rw:  ro
     dtype: boolean
     monitor: true
@@ -217,7 +219,7 @@ variables:
     width: 1
 
   - name: [APSCT_PLL_200MHz_error,APSCT_PLL_160MHz_error]
-#    description: Second status pin give error
+    description: Indicate current status of clock
     rw:  ro
     dtype: boolean
     monitor: true
@@ -227,6 +229,7 @@ variables:
     width: 1
 
   - name: APSCT_PLL_200MHz_lol
+    description: Indicate if a loss-of-lock occured. Cleared by calling APSCT_200MHz_on or toggeling ASCT_PLL_clr_lol
     rw:  ro
     dtype: boolean
 #    convert_unit: bool_invert
@@ -237,6 +240,7 @@ variables:
     width: 1
 
   - name: APSCT_PLL_160MHz_lol
+    description: Indicate if a loss-of-lock occured. Cleared by calling APSCT_160MHz_on or toggeling ASCT_PLL_clr_lol
     rw:  ro
     dtype: boolean
 #    convert_unit: bool_invert
@@ -247,6 +251,7 @@ variables:
     width: 1
 
   - name: APSCT_PLL_clr_lol
+    description: Clear APSCT_PLL_xxxMHz_lol when toggeled high,low.
     rw:  rw
     dtype: boolean
 #    monitor: true
@@ -309,6 +314,7 @@ variables:
     monitor: true
 
   - name: [APSCT_PWR_INPUT_3V3,APSCT_PWR_PLL_160MHz_3V3,APSCT_PWR_PLL_200MHz_3V3,APSCT_PWR_CLKDIST1_3V3,APSCT_PWR_CLKDIST2_3V3,APSCT_PWR_PPSDIST_3V3,APSCT_PWR_CTRL_3V3]
+    description: Internal voltage (V)
     driver: I2C_CLK
     devreg:  [VSENSE.V_0,VSENSE.V_1,VSENSE.V_2,VSENSE.V_3,VSENSE.V_4,VSENSE.V_5,VSENSE.V_6]
     width: 23

pypcc/config/APSPUTR.yaml

@@ -103,7 +103,7 @@ variables:
     dtype: string
 
   - name: APSPU_PCB_number
-    description: PCB number (astron.nl/webforms/IenS-Boarden/view.php?id=xxx)
+    description: PCB number
     driver: I2C_PU
     devreg:  ROM.Serial
     width: 0x100  #32 characters
@@ -111,6 +111,7 @@ variables:
     dtype: string
 
   - name: [APSPU_LBA_VOUT,APSPU_RCU2A_VOUT,APSPU_RCU2D_VOUT]
+    description: Output voltage (V)
     driver: I2C_PU
     devreg:  [POL_LBA.VOUT,POL_RCU2A.VOUT,POL_RCU2D.VOUT]
     width: 16
@@ -121,6 +122,7 @@ variables:
     monitor: true
 
   - name: [APSPU_LBA_IOUT,APSPU_RCU2A_IOUT,APSPU_RCU2D_IOUT]
+    description: Output current (A)
     driver: I2C_PU
     devreg:  [POL_LBA.IOUT,POL_RCU2A.IOUT,POL_RCU2D.IOUT]
     width: 16
@@ -130,6 +132,7 @@ variables:
     monitor: true
 
   - name: [APSPU_LBA_TEMP,APSPU_RCU2A_TEMP,APSPU_RCU2D_TEMP]
+    description: DC-DC converter temperature (Celsius)
     driver: I2C_PU
     devreg:  [POL_LBA.TEMP,POL_RCU2A.TEMP,POL_RCU2D.TEMP]
     width: 16
@@ -139,6 +142,7 @@ variables:
     monitor: true
 
   - name: [APSPU_FAN1_RPM,APSPU_FAN2_RPM,APSPU_FAN3_RPM]
+    description: FAN speed in RPM.
     driver: I2C_PU
     devreg:  [MAX.TACH1,MAX.TACH2,MAX.TACH3]
 #    bitoffset: 5
@@ -161,7 +165,7 @@ methods:
       - APSPU_FAN_monitor_on : 0
 
   - name: APSPU_FAN_monitor_on
-    description: Setup the FAN monitor to give RPM
+    description: Setup the FAN monitor. Called automatically on power-on.
     driver: I2C_PU
     instructions:   
       - MAX.GLOBAL : 0x02 #Run monitor