User Tools

Site Tools


slice:dcc:api

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
slice:dcc:api [2023/11/30 21:29] – external edit 127.0.0.1slice:dcc:api [2023/12/06 20:35] (current) Christiana Sasser
Line 46: Line 46:
 ---- ----
 ====Firmware Version==== ====Firmware Version====
-<function=ICEfunc?0=#VERSION&1=:None;&2=1.62&-1>+<function=ICEfunc?0=#VERSION&1=:None;&2=1.62&-1>
 Returns firmware version of System Controller. Returns firmware version of System Controller.
 +/*Note: For the Return Question mark, we had to use a slightly different question mark image. This one: ?. Rather than this one: ?. */
 ---- ----
 ====Reset to Factory Default Settings==== ====Reset to Factory Default Settings====
Line 57: Line 58:
 ---- ----
 <function=ICEfunc?0=SAVE&1=:None;&2=SUCCESS&-1> <function=ICEfunc?0=SAVE&1=:None;&2=SUCCESS&-1>
-Saves "Personality Board" settings into EEPROM.  Unsaved changes will be lost if board is powered off without issuing a SAVE command. The SAVE command saves the entire configuration into non-volatile memory. A single SAVE command can be issued after any number of configuration changes. When changes are made to the SLICE configuration through the touch screen, the new values are automatically saved and it is not necessary to issue a SAVE command.\\ \\+Saves "Personality Board" settings into EEPROM.  Unsaved changes will be lost if the board is powered off without issuing a SAVE command. The SAVE command saves the entire configuration into non-volatile memory. A single SAVE command can be issued after any number of configuration changes. When changes are made to the SLICE configuration through the touch screen, the new values are automatically saved and it is not necessary to issue a SAVE command.\\ \\
 __Slot Number__\\ __Slot Number__\\
   * 1 = first slot   * 1 = first slot
Line 74: Line 75:
  
 ---- ----
-<function=ICEfunc?0=CONTROL?&1=I:CHANNEL:1&2=0&-1>+<function=ICEfunc?0=CONTROL?&1=I:CHANNEL:1&2=0&-1>
 Returns the current operating mode for channel CHANNEL. In the example, the status of channel 1 is reported to be Constant Current mode, current off.\\ \\ Returns the current operating mode for channel CHANNEL. In the example, the status of channel 1 is reported to be Constant Current mode, current off.\\ \\
 __Channel input range__\\ __Channel input range__\\
Line 94: Line 95:
 3 = Constant Power mode, ON\\ 3 = Constant Power mode, ON\\
 ---- ----
-<function=ICEfunc?0=CURRSET?&1=I:CHANNEL:1&2=0.422800&-1>+<function=ICEfunc?0=CURRSET?&1=I:CHANNEL:1&2=0.422800&-1>
 Returns the operating current set point in Amps for channel CHANNEL. In the example, channel 1 current is set to 0.422800 A.\\ \\  Returns the operating current set point in Amps for channel CHANNEL. In the example, channel 1 current is set to 0.422800 A.\\ \\ 
 __CHANNEL input range__\\ __CHANNEL input range__\\
Line 112: Line 113:
 </WRAP> </WRAP>
 ---- ----
-<function=ICEfunc?0=MAXCURR?&1=I:CHANNEL:2&2=1.435300&-1>+<function=ICEfunc?0=MAXCURR?&1=I:CHANNEL:2&2=1.435300&-1>
 Returns user-set maximum current in Amps for channel CHANNEL. In the example, the maximum current supplied by channel 2 has been set to 1.435300 A.\\ \\ Returns user-set maximum current in Amps for channel CHANNEL. In the example, the maximum current supplied by channel 2 has been set to 1.435300 A.\\ \\
 __Input range__\\ __Input range__\\
Line 127: Line 128:
 Requested current maximum in Amps or closest value as bounded by unit capacity.\\ Requested current maximum in Amps or closest value as bounded by unit capacity.\\
 ---- ----
-<function=ICEfunc?0=CURRENT?&1=I:CHANNEL:1&2=271.8&-1>+<function=ICEfunc?0=CURRENT?&1=I:CHANNEL:1&2=271.8&-1>
 Returns measured current in milliamps for channel CHANNEL. In the example, the measured current of channel 1 is 100//e// mA.((CURRENT? may be < CURRSET if, for instance, the load has higher impedance than can be driven by the SLICE-DCC.))\\ \\ Returns measured current in milliamps for channel CHANNEL. In the example, the measured current of channel 1 is 100//e// mA.((CURRENT? may be < CURRSET if, for instance, the load has higher impedance than can be driven by the SLICE-DCC.))\\ \\
 __Input range__\\ __Input range__\\
Line 134: Line 135:
 Measured current being delivered by channel CHANNEL in milliamps\\ Measured current being delivered by channel CHANNEL in milliamps\\
 ---- ----
-<function=ICEfunc?0=PWRSET?&1=I:CHANNEL:1&2=314.0&-1>+<function=ICEfunc?0=PWRSET?&1=I:CHANNEL:1&2=314.0&-1>
 Returns the Constant Power Mode power set point for channel CHANNEL. In the example, the power set point of channel 1 is 314.0 mW.\\ \\ Returns the Constant Power Mode power set point for channel CHANNEL. In the example, the power set point of channel 1 is 314.0 mW.\\ \\
 __Input range__\\ __Input range__\\
Line 147: Line 148:
 Requested power set point or closest value as bounded by unit capacity.\\ Requested power set point or closest value as bounded by unit capacity.\\
 ---- ----
-<function=ICEfunc?0=POWER?&1=I:CHANNEL:1&2=314.0&-1>+<function=ICEfunc?0=POWER?&1=I:CHANNEL:1&2=314.0&-1>
 Returns the measured power for channel CHANNEL in milliwatts. In the example, the power measured at channel 1 is 314.0 mW.\\ \\ Returns the measured power for channel CHANNEL in milliwatts. In the example, the power measured at channel 1 is 314.0 mW.\\ \\
 __Input range__\\ __Input range__\\
 CHANNEL: {1,2}\\ CHANNEL: {1,2}\\
 ---- ----
-<function=ICEfunc?0=CVOLT?&1=I:CHANNEL:1&2=3.345&-1>+<function=ICEfunc?0=CVOLT?&1=I:CHANNEL:1&2=3.345&-1>
 Returns the measured compliance voltage across channel CHANNEL in volts. In the example, the voltage drop across channel 1 is 3.345 V.\\ \\ Returns the measured compliance voltage across channel CHANNEL in volts. In the example, the voltage drop across channel 1 is 3.345 V.\\ \\
 __Input range__\\ __Input range__\\
 CHANNEL: {1,2}\\ CHANNEL: {1,2}\\
 ---- ----
-<function=ICEfunc?0=GAIN?&1=I:CHANNEL:1&2=30.000000&-1>+<function=ICEfunc?0=GAIN?&1=I:CHANNEL:1&2=30.000000&-1>
 Returns the Integral Gain of the Constant Power feedback loop for channel CHANNEL in dB. In the example, the Gain for Constant Power mode feedback for channel 1 is +30.000 000 dB. The default value of the Gain is +30.000 000 dB.\\ \\ Returns the Integral Gain of the Constant Power feedback loop for channel CHANNEL in dB. In the example, the Gain for Constant Power mode feedback for channel 1 is +30.000 000 dB. The default value of the Gain is +30.000 000 dB.\\ \\
 __Input range__\\ __Input range__\\
Line 168: Line 169:
 GAIN: (-100 to +100)\\ GAIN: (-100 to +100)\\
 ---- ----
-<function=ICEfunc?0=RESPVTY?&1=I:CHANNEL:1&2=0.0035&-1>+<function=ICEfunc?0=RESPVTY?&1=I:CHANNEL:1&2=0.0035&-1>
 Returns the Constant Power mode external (customer-supplied) detector responsivity in Amps per Watt for channel CHANNEL. In the example, the responsivity of the detector for channel 1 is 0.0035 A/W.\\ \\ Returns the Constant Power mode external (customer-supplied) detector responsivity in Amps per Watt for channel CHANNEL. In the example, the responsivity of the detector for channel 1 is 0.0035 A/W.\\ \\
 __Input range__\\ __Input range__\\
Line 179: Line 180:
 RESPONSIVITY: (TBD)\\ RESPONSIVITY: (TBD)\\
 ---- ----
-<function=ICEfunc?0=POL?&1=I:CHANNEL:1&2=OFF&-1>+<function=ICEfunc?0=POL?&1=I:CHANNEL:1&2=OFF&-1>
 Returns the Constant Power mode Optical Power polarity setting of the input transimpedance amplifier for channel CHANNEL. In the example, the optical power polarity for the channel 1 transimpedance amplifier is positive (default).\\ \\ Returns the Constant Power mode Optical Power polarity setting of the input transimpedance amplifier for channel CHANNEL. In the example, the optical power polarity for the channel 1 transimpedance amplifier is positive (default).\\ \\
 __Input range__\\ __Input range__\\
Line 196: Line 197:
 1 = Negative = ON 1 = Negative = ON
 ---- ----
-<function=ICEfunc?0=INTERLK?&1=:None&2=ON&-1>+<function=ICEfunc?0=INTERLK?&1=:None&2=ON&-1>
 Returns the status of the interlock. In the example, the interlock is closed and the system is operational.\\ \\ Returns the status of the interlock. In the example, the interlock is closed and the system is operational.\\ \\
 __Possible Responses__\\ __Possible Responses__\\
Line 202: Line 203:
 OFF = Interlock circuit is open and the unit is disabled\\ OFF = Interlock circuit is open and the unit is disabled\\
 ---- ----
-<function=ICEfunc?0=AMODSEL?&1=I:CHANNEL:1&2=1&-1>+<function=ICEfunc?0=AMODSEL?&1=I:CHANNEL:1&2=1&-1>
 Returns the analog modulation source for channel CHANNEL. In the example, the modulation source for channel 1 is the front-panel input (labeled A).\\ \\ Returns the analog modulation source for channel CHANNEL. In the example, the modulation source for channel 1 is the front-panel input (labeled A).\\ \\
 __Return Values__\\ __Return Values__\\
Line 228: Line 229:
  
 ---- ----
-<function=ICEfunc?0=AOUTSEL?&1=I:CHANNEL:1&2=1&-1>+<function=ICEfunc?0=AOUTSEL?&1=I:CHANNEL:1&2=1&-1>
 Returns the location to which the measured power of the monitor photodiode is delivered for channel CHANNEL <color red>TRANSFER FUNCTION?</color>. In the example, the measured power of the monitor photodiode for channel 1 is delivered to the front-panel output (output 1).\\ \\ Returns the location to which the measured power of the monitor photodiode is delivered for channel CHANNEL <color red>TRANSFER FUNCTION?</color>. In the example, the measured power of the monitor photodiode for channel 1 is delivered to the front-panel output (output 1).\\ \\
 __Return Values__\\ __Return Values__\\
Line 252: Line 253:
  
 ---- ----
-<function=ICEfunc?0=TRIGIN?&1=I:CHANNEL:1&2=1&-1>+<function=ICEfunc?0=TRIGIN?&1=I:CHANNEL:1&2=1&-1>
 Returns the effect of the input trigger on channel CHANNEL. In the example, the input trigger controls the operation of channel 1.\\ \\ Returns the effect of the input trigger on channel CHANNEL. In the example, the input trigger controls the operation of channel 1.\\ \\
 __Return Values__\\ __Return Values__\\
Line 276: Line 277:
  
 ---- ----
-<function=ICEfunc?0=TRIGOUT?&1=I:CHANNEL:1&2=1&-1>+<function=ICEfunc?0=TRIGOUT?&1=I:CHANNEL:1&2=1&-1>
 Returns the response of the output trigger to the status of the interlock. In the example, the output trigger will echo the interlock circuit status.\\ \\ Returns the response of the output trigger to the status of the interlock. In the example, the output trigger will echo the interlock circuit status.\\ \\
 __Input parameter ranges__\\ __Input parameter ranges__\\
Line 298: Line 299:
  
 ---- ----
-<function=ICEfunc?0=HWTEMP?&1=I:CHANNEL:1&2=43.358&-1>+<function=ICEfunc?0=HWTEMP?&1=I:CHANNEL:1&2=43.358&-1>
 Returns the temperature of the SLICE-DCC "personality board" at the sensor point for channel CHANNEL. In the example, the temperature at the sensor point for channel 1 is 43.358°C.\\ \\ Returns the temperature of the SLICE-DCC "personality board" at the sensor point for channel CHANNEL. In the example, the temperature at the sensor point for channel 1 is 43.358°C.\\ \\
 __Input parameter ranges__\\ __Input parameter ranges__\\
 CHANNEL: {1,2}\\ CHANNEL: {1,2}\\
 ---- ----
-<function=ICEfunc?0=PWRMAX?&1=:None&2=41.5&-1>+<function=ICEfunc?0=PWRMAX?&1=:None&2=41.5&-1>
 Returns the maximum power (in Watts) available as configured. In the example, the power available is 41.5 W.\\ \\ Returns the maximum power (in Watts) available as configured. In the example, the power available is 41.5 W.\\ \\
 __Input parameter ranges__\\ __Input parameter ranges__\\
Line 312: Line 313:
 ===== Error Handling ===== ===== Error Handling =====
 ---- ----
-<function=ICEfunc?0=ERROR?&1=I:CHANNEL:2&2=49152&-1>+<function=ICEfunc?0=ERROR?&1=I:CHANNEL:2&2=49152&-1>
 Returns the error code for channel CHANNEL. In the example, the error code for channel 2 is 49152 (No errors).\\ \\ Returns the error code for channel CHANNEL. In the example, the error code for channel 2 is 49152 (No errors).\\ \\
 __Possible Responses__\\ __Possible Responses__\\
slice/dcc/api.txt · Last modified: 2023/12/06 20:35 by Christiana Sasser