Device Hierarchy
OWL DMS uses a two-tier device structure:Papa Duck
Gateway devices that connect to the internet and relay messages to the cloud. Each Papa Duck can support multiple Mama Ducks.
Mama Duck
Mesh network devices that relay messages between end devices and Papa Ducks. Each Mama Duck must be assigned to a parent Papa Duck.
Device Table
The main table displays your Papa Duck devices with expandable rows:Table Columns
| Column | Description |
|---|---|
| Name | Device display name (clickable link to device details) |
| Unique ID | Hardware identifier for the device |
| Description | Optional device description |
| Location | Physical location or deployment area |
| Status | Online/Offline (based on messages in last 5 minutes) |
| Mama Devices | Number of connected Mama Duck devices |
| Created | Date the device was added to the system |
| Actions | Edit and delete buttons |
Expandable Rows
Click the expand arrow next to a Papa Duck to view its connected Mama Ducks:Mama Details
Each Mama Duck shows the same information as Papa Ducks (name, ID, description, location, status)
Adding Devices
Add Papa Duck
Enter Device Info
Fill in the required and optional fields:
- Name (required, 3-8 characters): Short identifier for the device
- Description (optional): Purpose or notes about the device
- Location (optional): Physical location or deployment area
Papa Duck credentials (Device ID and Token) are generated automatically and can be viewed in the device details page.
Add Mama Duck
Enter Device Info
Fill in the required and optional fields:
- Name (required, 3-8 characters): Short identifier
- Parent PAPA (required): Select the parent Papa Duck
- Description (optional): Purpose or notes
- Location (optional): Physical location
Editing Devices
Click the edit icon (pencil) next to any device to modify its information:Editable Fields
- Description: Update the device purpose or notes
- Location: Change the deployment location
- Parent Papa (Mama Ducks only): Reassign a Mama Duck to a different Papa Duck
What Cannot Be Changed
What Cannot Be Changed
- Device Name (set during creation)
- Unique ID (hardware identifier)
- Device Type (PAPA or MAMA)
- Gateway credentials (Papa Ducks only)
Device Status
Online/Offline Detection
Devices are automatically marked as online or offline based on recent message activity:Device status updates automatically based on real-time message activity from the WebSocket connection.
Viewing Device Details
Papa Duck Details
Click on a Papa Duck name to view its detail page, which includes:- Device information (name, ID, description, location)
- Gateway credentials (Device ID and Token for cloud connectivity)
- Last seen timestamp
- Battery status (if available)
- Online/offline status
- Connected Mama Ducks list
- Recent message history
Mama Duck Details
Click on a Mama Duck name to view its detail page, which shows:- Device information
- Parent Papa Duck
- Last seen timestamp
- Battery and health metrics
- Online/offline status
- Recent message history
- GPS location history (if equipped)