Differences

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

--- commands:here [2019/06/28 20:30] – vik
+++ commands:here [2026/09/01 15:42] (current) – add firmware requirements for clocked devices change position brandon
@@ Line 1: / Line 1: @@
 ====== Command:HERE (H) ======
-Here command has a slightly different usage on a TGPMT card , then on all our systems.
+The 'here' command differs on a TGPMT card from our other systems.
---> Actuators , Piezos, MicroMirror etc#
+--> Actuators, Piezos, MicroMirror etc ^
+--> MS2000 or RM2000 syntax ^
+The HERE command sets the current reported position(s) of the axis(es) provided.
---> MS2000 or RM2000 syntax#
 ^Shortcut  |H   |
@@ Line 14: / Line 16: @@
 <--
---> Tiger syntax#
+--> Tiger syntax ^
 ^Shortcut  |H   |
-^Format  |HERE [axis]=[position in 1/10 microns]… |
+^Format  |HERE [axis]=[position in 1/10 microns] or see below for clocked devices|
 ^Units    |1/10 microns|
 ^Type    |Axis-Specific  |
@@ Line 24: / Line 26: @@
 <--
-Assign the specified number to the axis’s current position buffer.  If no position is specified, 0 is assumed.  The unit of measurement is in tenths of microns.  This defines the current position to be a specific distance from the origin (0), i.e., the origin may change.
+Assign the specified number to the axis’s current position buffer. If no position is specified, 0 is assumed. For non-clocked devices, the unit of measurement is in tenths of microns.  This defines the current position to be a specific distance from the origin (0).
+**Clocked Devices:**
-On clocked devices (filter slider, turret etc) use the <wrap cmd> + </wrap> (plus) operator to sets the spacing of the nth position. Example, On a 2 position objective slider, if the user wants to adjust the spacing of the 2nd objective so that it's better aligned to the optical path, they can adjust 2nd objectives position with a manual input device, then save it by issuing serial command <wrap cmd> H [Axis char]+ </wrap>. Only available on MS2000 version 9.2m and above, TG1000 version 3.28 and above.
+On clocked devices (filter slider, turret, mirrored port switch, etc), you can //change position #1// or you can //change the spacing between positions//.\\ \\
+Change position #1: <wrap lo>MS-2000 v9.2l or Tiger v3.18 required</wrap>
+  - Remove all axes from either the joystick or a knob (for example, the Z-axis from the Z-knob <wrap cmd> J Z=0</wrap>).
+  - Assign the clocked device axis to that joystick or knob (for example, the M-axis to the Z-knob <wrap cmd> J M=22</wrap>).
+  - Use the joystick or knob to adjust the axis to the desired position.
+  - Issue the ''HERE'' command to set the position (for example, the M-axis <wrap cmd> H M=1</wrap>).
+  - Restore (assign and unassign) the desired axes to the joystick / knobs as desired (for example, the M-axis from and the Z-axis to the Z-knob <wrap cmd> J M=0 Z=22</wrap>). \\ \\
+Change the spacing between positions: <wrap lo>MS-2000 v9.2m or Tiger v3.28 required</wrap>\\
+  - Move to position #2 (for example, the M-axis <wrap cmd> M M=2</wrap>).
+  - Remove all axes from either the joystick or a knob (for example, the Z-axis from the Z-knob <wrap cmd> J Z=0</wrap>).
+  - Assign the clocked device axis to that joystick or knob (for example, the M-axis to the Z-knob <wrap cmd> J M=22</wrap>).
+  - Use the joystick or knob to adjust the axis to the desired position.
+  - Issue the ''HERE'' command to set the spacing (for example, the M-axis <wrap cmd> H M+</wrap>).
+  - Restore (assign and unassign) the desired axes to the joystick / knobs as desired (for example, the M-axis from and the Z-axis to the Z-knob <wrap cmd> J M=0 Z=22</wrap>).
+\\
 If there are no errors, the positive reply <wrap reply> :A </wrap> will be sent back from the controller
 <WRAP center round important 60%>
-DOES NOT WORK FOR PIEZOS AND MICROMIRRORS. <del> DOES NOT WORK FOR “CLOCKED DEVICES” SUCH AS FILTER SLIDERS AND TURRETS.</del>
+**Warning!** DOES NOT WORK FOR PIEZOS AND MICROMIRRORS.
 </WRAP>
@@ Line 45: / Line 63: @@
---> TGPMT usage#
+--> TGPMT usage ^
 ^Shortcut  |H   |
@@ Line 52: / Line 70: @@
 ^Remembered |Automatically |
-On a TGPMT card , this command this used to Zero the PMT signal reported by the [[commands:rdadc|RDADC command]]. When this command is issue , the current PMT signal is saved , and the controller begins subtracting it from the current PMT signal. Users can use this as a background subtract or offset feature.
+On a TGPMT card, this command this used to Zero the PMT signal reported by the [[commands:rdadc|RDADC command]]. When this command is issue, the current PMT signal is saved, and the controller begins subtracting it from the current PMT signal. Users can use this as a background subtract or offset feature.
-User can cancel the zeroing by issuing ''HERE [axis]=0'' . Readings reported by [[commands:rdadc|RDADC command]] will not be altered anymore.
+User can cancel the zeroing by issuing ''HERE [axis]=0''. Readings reported by [[commands:rdadc|RDADC command]] will not be altered anymore.
 Only the readings reported by the [[commands:rdadc|RDADC command]] are altered. 0-4V Analog PMT signal on the BNC connector is not altered.
-This is a card wide-settings , both PMT0 and PMT1's reading are altered.
+This is a card wide-settings, both PMT0 and PMT1's reading are altered.
 More details [[:tgpmt#adc_specification|here]].
@@ Line 64: / Line 82: @@
 __//Example//__
-<asi> $ h m
+<asi> $ H M
 :A</asi>
-If the TGPMT card axis char is **m**. Saves the current PMTs readings and starts subtracting them from RDADC commands reported readings.
+If the TGPMT card axis char is **M**. Saves the current PMTs readings and starts subtracting them from the ''RDADC'' commands reported readings.
-<asi> $ h m=0
+<asi> $ H M=0
 :A</asi>
-If the TGPMT card axis char is **m**. Clears the saved PMTs readings and stops subtracting them from RDADC commands reported readings.
+If the TGPMT card axis char is **M**. Clears the saved PMTs readings and stops subtracting them from the ''RDADC'' commands reported readings.
@@ Line 79: / Line 97: @@
-{{tag>commands tiger ms2000 tgpmt}}
+{{tag>tgpmt commands tiger ms2000}}

Address: 29391 W Enid Rd. Eugene, OR 97402, USA | Phone: +1 (541) 461-8181