Routing

A route is a pairing between two endpoints, i.e. data flows from the sender to the recipient via a route. You use the route to specify who shares messages.

The routing controls the flow of data along the routes. You use the routing to specify which messages are shared.

Create inbound and/or outbound routes for each endpoint, group, and paired account. No data can be shared without a route.

Agrirouter transports data but it does not edit or store it.

This excludes data that cannot be delivered, e.g. because the recipient is offline. Agrirouter buffers this data for 4 weeks. If the recipient cannot be reached for the entire time, the data is deleted.

In this section you will learn:

  • Which routes are created automatically, and when

  • Examples of how you create a route

Automatically created routes

The inbound and outbound routes of the two default groups are set by the system and cannot be changed:

  • Members of the agricultural software group send all data – i.e. all messages and real-time data – to all members of the machine group

  • Members of the machine group send all data – i.e. all messages and real-time data – to all members of the agricultural software group

Outbound routes

An outbound route is used to send data from one endpoint or group to a recipient.

  • To learn how to create, edit, and delete an outbound route for an endpoint, see here…​

  • To learn how to create, edit, and delete an outbound route for a group, see here…​

Inbound routes

An endpoint or group receives data from a sender via an inbound route.

  • To learn how to create, edit, and delete an inbound route for an endpoint, see here…​

  • To learn how to create, edit, and delete an inbound route for a group, see here…​

Frequently used routes

Below are some routes frequently used by users, each with step-by-step instructions on how to set them up.

All endpoints to all endpoints

With this routing, all endpoints send all their available data to all the other endpoints.

Click the + Group button in the Groups tab of the Control Center. The New group window is displayed. . Enter the name All, then click Confirm. Click the Add add icon in the Send to tab of the group’s detail view . The New routing form is displayed. . Click into the Recipient input field and select the group All. . Click into the Message formats input field, select all the message formats, then click Confirm. Click into the Telemetry parameter categories input field, select all the categories, then click Confirm. The New routing form is displayed. Click the Confirm button. The All group is added as a sender and a recipient. Click the Add add icon in the detail view of the group in the Members tab. The Select members form is displayed. Select all the endpoints, then click Confirm. All endpoints are added to the All group.

Newly added endpoints in agrirouter are not automatically copied into the All group.

Remember to add new endpoints to the All group.