IO-Tool
The IO-Tool, a developer tool for testing agrirouter integrations with data exchange, simulation, and debugging
The IO-Tool is the most feature-complete developer tool for testing agrirouter integrations. From a web UI, you can send and receive files, simulate telemetry, debug message exchange, and exercise all the major agrirouter data exchange concepts.
The IO-Tool is a developer tool for testing and debugging. It is not part of the agrirouter platform itself and is not intended for production use.
- URL: https://io.my-agrirouter.com/
- Registration: Not self-service. To request an account, write to
support@agrirouter.com.
Features
- Send and receive files in all supported agrirouter formats
- Send and receive telemetry data (EFDI)
- Test data exchange concepts such as routing, publishing, and subscriptions
- Debug integrations with detailed message logs
- Simulate endpoints and machine telemetry
Getting Started
Request an account
Write to support@agrirouter.com requesting access to the IO-Tool. You will receive credentials once your account is provisioned.
Log in
Navigate to https://io.my-agrirouter.com/ and sign in with the credentials you received.
Connect to agrirouter
Go to Settings and choose the environment you want to connect to. MQTT Production is the right choice for most cases.
Choose the correct environment
The IO-Tool environment must match the environment your application is registered in. If your app is in QA, connect the IO-Tool to QA as well. Endpoints across environments cannot talk to each other.
Select MQTT or REST
Pick MQTT. It is faster and bidirectional. REST requires polling and is slower for testing workflows.
Complete the onboarding process
After you pick environment and protocol, the IO-Tool redirects to the agrirouter login page. Sign in, confirm the connection, and wait for setup to finish.
Explore the IO-Tool
Once onboarding completes, five menu items appear: Data Storage, Endpoints, Simulation, Logging, and Settings.
Capabilities and Subscriptions
After onboarding, set your capabilities and subscriptions under Settings. Capabilities define which message types the IO-Tool endpoint can send and receive. Subscriptions define which message types it actively listens for.
Sending a new capabilities message clears all existing subscriptions. Re-send your subscriptions after updating capabilities.
Data Storage
The Data Storage section lets you upload, organize, and exchange files through agrirouter.
- Upload files via drag-and-drop (maximum 15 MB per file)
- Organize files by technical message type
- Send files directly to specific endpoints or publish them to all subscribers
- Receive files from other endpoints
- Built-in ISOXML validation for TaskData files
Endpoints
The Endpoints view shows all reachable endpoints and their capabilities. From this view you can:
- See which endpoints are available for communication
- Inspect the capabilities of each endpoint
- Send files directly to a specific endpoint
Simulation
Simulation replays machine telemetry from ISOXML or EFDI data. Use it to test how your application handles live telemetry streams.
Available simulation options:
- Endless loop: Repeat the telemetry data continuously
- Replace time: Substitute original timestamps with current time
- Skip initial: Skip the device description at the beginning
- Interval: Set the time between telemetry messages
- Scale: Adjust playback speed
- DDI details: Inspect the Data Dictionary Identifiers in the telemetry data
Logging
Logging gives you detailed message logs for debugging. You can:
- Filter logs by message type, timestamp, or keyword
- Enable trace logging for detailed protocol-level information (available for 24 hours after activation)
- Inspect individual message payloads and headers
Telemetry MapView
The MapView displays EFDI and GPS telemetry data on an interactive map. You can:
- Visualize device positions and movement paths
- Inspect telemetry values at specific positions
- Download telemetry data as EFDI or ISOXML format
Troubleshooting
| Problem | Solution |
|---|---|
| UI not responding | Log out and log back in to refresh the session |
| Cannot send messages | Reconnect the MQTT connection in Settings |
| Onboarding errors | Check that you picked the correct environment and that your agrirouter account has endpoint slots left |
| Upload errors | Check that the file is under 15 MB and matches a supported format |
Offboarding
To disconnect the IO-Tool from agrirouter, use the offboarding option in Settings. This removes the IO-Tool endpoint from your agrirouter account and deletes all associated data.
Offboarding permanently deletes the endpoint. To reconnect, you have to onboard again.