Motion Detection Tool
Access motion sensors on Android device.
How It Works
This skill provides instructions for the Motion Detection tool node. Connect the Motion Detection node to Zeenie's input-tools handle to enable motion sensing.
motion_detection Tool
Get accelerometer, gyroscope, and motion data.
Schema Fields
| Field | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | "status" - Get motion sensor data |
Example
Get motion data:
{
"action": "status"
}
Response Format
{
"success": true,
"service": "motion_detection",
"action": "status",
"data": {
"accelerometer": {
"x": 0.12,
"y": 9.78,
"z": 0.34
},
"gyroscope": {
"x": 0.01,
"y": 0.02,
"z": 0.00
},
"orientation": {
"azimuth": 45.0,
"pitch": -5.0,
"roll": 2.0
},
"is_moving": false,
"is_shaking": false,
"device_position": "flat"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
| accelerometer | object | X, Y, Z acceleration (m/s^2) |
| gyroscope | object | X, Y, Z rotation rate (rad/s) |
| orientation | object | Device orientation angles |
| is_moving | boolean | Significant movement detected |
| is_shaking | boolean | Shake gesture detected |
| device_position | string | Inferred position |
Orientation Fields
| Field | Description |
|---|---|
| azimuth | Compass heading (0-360 degrees) |
| pitch | Forward/backward tilt (-180 to 180) |
| roll | Left/right tilt (-90 to 90) |
Device Positions
| Position | Description |
|---|---|
flat | Laying flat on surface |
upright | Standing vertical |
tilted | Angled position |
face_down | Screen facing down |
face_up | Screen facing up |
Accelerometer Interpretation
When device is stationary and flat:
- X ~ 0 (left-right)
- Y ~ 9.8 (gravity)
- Z ~ 0 (forward-backward)
Movement creates deviations from gravity baseline.
Use Cases
| Use Case | Data | Description |
|---|---|---|
| Shake detection | is_shaking | Trigger on shake gesture |
| Movement alert | is_moving | Detect device moved |
| Orientation | device_position | Check how device is held |
| Compass heading | azimuth | Get direction |
| Tilt detection | pitch, roll | Detect angles |
Common Workflows
Shake to trigger action
- Poll motion status
- When is_shaking = true
- Execute action
Security monitor
- Place device as monitor
- Check is_moving periodically
- Alert if movement detected
Orientation-based response
- Check device_position
- Adjust behavior based on orientation
Setup Requirements
- Connect the Motion Detection node to Zeenie's
input-toolshandle - Android device must be paired
- Motion sensors must be available on device