www.ventosus.ch

monobus

OSC to Lawo MonoBus bridge

Control your Lawo MonoBus devices via an OSC server that talks to FTDI USB adapters.

Dependencies

LV2 (LV2 Plugin Standard)
libftdi (Library to talk to FTDI chips)
netpbm (Toolkit for manipulation of graphic images)
ncurses (Free software emulation of curses)

Build / install

git clone https://git.open-music-kontrollers.ch/~hp/monobus
cd monobus
meson build
cd build
ninja
ninja test
sudo ninja install

Usage

Discover your type of FTDI device via e.g. dmesg when plugging it in

[user@machine ~] dmesg
[  132.718684] usb 1-1.4: New USB device found, idVendor=0403, idProduct=6001, bcdDevice= 6.00
[  132.718689] usb 1-1.4: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[  132.718691] usb 1-1.4: Product: FT232R USB UART
[  132.718693] usb 1-1.4: Manufacturer: FTDI
[  132.718695] usb 1-1.4: SerialNumber: ABCXYZ

Run monobus daemon with the information gathered above

monobusd \
    -V 0x0403 \                   # USB idVendor
    -P 0x6001 \                   # USB idProduct
    -D 'FT232R USB UART' \        # USB product description
    -S ABCXYZ \                   # USB product serial number
    -F 2 \                        # update rate in frames per second
    -U osc.udp://:7777            # OSC server URI

Run monobus daemon in testing, aka simulation mode with ncurses output

monobusd \
    -T \                          # enable testing mode
    -F 2 \                        # update rate in frames per second
    -U osc.udp://:7777            # OSC server URI

Run monobus client with a 112x16 pixel pbm image at offset (2, 3)

monobusc \
    -P 11  \                      # priority level 11
    -X 2 \                        # put image data at x-offset 2
    -Y 3 \                        # put image data at x-offset 3
    -W 112 \                      # image data width
    -H 16 \                       # image data height
    -U osc.udp://localhost:7777 \ # OSC server URI
    -I bitmap.pbm                 # Bitmap in PBM format

Run monobus client to clear image at priority level 11

monobusc \
    -P 11  \                      # priority level 11
    -C \                          # clear image data
    -U osc.udp://localhost:7777   # OSC server URI

Control monobusd with your favorite OSC client

/monobus/PRIO ,iiiib BITMAP-DATA

To set the bitmap, send your OSC messages to given OSC path with PRIO 0-31 integer x-offset, integer y-offset, integer width, integer height and blob argument being your bitmap data in PBM payload format.

# set bitmap of size 112x16 at offset position (8,12) for priority level 11
osc.udp://localhost:7777 /monobus/11 ,iiiib 8 12 112 16 {...}

**/monobus/PRIO ,

To clear the bitmap, send your empty OSC messages to given OSC path with PRIO 0-31.

# clear whole bitmap for priority level 11
osc.udp://localhost:7777 /monobus/11 ,

Issues/Patches

Please report issues to https://todo.open-music-kontrollers.ch/~hp/issues

Please submit patches to https://lists.open-music-kontrollers.ch/~hp/patches