Ansible + Teletype
The Ansible and Teletype Eurorack modules can be connected via pin headers on the back of these modules, making remote control of Ansible possible from Teletype scripts.
Teletype firmware 1.3 or newer is required for Ansible support.
With no USB device plugged in Ansible continues to run the most recently used application. For example, Kria can continue playing.
By hitting the preset key (next to the USB port) with no device plugged, Ansible will toggle into Teletype mode. In this mode the Ansible’s outputs and inputs function as an extender, fitting naturally into the Teletype system.
This requires the Ansible to be on the internal ii bus, a 6 conductor ribbon behind the panel. Be sure to align the red stripe when connecting. For more information about different modules that can be connected to the ii bus and how this works, see here.
The following is a quick reference of Teletype ops that Ansible can process. For more details see the Teletype manual.
sections
Output
By default Ansible’s 4 TR outputs and 4 CV outputs are mapped as TR 5-8 and CV 5-8. All Teletype output commands are available:
TR 5 1 // set Ansible TR 1 to 1
TR 5 // read Ansible TR 1
TR.TOG 6 // toggle Ansible TR 2
TR.POL 7 0 // reverse polarity for Ansible TR 3 pulse
TR.TIME 7 250 // set Ansible TR 3 pulse time to 250 ms
TR.PULSE 7 // pulse Ansible TR 3
TR.TIME 7 // read Ansible TR 3 pulse time
CV.SLEW 5 100 // set Ansible CV 1 slew to 100 ms
CV 5 V 10 // set Ansible CV 1 to 10 volts
CV 5 // read Ansible CV 1
CV.SET 5 0 // set Ansible CV 1 to 0, no slew
CV.SLEW 5 // read Ansible CV 1 slew
CV.OFF 6 V 1 // set Ansible CV 2 offset to 1 volt
CV.OFF 6 // read Ansible CV 2 offset
Input
Ansible’s In 1, In 2, Key 1, and Key 2 are mapped to STATE 9-12 respectively.
STATE 9 // read Ansible In 1
STATE 10 // read Ansible In 2
STATE 11 // read Ansible Key 1
STATE 12 // read Ansible Key 1
II Address for Multiple Ansible
If using more than one Ansible connected to Teletype, the II address can be set by holding the preset key in combination with Key 1 and Key 2. There is no visual confirmation, simply hold the combination for 2 seconds. The set address is saved to flash and will persist with power cycling.
The address is according to the following:
Address Key 1 Key 2
0 off off
1 on off
2 off on
3 on on
Mappings for input and output are shifted for each address:
Address Out In
0 5-8 9-12
1 9-12 13-16
2 13-16 17-20
3 17-20 21-24
Parameter control via Teletype
Teletype can control various parameters for Kria, Meadowphysics, Levels, and Cycles.
Individually addressing multiple Ansible by assigning each a unique II address is only applicable to the Output and Input commands listed above. The parameter commands listed in this section cannot be used to control multiple Ansibles in the same way – these commands use only one address and are not currently extensible. For example, if you have two Ansibles on your i2c bus (Address 0 and Address 1) and they’re both running Kria, KR.CLK 7 will not clock the third Kria track on the second Ansible – but if those two Ansibles are each set to Address 0, KR.CLK 1 will clock the first Kria track on each.
Kria
Kria’s tracks can be clocked individually by the KR.CLK op, this must be enabled using the toggles on the far top-left column of Kria’s scale page.
KR.PRE x read preset x
KR.PRE return current preset number
KR.PERIOD x set internal clock period to x
KR.PERIOD return current internal clock period
KR.PAT x set pattern to x
KR.PAT return current pattern
KR.SCALE x set scale to x
KR.SCALE return current scale
KR.POS x y z set position to z for track x parameter y
a value of 0 for x means all tracks
a value of 0 for y means all parameters
parameters:
0 - all
1 - trigger
2 - note
3 - octave
4 - duration
5 - trigger ratcheting
6 - alternate note
7 - glide
KR.POS x y return position of track x parameter y
KR.L.ST x y z set loop start to z for track x parameter y
KR.L.ST x y return loop start of track x parameter y
KR.L.LEN x y z set length to z for track x parameter y
KR.L.LEN x y return loop length of track x parameter y
KR.RES x y set position to loop start for track x parameter y
KR.CV x current CV value of output x
KR.MUTE x y set the mute of track x to y (where y=1 is muted, y=0 is not.)
if x is 0, set all mutes to state y
KR.TMUTE x toggle mute for Kria track x (0 = all)
toggle will _invert current state_.
KR.CLK x send to clock track x (0 == all) IF track is enabled to be clocked
by Teletype (see above)
KR.DIR x y set track direction
KR.DIR x get track direction
KR.DUR x get track duration
KR.CUE p cue pattern p to play next
KR.PG p show kria UI page p
Meadowphysics
ME.PRE x read preset x
ME.PRE return current preset number
ME.SCALE x set scale to x
ME.SCALE return current scale
ME.PERIOD x set internal clock period to x
ME.PERIOD return current internal clock period
ME.OFF x stop channel x (0 = all)
ME.RES x reset channel x (0 = all) (also used as "start")
ME.CV x get current CV value of output x
Earthsea
ES.PRESET x select preset
ES.MODE x select edge mode
0 - drone
1…15 - fixed (value specifies trigger length)
-1 - recorded timing
(NB: this is different to original Earthsea)
ES.CLOCK x clock. (you probably want to insert a dummy cable into
the clock input to stop the internal clock)
ES.RESET x reset to position x
ES.PATTERN x select pattern x
ES.TRANS x transpose by specified number of semitones (can be negative)
ES.STOP x stop playback/recording
ES.MAGIC x runes:
1 - half speed
2 - double speed
3 - linearize on
4 - linearize off
5 - set forward dir
6 - set reverse dir
Levels
LV.PRE x read preset x
LV.PRE return current preset number
LV.RES x reset. x = 0 for soft reset (will reset on next ext clock), 1 for hard reset
LV.POS x set current position
LV.POS return current position
LV.L.ST x set loop start
LV.L.ST return current loop start
LV.L.LEN x set loop length
LV.L.LEN return current loop length
LV.L.DIR x set loop direction
LV.L.DIR return current loop direction
Cycles
CY.PRE x read preset x
CY.PRE return current preset number
CY.RES x reset channel x (0 = all)
CY.POS x y set position of channel x to y (scaled 0-255) (x = 0 means all)
CY.POS x return position of channel x (scaled 0-255)
CY.REV x reverse direction of channel x (0 = all)
MIDI
Supported as of Teletype firmware 1.4 and Ansible firmware 1.4.
MID.SLEW t set pitch slew time in ms (applies to all allocation styles expect FIXED)
MID.SHIFT o shift pitch cv by standard tt pitch value (e.g. N 6, V -1, etc)
ARP.HLD h 0 disables key hold mode, other values enable
ARP.STY y set base arp style [0-7] (see above for style list)
ARP.GT v g set voice gate length [0-127], scaled/synced to course divisions of voice clock
ARP.SLEW v t set voice slew time in ms
ARP.RPT v n s set voice pattern repeat, n times [0-8], shifted by s semitones [-24, 24]
ARP.DIV v d set voice clock divisor (euclidean length), range [1-32]
ARP.FIL v f set voice euclidean fill, use 1 for straight clock division, range [1-32]
ARP.ROT v r set voice euclidean rotation, range [-32, 32]
ARP.ER v f d r set all euclidean rhythm
ARP.RES v reset voice clock/pattern on next base clock tick
ARP.SHIFT v o shift voice cv by standard tt pitch value (e.g. N 6, V -1, etc)
General
These ops affect Ansible regardless of what app is running.
ANS.G x y z simulate setting the state of grid button (x, y) to z (1 = held, 0 = off)
ANS.G.P x y simulate pressing grid button (x, y)
ANS.G.LED x y read the brightness of grid LED (x, y), 0-15
ANS.A n d simulate turning arc encoder n by d ticks (+/-)
ANS.A.LED n x read arc encoder n, LED x (0-63 clockwise)
ANS.APP x get/set the currently running app