Basic Concepts of agrirouter

Ecosystem

The agrirouter ecosystem and the members of it are described in the chapter ecosystem.

Figure 1. The agrirouter ecosystem of members

Applications and App Instances

In each agrirouter account, there are different types of communication partners, which are called app instances:

Figure 2. The different types of app instances: CU, Application, Virtual CU, Machine, Account

The list of Application Types helps to find out which type of application you should create.

Endpoints

Each app instance communicates with its corresponding endpoint in the agrirouter.

For communication, it’s important to understand the elements of an endpoint.

Figure 3. The elements of an endpoint: Communicate with Inbox and Outbox, Handle Feed and Subscriptions and send Messages through the routings to other endpoints

Communication

To communicate with agrirouter, it’s important to understand the basics of communication

Messaging Workflow

The communication workflow describes which messages have to be sent to agrirouter to exchange information with the agrirouter endpoint.

Figure 4. General messaging workflow

This workflow can be found in the chapter messaging workflows.

Message Exchange

The message exchange describes the exchange of messages between application instances over the agrirouter.

Figure 5. Path of a message through agrirouter

The basic concepts of message exchange are described in the concepts of message exchange. This chapter handles, for example, the concepts of addressing members of the ecosystem.

Life cycle

In general, the life cycle of an endpoint consists of 3 steps:

Figure 6. The 3 steps of communication: Onboarding, Communication, Revoking

Concept of a telemetry platform

When developing a telemetry platform, the concepts of a telemetry platform should be understood.

Figure 7. Endpoints of a Telemetry Platform

Terms and short descriptions

A short description naming all the agrirouter specific terms and their connection to each other can be found here.

A list of abbreviations can be found here.

A glossary can be found here.

There are several ids required for communication, a list of descriptions can be found here.