Difference between revisions of "Bullroarers"
From Robert-Depot
(→OSC Addressing) |
(→OSC Addressing) |
||
| Line 6: | Line 6: | ||
Introduction to Open Sound Control - http://opensoundcontrol.org/introduction-osc | Introduction to Open Sound Control - http://opensoundcontrol.org/introduction-osc | ||
| − | Each bullroarer node has a base address ''/br/ | + | Each bullroarer node has a base address ''/br/" followed by its number, 1-21. |
They can send 4 messages: | They can send 4 messages: | ||
| − | **''/br/1/range'', integer, 0-1024. Analog sensor reading from ultrasonic rangefinder from 0-1024. Sent every 200 ms (so 5 Hz refresh rate). | + | **''/br/1/range'', integer, 0-1024. |
| − | **''/br/1/limit'', integer, 0 or 1. State of limit switch. Sent when button is pressed or released. Switches are active low, so the value is 0 (LOW) when the button is pressed, 1 (HIGH) when the button is released. | + | ***Analog sensor reading from ultrasonic rangefinder from 0-1024. |
| − | **''/br/1/relay'', integer, 0 or 1. State of motor control relay. Sent when relay state changes. Relays are active low, so a value of 0 (LOW) means the relay is on, 1 (HIGH) means the relay is off. | + | ***Sent every 200 ms (so 5 Hz refresh rate). |
| − | **''/br/1/config'', integer, integer, integer. Sent when requested. | + | **''/br/1/limit'', integer, 0 or 1. |
| + | ***State of limit switch. | ||
| + | ***Sent when button is pressed or released. Switches are active low, so the value is 0 (LOW) when the button is pressed, 1 (HIGH) when the button is released. | ||
| + | **''/br/1/relay'', integer, 0 or 1. | ||
| + | ***State of motor control relay. | ||
| + | ***Sent when relay state changes. Relays are active low, so a value of 0 (LOW) means the relay is on, 1 (HIGH) means the relay is off. | ||
| + | **''/br/1/config'', integer, integer, integer. | ||
| + | ***Sent when requested. | ||
***First value is auto mode, 0 for "off", 1 for "on". | ***First value is auto mode, 0 for "off", 1 for "on". | ||
***Second value is max range, 0 - 1024. This is a threshold value for the lower limit of bullroarer travel. When in auto mode, a sensor reading larger than this value will trigger the relay to turn the motor back on and raise the bullroarer. | ***Second value is max range, 0 - 1024. This is a threshold value for the lower limit of bullroarer travel. When in auto mode, a sensor reading larger than this value will trigger the relay to turn the motor back on and raise the bullroarer. | ||
| Line 18: | Line 25: | ||
They can receive 6 messages: | They can receive 6 messages: | ||
| − | **''/br/1/relay'', integer (0 or 1). Turns relay on or off. Relays are active low, so a value of 0 (LOW) means the relay is on, 1 (HIGH) means the relay is off. | + | **''/br/1/relay'', integer (0 or 1). |
| + | ***Turns relay on or off. | ||
| + | ***Relays are active low, so a value of 0 (LOW) means the relay is on, 1 (HIGH) means the relay is off. | ||
Configuration messages. The following three messages change run-time behavior of a node in automatic mode: | Configuration messages. The following three messages change run-time behavior of a node in automatic mode: | ||
| − | **''/br/1/auto'', integer (0 or 1). Sets automatic mode. 0 for "off", 1 for "on". | + | **''/br/1/auto'', integer (0 or 1). |
| − | **''/br/1/max'', integer, 0 - 1024. Sets the threshold value for the lower limit of bullroarer travel. When in auto mode, a sensor reading larger than this value will trigger the relay to turn the motor back on and raise the bullroarer. | + | ***Sets automatic mode. 0 for "off", 1 for "on". |
| − | **''/br/1/timeout'', long integer, 0- max long int. Sets the amount of time the bullroarer waits at bottom before starting motor, the "rest time". Only works when in auto mode. | + | **''/br/1/max'', integer, 0 - 1024. |
| − | **''/br/1/write'', integer, 0 or 1. Writes the current runtime configuration (auto, max, and timeout) to the bullroarer's EEPROM. This will save the current settings for next startup. Otherwise they are lost. | + | ***Sets the threshold value for the lower limit of bullroarer travel. When in auto mode, a sensor reading larger than this value will trigger the relay to turn the motor back on and raise the bullroarer. |
| − | **''/br/1/config'', integer, 0 or 1. Sends the current runtime configuration for the bullroarer to the host computer. | + | **''/br/1/timeout'', long integer, 0- max long int. |
| + | ***Sets the amount of time the bullroarer waits at bottom before starting motor, the "rest time". Only works when in auto mode. | ||
| + | **''/br/1/write'', integer, 0 or 1. | ||
| + | ***Writes the current runtime configuration (auto, max, and timeout) to the bullroarer's EEPROM. This will save the current settings for next startup. Otherwise they are lost. | ||
| + | **''/br/1/config'', integer, 0 or 1. | ||
| + | ***Sends the current runtime configuration for the bullroarer to the host computer. | ||
Revision as of 08:41, 10 September 2014
Addressing Scheme
21 bullroarer nodes with single server/controller system.
- Node Addresses: 192.168.3.1 - 192.168.3.21
- Server/Controller Address: 192.168.3.100
OSC Addressing
Introduction to Open Sound Control - http://opensoundcontrol.org/introduction-osc
Each bullroarer node has a base address /br/" followed by its number, 1-21.
They can send 4 messages:
- /br/1/range, integer, 0-1024.
- Analog sensor reading from ultrasonic rangefinder from 0-1024.
- Sent every 200 ms (so 5 Hz refresh rate).
- /br/1/limit, integer, 0 or 1.
- State of limit switch.
- Sent when button is pressed or released. Switches are active low, so the value is 0 (LOW) when the button is pressed, 1 (HIGH) when the button is released.
- /br/1/relay, integer, 0 or 1.
- State of motor control relay.
- Sent when relay state changes. Relays are active low, so a value of 0 (LOW) means the relay is on, 1 (HIGH) means the relay is off.
- /br/1/config, integer, integer, integer.
- Sent when requested.
- First value is auto mode, 0 for "off", 1 for "on".
- Second value is max range, 0 - 1024. This is a threshold value for the lower limit of bullroarer travel. When in auto mode, a sensor reading larger than this value will trigger the relay to turn the motor back on and raise the bullroarer.
- Third value is cycle timeout, 0 - max long int. Sets the amount of time the bullroarer waits at bottom before starting motor, the "rest time". Only works when in auto mode.
- /br/1/range, integer, 0-1024.
They can receive 6 messages:
- /br/1/relay, integer (0 or 1).
- Turns relay on or off.
- Relays are active low, so a value of 0 (LOW) means the relay is on, 1 (HIGH) means the relay is off.
- /br/1/relay, integer (0 or 1).
Configuration messages. The following three messages change run-time behavior of a node in automatic mode:
- /br/1/auto, integer (0 or 1).
- Sets automatic mode. 0 for "off", 1 for "on".
- /br/1/max, integer, 0 - 1024.
- Sets the threshold value for the lower limit of bullroarer travel. When in auto mode, a sensor reading larger than this value will trigger the relay to turn the motor back on and raise the bullroarer.
- /br/1/timeout, long integer, 0- max long int.
- Sets the amount of time the bullroarer waits at bottom before starting motor, the "rest time". Only works when in auto mode.
- /br/1/write, integer, 0 or 1.
- Writes the current runtime configuration (auto, max, and timeout) to the bullroarer's EEPROM. This will save the current settings for next startup. Otherwise they are lost.
- /br/1/config, integer, 0 or 1.
- Sends the current runtime configuration for the bullroarer to the host computer.
- /br/1/auto, integer (0 or 1).
