Communicate with XBee modules with the Make Controller Kit via OSC.
More...
Communicate with XBee modules with the Make Controller Kit via OSC.
There can only be one XBee board connected to the Make Controller Kit's serial port at a time, so there is not a device index in XBee OSC messages.
The XBee system has the following properties:
- autosend
- io16
- io64
- rx16
- rx64
- tx16
- tx64
- tx-status
- active
- Autosend
- The autosend property corresponds to whether the Make Controller will automatically send out messages it receives from a connected XBee module. By default, this is turned off. To turn this on, send the message
and to turn it off, send
All autosend messages send at the same interval. You can set this interval, in milliseconds, by sending the message
/system/autosend-interval 10
-
- You also need to select whether the board should send to you over USB or Ethernet. Send
to send via USB, and
to send via Ethernet. Via Ethernet, the board will send messages to the last address it received a message from.
- io16
- The io16 property corresponds to an incoming message from an XBee module with samples from its IO pins. The best way to use this is to turn the XBee system's autosend property on - then the Make Controller can relay io16 messages as soon as they're received.
-
- Once you've turned on autosend, if there are boards on your network that are sending IO packets, you'll receive messages like
/xbee/io16 1234 28 12 0 0 1023 1023 0 512 0 1023
- the address of the module that sent the message (1234 in the example above)
- signal strength (28 above)
-
- The next 9 numbers are the values from the 9 IO pins on the XBee module.
- io64
- The io64 property corresponds to an incoming message from an XBee module with samples from its IO pins. This message is just like the io16 message, except it's coming from a board with a 64-bit address, rather than a 16-bit address. The structure of the message is the same (see above).
- rx16
- The rx16 property corresponds to an incoming message from a 16-bit address XBee module with arbitrary data. The best way to use this is to turn the XBee system's autosend property on - then the Make Controller can relay rx16 messages as soon as they're received.
-
- Once you've turned on autosend, if there are boards on your network that are sending IO packets, you'll receive messages like
/xbee/rx16 1234 28 0 [43 44 45 32 46 47 48]
- the address of the module that sent the message (1234 in the example above)
- signal strength (28 above)
- the options byte (0 above), respectively.
-
- Following those is an OSC blob with the data (enclosed in square brackets above). These are the hex values for each byte of data.
- rx64
- The rx64 property corresponds to an incoming message from an XBee module with samples from its IO pins. This message is just like the io16 message, except it's coming from a board with a 64-bit address, rather than a 16-bit address. The structure of the message is the same (see above).
- Transmit Status
- The tx-status property gives you the status of a previously sent message. It tells you the frameID of the message that was sent and its status, which can be one of:
- Success. Message was successfully transmitted and received.
- No acknowledgement received. The message was successfully sent, but not successfully received on the other end.
- CCA Failure.
- Purged.
-
- If you don't include a frameID for the message that you sent, a tx-status message will not be generated. An example tx-status message will look like
/xbee/tx-status 52 Success
- Active
- The active property corresponds to the active state of the XBee system. If you're not seeing appropriate responses to your messages to the XBee system, check whether it's active by sending the message
-
- You can set the active flag by sending