monome / crow

This update primarily adds support for new ii devices: W/2 (wtape, wdel, wsyn), Disting EX (disting), and multiple crows (crow). Full docs are forthcoming, but for now you can inquire on-device by sending ii.<device>.help() (eg. ii.wtape.help() to see the full supported API for that device.

crow to crow communication

Communication from crow to crow enables:

• expanded I/O capabilities: ii.crow.volts(...), ii.crow.slew(...) and ii.crow.input(...)
• high-level I/O helpers: ii.crow.pulse(...), ii.crow.ar(...), ii.crow.lfo(...)
• generic commands: ii.crow.call1(...), ii.crow.call2(...), ii.crow.call3(...), ii.crow.call4(...)
• generic requests: ii.crow.query0(), ii.crow.query1(...), ii.crow.query2(...), ii.crow.query3(...)

The I/O commands above are handled automatically, so the second crow doesn't need a script running at all. You can also send ii.crow.reset() to make sure the second crow isn't running First or some other uploaded script.

Using the ii.crow.input(ch) query, will respond with the event ii.crow.event( event ) as is customary for ii devices.

When the above I/O behaviours aren't sufficient for your uses, you can use the generic commands & requests. These require you to upload a script onto the second crow that handles the generic events. Do so by re-defining the functions:

ii.self.call(...) -- where ... are the received arguments (not a table)
ii.self.query(...) -- this function should return the value to be sent back over ii

This feature is marked as 'Early Access' as the command list may change somewhat after we receive more feedback of it in use. Everything works as described, but we welcome your feedback if you can improve things.

For those using crow with norns, you'll need the (TBD) release or later to take advantage of the new ii features.

Log

• NEW ii support for W/2.0 firmware
• NEW [Early Access] ii support for Disting EX
• NEW [Early Access] ii support for crow to crow communication
• FIX ii transmission speed increased to 400kHz (was ~90kHz)
• FIX setting metro time to zero no longer causes crash (clamps to 500uS)
• FIX crow.reset() now resets output[n].scale to 'none'

This update adds a host of new input modes, output quantization and improved/extended ii support.

Input 'window' is great for parameter selectors. Input 'scale' turns crow into a highly reconfigurable quantizer. Input 'volume' and 'peak' allow patching audio signals to the inputs, and analyzing their RMS level ('volume' is analogous to 'stream', and 'peak' to 'change', but operating in the RMS time domain).

Output 'scale' squeezes the output through a highly configurable voltage quantizer. The quantization comes after the slew engine (ASL), so LFOs can easily be converted into arpeggios by simply applying the scale feature. Along with the 'shapes' of the v1.0.3 update, ASL is now useful for describing complex melodies in terms of contours rather than just notes.

ii support continues to improve. The bus is now more resilient to error conditions, and when things go wrong, it can recover more gracefully. New device support has been added for telex-O, and support for Just Friends 3.2 is included. The event handler for ii.<module>.get() requests has been updated to provide the full context of the request -- if you asked for 2 channels of data, each event will tell you which channel it's reporting from.

The above features will be available to norns users in the next update (after June 22 2020).

Log:

NB: The default git branch from which releases are built is now known as main.

• BREAKING metro no longer runs immediately after activation or modification

• BREAKING ii getters that take params, return them

• NEW output 'scale' settings for quantizing CV outputs

• NEW input mode: 'window'

• NEW input mode: 'scale'

• NEW input mode: 'volume'

• NEW input mode: 'peak'

• NEW ii support for BPC Telex-O module @nordseele

• NEW ii support for 16n faderbank (all 16 faders are now supported) @discohead

• NEW ii support for monome ansible (up to 4 simultaneous devices)

• NEW ii support for Mannequins Just Friends v3.2 features

• FIX after a bad ii get request, the ii bus now recovers

• FIX after failed ii messages, crow reports debugging suggestions

• FIX errors in init() correctly reported

• FIX frozen scripts now timeout @csboling

• FIX when running out of memory, Lua errors rather than crow crashing @csboling

• NEW errors now provide a traceback @csboling

• NEW basic reporting of CPU utilization cputime()

• CHANGE one additional metro / delay available (8 total)

Preliminary v1.0.2 release

Main focus is on extending the ii system:

• NEW devices supported: ER-301(er301), TelexI(txi), Ansible: Levels (levels)
• NEW user warning if crow detects no-pullups
• FIX Just Friends retune command now works correctly.
• FIX Ansible channel indices are now 1-based
• FIX ii commands are buffered to allow sending up to 16 messages at once

Other:

• NEW delay(time, action) function which allows a provided function to be executed in the future.

Interim build for improved reliability when uploading scripts (particularly from druid).

Startup prints are much clearer and informative, and you'll now be alerted to what script is running on startup.