teletype

huge thanks to all the developers and contributors: 3-foot-1, a773, alanza, attowatt, Byzero, desolationjones, Dewb, eiginn, Lightbreaker, martica, scanner_darkly

---

new features

• drum ops [Byzero]
• support for multiple faderbanks [Lightbreaker]
• I2C2MIDI ops [attowatt / scanner_darkly]
• new disting ex ops: dual algorithms, EX.M.N#, EX.M.NO#, EX.M.CC# [scanner_darkly]
• new op CV.GET [scanner_darkly]
• new op: SCALE0 [scanner_darkly]
• new ops: $F, $F1, $F2, $L, $L1, $L2, $S, $S1, $S2, I1, I2, FR [scanner_darkly]
• improved TR.P accuracy [scanner_darkly]
• all line endings now accepted for USB files [scanner_darkly]
• basic menu for reading/writing scenes when a USB stick is inserted [Dewb]
• new ops: CV.CAL and CV.CAL.RESET to calibrate CV outputs [Dewb]
• new Disting EX ops: EX.CH, EX.#, EX.N#, EX.NO# [scanner_darkly]
• new dual W/ ops: W/.SEL, W/S.POLY, W/S.POLY.RESET, W/1, W/2 [scanner_darkly]

---

fixes

• PROB 100 would only execute 99.01% of the time [martica]
• cache currently-running commands to avoid corruption during SCENE ops [3-foot-1]
• fix off-by-one error in P.ROT [3-foot-1]
• fix CROW_Q3 operation [3-foot-1]
• fix bug when QT.B input was negative [desolationjones]
• fix bug with G.FDR not being rendered in grid visualizer properly [scanner_darkly]
• fix EX.LP not returning correct values [scanner_darkly]
• fix MIDI IN ops channel being off by 1 [scanner_darkly]
• fix STATE not taking into account the status of DEVICE.FLIP [scanner_darkly]
• fix BPM rounding error [scanner_darkly]
• reset M timer when changing metro rate [scanner_darkly]
• fix KILL not stopping TR pulses in progress [scanner_darkly]
• fix CV and TR outputs in inconsistent state after DEVICE.FLIP [Dewb]
• fix N.CS scales 7 & 8 being swapped; make them consistent with N.S and docs [Dewb]
• update libavr32: support CDC grid size detection (e.g. zero), increase HID message buffer [Dewb]
• update Disting EX looper ops to work with Disting EX firmware 1.23+ [scanner_darkly]

---

documentation

• remove duplicate Disting cheatsheet section [eiginn]
• improve page load time in Chrome/Safari [Dewb]
• fix docs on QT.BX [a773]
• fix function ops docs [alanza]

---

platform improvements

• create a simple Actions workflow for tests [Dewb]
• separate scene serialization logic from USB disk logic, add scene serialization tests [Dewb]
• build documentation PDF in Actions workflow [Dewb]
• suggest TinyTeX as docs-building toolchain [alanza]
• apply VCV Rack compatibility patches, so branches off main can be used in both hardware and software [Dewb]

---

firmware

installing this firmware will overwrite your existing scenes! back up your scenes using a USB flash drive and make sure to rename files before restoring. this is a beta version, after flashing you will be prompted to press the button to initialize teletype - make sure to do so. update procedure: http://monome.org/docs/modular/update

huge thanks to @scanner-darkly and everyone who contributed code and testing to this long-coming release.

v4.0.0

• FIX: LAST SCRIPT in live mode gives time since init script was run
• FIX: negative pattern values are properly read from USB
• FIX: delay when navigating to sections in docs
• NEW: generic i2c ops: IIA, IIS.., IIQ.., IIB..
• NEW: exponential delay operator DEL.G
• NEW: binary and hex format for numbers: B..., X...
• NEW: Disting EX ops
• FIX: LAST n is broken for script 1
• NEW: bitmasked delay and quantize: DEL.B.., QT.B.., QT.BX..
• NEW: scale and chord quantize: QT.S.., QT.CS..
• NEW: bit toggle OP: BTOG..
• NEW: volts to semitones helper OP: VN..
• IMP: DELAY_SIZE increased to 64 from 16
• FIX: scale degree arguments 1-indexed: N.S, N.CS
• NEW: Just Friends 4.0 OPs and dual JF OPs
• NEW: binary scale ops N.B and N.BX
• NEW: reverse binary for numbers: R...
• NEW: reverse binary OP: BREV
• NEW: ES.CV read earthsea CV values
• NEW: added setter for R, sets R.MIN and R.MAX to same value, allowing R to be used as variable
• NEW: v/oct to hz/v conversion op: HZ
• FIX: W/2.0 ops added
• NEW: W/2.0 ops documentation
• NEW: ><, <>, >=< and <=> OPs, checks if value is within or outside of range
• IMP: new powerful Q OPs
• IMP: Improved line editing movement (forward/backward by word skips intervening space).
• NEW: Delete to end of word command alt-d added.
• NEW: new op: SCENE.P
• NEW: new multi-logic OPs AND3, AND4, OR3 and OR4 with aliases &&&, &&&&, ||| and ||||
• NEW: alias: EV for EVERY
• NEW: live mode dashboard
• NEW: ops to control live mode: LIVE.OFF, LIVE.VARS, LIVE.GRID, LIVE.DASH, PRINT
• FIX: PN.ROT parameters are swapped
• FIX: better rendering for fine grid faders
• FIX: logical operators should treat all non zero values as true, not just positive values
• NEW: crow ops
• NEW: TI.PRM.CALIB alias added (was already in the docs)
• FIX: SCENE would crash if parameter was out of bounds

thanks to @csboling and @discohead!

• FIX: improve DAC latency when using CV ops
• NEW: call metro / init with SCRIPT 9 / SCRIPT 10
• NEW: forward (C-f or C-s) and reverse (C-r) search in help mode
• NEW: new ops: LROT (alias <<<), RROT (alias >>>)
• NEW: LSH and RSH shift the opposite direction when passed a negative shift amount
• NEW: new op: SGN (sign of argument)
• NEW: new kria remote op: KR.DUR
• NEW: new op: NR (binary math pattern generator)
• NEW: new ops: N.S, N.C, N.CS (use western scales and chords to get values from N table)
• NEW: new ops: FADER.SCALE, FADER.CAL.MIN, FADER.CAL.MAX, FADER.CAL.RESET for scaling 16n Faderbank values (aliases FB.S, FB.C.MIN, FB.C.MAX, FB.C.R)
• NEW: new Tracker mode keybinding alt-[ ] semitone up, down
• NEW: new Tracker mode keybinding ctrl-[ ] fifth up, down
• NEW: new Tracker mode keybinding shift-[ ] octave up, down
• NEW: new Tracker mode keybinding alt-<0-9> <0-9> semitones up (0=10, 1=11)
• NEW: new Tracker mode keybinding shift-alt-<0-9> <0-9> semitones down (0=10, 1=11)
• FIX: dim M in edit mode when metro inactive
• NEW: new pattern ops: P.SHUF, PN.SHUF, P.REV, PN.REV, P.ROT, PN.ROT
• NEW: new pattern mods: P.MAP:, PN.MAP x:

installing

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

update procedure at http://monome.org/docs/modular/update docs at https://monome.org/docs/teletype/

thanks to @csboling, @scanner-darkly, @alpha-cactus, @jlmitch5!

• NEW: new op: DEVICE.FLIP
• FIX: some keyboards losing keystrokes
• NEW: new op: DEL.X
• NEW: new op: DEL.R
• IMP: DELAY_SIZE increased to 16 from 8
• NEW: new variables: J & K local script variables
• FIX: metro rate not updated after INIT.SCENE
• NEW: new ops: SEED, R.SEED, TOSS.SEED, DRUNK.SEED, P.SEED, PROB.SEED
• NEW: new op: SCENE.G
• NEW: new op: SCRIPT.POL, alias $.POL
• NEW: new ansible remote ops: ANS.G, ANS.G.P, ANS.G.LED, ANS.A, ANS.A.LED
• NEW: new kria remote ops: KR.CUE, KR.PG

installing

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

update procedure at http://monome.org/docs/modular/update docs at https://monome.org/docs/teletype/

full release thread

massive thanks to @scanner-darkly for leading this huge update.

new

• grid integration
• er-301 support *
• faderbank support *
• matrixarchate support
• new TELEX ops: TO.CV.CALIB, TO.CV.RESET, TO.ENV *
• new pattern ops: P.MIN, PN.MIN. P.MAX. PN.MAX *
• $ alias for SCRIPT
• ternary if op ?
• multi line selection / copying (with Shift-arrows)
• Alt-<delete> delete selected lines
• Alt-<up> / Alt-<down> move selected lines up/down
• Ctrl-<right> / Ctrl-<left> move cursor by words
• Alt-H shortcut for help (in addition to Alt-?)
• I is initialized from the calling script (done by @burnsauce )
• new kria ops (done by @AaronMeyers )
• 3 level undo in script editing (CTRL-Z)
• RND / RRND aliases for RAND / RRAND
• WRP alias for WRAP
• SCL alias for SCALE
• new ops: P.RND / PN.RND - get a random value between start/end
• new ops: P.+ / PN.+ / P.- / PN.- increment/decrement pattern value by amount
• new ops: P.+W / PN.+W / P.-W / PN.-W as above and wrap
• W/ support (done by @trentgill )
• * are done by @bpcmusic

fixes

• documentation on LSH and RSH
• PN.HERE not updating tracker view
• @simondemeule's fix for JI op
• i2c initialization delayed to avoid crashes when connected to er-301
• duplicate commands don't get added to history in live editing
• last screen is saved to flash
• knob jitter in scene loading/saving fixed
• TIME and LAST are now 1ms accurate
• RAND / RRAND will properly work with large range values
• P.RM was 1-based, now 0-based
• P.RM / PN.RM will not change pattern length if deleting outside of length range
• L .. 32767 will properly work instead of freezing
• P.POP \ PN.POP will update the tracker screen
• PARAM set properly when used in the init script
• PARAM and IN won't reset to 0 after INIT.DATA
• SCALE precision improved

installing

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

update procedure at http://monome.org/docs/modular/update docs at https://monome.org/docs/modular/teletype/manual

another fantastic update by @sliderule

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

• update procedure at http://monome.org/docs/modular/update
• docs at https://monome.org/docs/modular/teletype/manual

v2.2

see the full release thread

• NEW: added a cheat sheet PDF
• NEW: new bitwise ops: &, |, ^, ~, BSET, BCLR, BGET
• NEW: new ops PARAM.SCALE min max and IN.SCALE min max to add static scaling to inputs
• NEW: blanking screensaver after 90 minutes of keyboard inactivity, any key to wake
• NEW: new op: CHAOS chaotic sequence generator. Control with CHAOS.ALG and CHAOS.R
• NEW: new op family: INIT, to clear device state
• NEW: new ops: R, R.MIN, R.MAX programmable RNG
• IMP: profiling code (optional, dev feature)
• IMP: screen now redraws only lines that have changed
• FIX: multiply now saturates at limits, previous behaviour returned 0 at overflow
• FIX: entered values now saturate at int16 limits
• FIX: reduced flash memory consumption by not storing TEMP script
• FIX: I now carries across DEL commands
• FIX: removed TEMP script allocation in flash
• FIX: corrected functionality of JI op for 1volt/octave tuning and removed octave-wrapping behaviour (now returns exactly the entered ratio)
• FIX: reduced latency of IN op

huge thanks to @sliderule for this update.

docs and default presets included in the release.

see http://monome.org/docs/modular/update for update procedure!

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

v2.1

see the full release thread

• BREAKING: the I variable is now scoped to the L loop, and does not exist outside of an execution context. Scripts using I as a general-purpose variable will be broken.
• FIX: SCENE will not run from INIT script during scene load.
• NEW: Tracker data entry overhaul. Type numbers, press enter to commit.
• NEW: new op: BPM to get milliseconds per beat in given BPM
• NEW: script lines can be disabled / enabled with ctrl-/
• NEW: shift-enter in scene write mode now inserts a line
• NEW: new ops: LAST x for the last time script x was called
• NEW: SCRIPT with no arguments gets the current script number.
• FIX: AVG and Q.AVG now round up properly
• NEW: new op: BREAK to stop the remainder of the script
• NEW: new mod: W [condition]: [statement] will execute statement as long as condition is true (up to an iteration limit).
• NEW: new mods: EVERY x:, SKIP x:, OTHER: to alternately execute or not execute a command.
• NEW: new op: SYNC x will synchronize all EVERY and SKIP line to the same step.
• NEW: new feature: @ - the turtle. Walks around the pattern grid. Many ops, see documentation.
• OLD: ctrl-F1 to F8 mute/unmute scripts.
• NEW: ctrl-F9 enables/disables METRO.
• FIX: recursive delay fix. Now you can 1: DEL 500: SCRIPT 1 for temporal recursion.
• FIX: KILL now clears TR output as well as disabling the METRO script.
• FIX: if / else conditions no longer transcend their script
• IMP: functional execution stack for SCRIPT operations

see the 2.0.0 thread for major release updates.

2.0.1 updates libavr32 (thanks to @scanner-darkly ) which corrects some screen draw glitches.

docs and default presets included in the release.

see http://monome.org/docs/modular/update for update procedure!

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

See the release thread for more info.

Changes since 1.4.0:

• Sub commands
• Aliases
• PN versions of every P op
• Telex ops
• (breaking) removing the II op, e.g. II MP.PRESET 1 will become just MP.PRESET 1
• (breaking) merge MUTE and UNMUTE ops to MUTE x / MUTE x y
• (breaking): remove unused Meadowphysics ops: MP.SYNC, MP.MUTE, MP.UNMUTE, MP.FREEZE, MP.UNFREEZE
• (breaking): rename Ansible Meadowphysics ops to start with ME
• Using the F1 - F10 keys to trigger scripts. Also alt+Fkey to jump to editing the relevant script
• NUM LOCK to jump to the pattern editor
• PRINT SCREEN to jump to live mode
• No more leading space before : and ;
• Emacs/Unix style keyboard short cuts (ctrl-E, ctrl-A, etc), delete forward with DELETE, enable HOME and END keys
• Limited script recursion (max recursion depth is 8) including self recursion.
• Using a USB stick at any time (not just boot up)
• Metro scripts limited to 25ms, but new M! op to set it as low as 2ms (at your own risk)

Plus more changes under the hood.

PDF documentation included in the zip file.

• ii control for ansible MIDI mode, see http://monome.org/docs/modular/ansible

see http://monome.org/docs/modular/update for update procedure!

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

• ii communication fix

see http://monome.org/docs/modular/update for update procedure!

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

big thanks for @scanner-darkly and @kisielk and @ngwese on this one!

• ii commands for ansible grid and arc modes

see http://monome.org/docs/modular/update for update procedure!

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Includes default scenes.

• fix ansible ii communication
• other small bugfixes

see http://monome.org/docs/modular/update for update procedure!

ansible support!

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Default scenes not included in this intermediary release.

intermediary fixes, added ER op.

CAUTION: Installing this firmware will overwrite your existing scenes. Back up your scenes using a USB flash drive. Default scenes not included in this intermediary release.

see http://monome.org/docs/modular/teletype addendum for new feature guide.

CAUTION your scenes will be erased on update. if you type out your scenes first into a text editor, you'll be able to re-import them via usb flash drive.

UPDATE INSTRUCTIONS: http://monome.org/docs/modular/update

CHANGELOG:

NEW usb flash drive read/write NEW SCRIPT OP for scripted execution of other scripts! NEW ORCA II control NEW MUTE and UNMUTE OPS for disabling trigger input NEW hotkeys for MUTE toggle per input (meta-shift-number) NEW screen indication in live mode for MUTE status NEW SCALE OP for scaling number from one range to another NEW JI OP just intonation helper NEW STATE OP to read current state of input triggers 1-8 (low/high = 0/1) NEW keypad executes scripts (works for standalone usb keypads and full-sized keyboards) NEW KILL OP clears delays, stack, cv slews, pulses NEW hotkey meta+ESC executes KILL NEW ABS OP absolute value, single argument NEW FLIP OP variable which changes state (0/1) on each read NEW LOGIC OPS: AND, OR, XOR NEW O OPS: O.MIN, O.MAX, O.WRAP, O.DIR for counter range control NEW DRUNK OPS: DRUNK.MIN, DRUNK.MAX, DRUNK.WRAP for range control NEW TR.POL specifies the polarity of TR.PULSE NEW if powered down in tracker mode, will power up in tracker mode IMP TR.PULSE retrigger behavior now predictable IMP mode switch keys more consistent (not contanstly resetting to live mode) FIX bug in command history in live mode FIX EXP OP now exists FIX P and PN parse error FIX possible crash on excess length line entry FIX CV wrapping with negative CV.OFF values FIX INIT script executed now on keyboardless scene recall FIX Q.AVG overflow no more FIX P.PUSH will fully fill a pattern FIX CV.SET followed by slewed CV in one command works FIX DEL 0 no longer voids command