Library of utility objects for MaxMSP aimed at interacting with electronics hardware like Arduino
Unzip the package folder into you ~/Documents/Max 8/Packages directory.
The library currently consists of the following projects
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
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 is a MaxMSP utility object for casting a list of bytes to other data formats. Useful when interacting with Arduino using the serial object.
The object takes a single argument of a data type and modifiers
| Format | Data Type |
|---|---|
| i | 32-bit int |
| h | 16-bit int |
| f | 32-bit float |
| s | ASCII string (greedy) |
| Modifier | Effect |
|---|---|
u |
unsigned (i and h only) |
> |
Big endian (append) |
< |
Little endian (append) |
**e.g. ** [byte-cast uh<] decodes little-endian unsigned 16-bit integer bytes.
See the object reference in max for more examples.
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.