Max Hardware Library

Library of utility objects for MaxMSP aimed at interacting with electronics hardware like Arduino

• Install
• Contents
  • max-ble
    • Usage
  • byte-cast
    • Usage
• Contribution

Install

Unzip the package folder into you ~/Documents/Max 8/Packages directory.

Contents

The library currently consists of the following projects

max-ble

Max Object to interface with Bluetooth Low Energy devices like mobile devices, Arduino and other micro-controllers with BLE capability. See git repo for source code

Usage

First send a scan message. Each new device will be output from the right outlet. This output can be collected in a umenu object for later use.

Connecting to a device will output all of the available services and characteristics of the device.

• Each device has an identifier (6-byte address on windows, UUID on macOS)
• Each device has services (a UUID)
• Each service has characteristics (a UUID)
• Each characteristic has a value (raw byte data)

Output on connection is in the format service_UUID characteristic_UUID byte_data_as_list. The route can be used to separate out services and characteristics.

Byte data can be interpreted with itoa, bit shift and bit compare operators, or by using this libraries byte-cast object.

See the object reference in max for more examples.

byte-cast

byte-cast is a MaxMSP utility object for casting a list of bytes to other data formats. Useful when interacting with Arduino using the serial object.

See git repo for source code

Usage

The object takes a single argument of a data type and modifiers

**e.g. ** [byte-cast uh<] decodes little-endian unsigned 16-bit integer bytes.

See the object reference in max for more examples.

Contribution

This repository collects together individual projects as submodules. Issues with a specific external should be flagged at the corresponding repository.

Any issues with library structure or feature requests for further externals should flagged against this repository.