Applied Scientific Instrumentation

User Tools

Site Tools

Trace:
commands:ttl

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
commands:ttl [2025/05/19 15:38] – add separators brandoncommands:ttl [2026/06/19 19:35] (current) – add space to bottom of page brandon
Line 3: Line 3:
 TTL functionality differs based on whether the controller is a Tiger (TG-1000) or MS2000/RM2000 controller, due to hardware differences. Some TTL modes are only available with certain firmware modules. TTL functionality differs based on whether the controller is a Tiger (TG-1000) or MS2000/RM2000 controller, due to hardware differences. Some TTL modes are only available with certain firmware modules.
  
-The Tiger (TG-1000) and MS2000 controller electronics have a buffered TTL input (''IN0'') and output (''OUT0'') port that are usually connected to the IN and OUT BNC connectors on the back of the controller. These ports allow voltages in the range of 0V to 5V as an input, where any voltage below 0.95v(+-0.3v) is a LOGIC LOW signal. Any signal above 1.6 V (+-0.3 V) is considered a LOGIC HIGH state. Any signals in between 0.95 to 1.6 V will maintain the same logic state that was registered from the last //known// state (Schmitt Triggered inputs). The TTL input has a 10K Ohm resistor to ground, and connecting to the input of a Schmitt Trigger 5W TTL gate. The output is CMOS-compatible 5v TTL directly from a single CMOS gate. The behavior of these connectors are determined by the ''IN0_mode'' and ''OUT0_mode'' parameters set by the ''TTL X'' and ''TTL Y'' commands respectively. There are also has several unbuffered I/O ports on the motherboard that are occasionally exposed for special purposes.+The Tiger (TG-1000) and MS2000 controller electronics have a buffered TTL input (''IN0'') and output (''OUT0'') port that are usually connected to the IN and OUT BNC connectors on the back of the controller. These ports allow voltages in the range of 0V to 5V as an input, where any voltage below 0.95v(+-0.3v) is a LOGIC LOW signal. Any signal above 1.6 V (+-0.3 V) is considered a LOGIC HIGH state. Any signals in between 0.95 to 1.6 V will maintain the same logic state that was registered from the last //known// state (Schmitt Triggered inputs). The TTL input has a 10K Ohm resistor to ground, and connecting to the input of a Schmitt Trigger 5v TTL gate. The output is CMOS-compatible 5v TTL directly from a single CMOS gate. The behavior of these connectors are determined by the ''IN0_mode'' and ''OUT0_mode'' parameters set by the ''TTL X'' and ''TTL Y'' commands respectively. There are also has several unbuffered I/O ports on the motherboard that are occasionally exposed for special purposes.
  
 <WRAP center round important 60%> <WRAP center round important 60%>
Line 43: Line 43:
 ---- ----
  
-**1** - TTL IN0 initiates a Move-to-Next-Position of the stored positions in the ring buffer pointed to by the buffer_pointer.  When the buffer_pointer reaches a value equal to the number of saved positions, it resets to the first position, allowing cyclic repetitions to the saved locations.  See [[commands:rbmode|RBMODE]]  and [[commands:load|LOAD]] commands.+**1** - TTL IN0 initiates a Move-to-Next-Position of the stored positions in the ring buffer pointed to by the ''buffer_pointer''.  When the ''buffer_pointer'' reaches a value equal to the number of saved positions, it resets to the first position, allowing cyclic repetitions to the saved locations.  See [[commands:rbmode|RBMODE]]  and [[commands:load|LOAD]] commands.
  
 ---- ----
Line 57: Line 57:
 ---- ----
  
-**4** - Enables TTL IN0 controlled Z-stacks (see the [[commands:zs|ZS command]]). When this command is first received by the controller, the ZS command state machine is reset.+**4** - Enables TTL IN0 controlled Z-stacks (see the [[commands:zs|ZS command]]).
  
 ---- ----
Line 73: Line 73:
 ---- ----
  
-<wrap lo>MS-2000 v9.54 required</wrap> \\ +<wrap lo>MS-2000 v9.54 or Tiger v3.54 required</wrap> \\ 
-**8** - TTL commanded [[commands:array|ARRAY]] move to next position, that does a Z-stack at each array position (see the [[commands:zs|ZS command]]). When this command is first received by the controller, the ZS command state machine is reset.+**8** - TTL commanded [[commands:array|ARRAY]] move to next position, that does a Z-stack at each array position (see the [[commands:zs|ZS command]]).
  
 ---- ----
  
-**9** - Used with CRISP focus lock.  TTL IN0 HIGH engages lock if the system is in the READY state.  TTL IN0 LOW will cause the system to UNLOCK is locked already.+**9** - Used with [[:crisp_manual|CRISP]] focus lock.  TTL IN0 HIGH engages lock if the system is in the READY state.  TTL IN0 LOW will cause the system to UNLOCK if it is locked already.
  
 ---- ----
Line 157: Line 157:
 ---- ----
  
-**3** - <del>output TTL OUT0 gated HIGH during axis index 0 (X) constant speed move</del> **not implemented but hardware-level TTL signal is available**.+**3** - <del>output TTL OUT0 gated HIGH during axis index 0 (X) constant speed move</del> **not implemented but ''[[../synchronized_zaxis_focus_sweeps|hardware-level TTL signal]]'' is available**.
  
 ---- ----
  
-**4** - <del>output TTL OUT0 gated HIGH during axis index 1 (Y) constant speed move</del>**not implemented but hardware-level TTL signal is available**.+**4** - <del>output TTL OUT0 gated HIGH during axis index 1 (Y) constant speed move</del> **not implemented but ''[[../synchronized_zaxis_focus_sweeps|hardware-level TTL signal]]'' is available**.
  
 ---- ----
  
-**5** - <del>output TTL OUT0 gated HIGH during axis index 2 (Z) constant speed move</del>**not implemented but hardware-level TTL signal is available**.+**5** - <del>output TTL OUT0 gated HIGH during axis index 2 (Z) constant speed move</del> **not implemented but ''[[../synchronized_zaxis_focus_sweeps|hardware-level TTL signal]]'' is available**.
  
 ---- ----
Line 198: Line 198:
  
 <wrap lo>Tiger v3.17 required</wrap>\\ <wrap lo>Tiger v3.17 required</wrap>\\
-**22** - In this mode, TTL OUT0 is controlled by [[:singleaxis|Single-axis function]] module. With the [[commands:sap|SAP]] command the user can generate a TTL pulse that is synchronized with [[:singleaxis|Single-axis function]] actuator motion. The pulse duration is set with command [[commands:rtime|RT Y]].+**22** - In this mode, TTL OUT0 is controlled by the [[:singleaxis|single-axis function]] module. With the [[commands:sap|SAP]] command the user can generate a TTL pulse that is synchronized with [[:singleaxis|single-axis function]] actuator motion. The pulse duration is set with command [[commands:rtime|RT Y]].
  
 ---- ----
Line 256: Line 256:
 ===== Report Mode (MS-2000 Only) ===== ===== Report Mode (MS-2000 Only) =====
  
-__//report_mode//__ - This mode requires the ''TTL_OUT_REPORT'' firmware module.+__//report_mode//__ - This mode requires the ''TTL_OUT_REPORT'' firmware module.  
 +<wrap lo>MS-2000 v9.52 required</wrap>.
  
 **T** - Enables serial reporting on every output TTL pulse when set to be non-zero.  Will output on separate serial port if enabled with compile-time flag. **T** - Enables serial reporting on every output TTL pulse when set to be non-zero.  Will output on separate serial port if enabled with compile-time flag.
Line 267: Line 268:
   * X array index as 16-bit unsigned int (AIJ X? equivalent)   * X array index as 16-bit unsigned int (AIJ X? equivalent)
   * Y array index as 16-bit unsigned int (AIJ Y? equivalent)   * Y array index as 16-bit unsigned int (AIJ Y? equivalent)
 +
 +\\
 +The next value is the Z-stack index (ZS T? equivalent, related to the ZS command)
  
 Next the encoder value for all axes in order as 32-bit signed integer in twos-complement, 4 bytes per axis (can be converted to reported position using multiplier) Next the encoder value for all axes in order as 32-bit signed integer in twos-complement, 4 bytes per axis (can be converted to reported position using multiplier)
Line 284: Line 288:
   * To validate the checksum repeat the same steps but include the 16-bit checksum value in the running sum. The computed checksum should be 0000.  If not there was an error in checksum generation or transmission of the data.   * To validate the checksum repeat the same steps but include the 16-bit checksum value in the running sum. The computed checksum should be 0000.  If not there was an error in checksum generation or transmission of the data.
    
-Example: firmware includes ''ARRAY_MODULE'', ''CRISP'' and has X Y and Z axes.  TTL Y=2 sets a TTL pulse at the end of the move.  TTL T=51 sets this report format.  The report will be a string of numbers like this (spaces for readability only)+Example: firmware includes ''ARRAY_MODULE'', ''CRISP'' and has X Y and Z axes.  ''TTL Y=2'' sets a TTL pulse at the end of the move.  ''TTL T=51'' sets this report format.  The report will be a string of numbers like this (spaces for readability only)
  
-0002 0001 0003 1E00 FFFF FFFF FFFF FFEE FC81 0679 0D DF0F 0D+''0002 0001 0003 1E00 FFFF FFFF FFFF FFEE FC81 0679 0D DF0F 0D''
  
 where coordinate is (2,1) in the array, the X encoder value is 3268608 in decimal (corresponding to almost exactly 9mm position with 2 TPI rotary stage), Y encoder value is -1 in decimal, Z encoder value is -18 in decimal, CRISP error value is -895 in decimal, CRISP sum value is 1657 decimal, and the checksum is hex DF0F.  To validate the checksum add each of these 16-bit unsigned numbers (excluding the 0D delimeters) which results in 5FFFA in hex.  FFFA plus 5 is FFFF, and upon bitwise inversion the value becomes 0 as expected. where coordinate is (2,1) in the array, the X encoder value is 3268608 in decimal (corresponding to almost exactly 9mm position with 2 TPI rotary stage), Y encoder value is -1 in decimal, Z encoder value is -18 in decimal, CRISP error value is -895 in decimal, CRISP sum value is 1657 decimal, and the checksum is hex DF0F.  To validate the checksum add each of these 16-bit unsigned numbers (excluding the 0D delimeters) which results in 5FFFA in hex.  FFFA plus 5 is FFFF, and upon bitwise inversion the value becomes 0 as expected.
Line 299: Line 303:
  
 For MS2000/RM2000, the controller replies with the inverse polarity, <wrap reply> :A 1 </wrap> when the signal is low and <wrap reply> :A 0 </wrap> when the signal is high.  This is a logical bug in the firmware, but because it was in the field so long before being noticed we made the intentional decision to keep the behavior unchanged. For MS2000/RM2000, the controller replies with the inverse polarity, <wrap reply> :A 1 </wrap> when the signal is low and <wrap reply> :A 0 </wrap> when the signal is high.  This is a logical bug in the firmware, but because it was in the field so long before being noticed we made the intentional decision to keep the behavior unchanged.
 +\\
  
 {{tag>commands led tiger ms2000 tgled crisp ttl spim array servolock_ttl}} {{tag>commands led tiger ms2000 tgled crisp ttl spim array servolock_ttl}}
Address: 29391 W Enid Rd. Eugene, OR 97402, USA | Phone: +1 (541) 461-8181
commands/ttl.1747683518.txt.gz · Last modified: by brandon