First Connection
This guide walks you through adding your first device connection in DATEYE. Once a connection is active, DATEYE can import measurement data from the device automatically.
Adding a Connection
- Open DATEYE and go to the Connections screen
- Click the Add Connection button or the + icon in the toolbar
- A configuration panel opens — select your device type from the list
- Fill in the required fields for your device (IP address, port, folder path, or API credentials depending on the adapter)
- Click Save
The connection appears as a card on the Connections screen.
Network adapters (AL550, Eye-Office, OPA3) require the device and the computer running DATEYE to be on the same local network. If the status indicator stays red after saving, verify that both devices are connected to the same network and that no firewall is blocking the connection.
Required Fields by Adapter
Each device type requires different configuration fields. The Adapters section of this documentation covers each device in detail. The fields you will typically encounter are:
| Field | Used By | Description |
|---|---|---|
| IP Address | Network adapters | The local IP address of the device |
| Port | Network adapters | The network port (usually pre-configured on the device) |
| Folder Path | File-based adapters | Local or network folder where the device writes export files |
| API Key | Cloud adapters | Authentication credential for API-based connections |
Understanding the Status Indicator
After saving a connection, DATEYE immediately attempts to verify it. The status indicator on the connection card shows the result:
| Color | Meaning |
|---|---|
| Green | Connection active — DATEYE can reach the device or service |
| Red | Connection error — DATEYE cannot reach the device (check network, IP, port) |
| Grey | Inactive — the connection is disabled or has never been tested |
To manually refresh the status, click the refresh icon on the connection card.
Verifying an Import
To confirm the connection works end-to-end:
- On the device, perform a measurement or trigger an export (exact steps depend on the device — see the Adapters section)
- Switch to DATEYE — the import happens automatically for most adapters, or you can trigger it manually with the import icon on the connection card
- Go to the History screen and confirm a new import entry appears with a non-zero record count
If no import entry appears after triggering a measurement, check the connection status and consult the adapter-specific guide for your device.
Next Steps
Your first connection is active. Add additional connections for other devices in your practice, then consult the Adapters section for device-specific configuration details.