Skip to main content
Version: 3.1.0

Concepts

Luos engine

Luos engine is the engine provided by Luos that will manage your services on all your nodes.

Technically, this engine is an embedded oriented lightwheight and realtime ANSI C code library that you can include and use in your code. This library provides a simple API to create, manage, and interact with services.

tip

As Luos engine is not an operating system, you can use it with or without any operating system.

Luos engine is open-source under Apache 2.0 license and available on GitHub.

What is a Node?

A node is an executable software running Luos and hosting one or several services. It can be running on a microcontroller, a computer, or in the cloud. In a Luos architecture, nodes are all connected together using different network interfaces. You can choose between the different communication bus already provided by Luos or create your own.

In other words, a node is an executable program connected to other programs running Luos.

Know more about nodes

luos_imgluos_img

Packages

A package is a folder of code containing a pack of features in your project. A package can be composed of one or several services, but services in the same package share the same physical resources. For example, a dual DCmotor driver is developed into one package but exposes two services (one for each motor). The purpose of this package is to be simply copied and pasted across nodes, projects, or shared as ready-to-use apps.

Know more about packages

Service

A service is a "public" feature hosted in a package. It provides the API of your feature by exposing inputs and outputs. An input can be an angular target position of a motor, the color of an RGB LED, or an advanced custom command to control the behavior of your product. An output can be a temperature, the torque delivered by a motor, or the result of a complex home-made algorithm.

Services, much like their server-world counterparts, can be placed anywhere in your infrastructure, and you as a developer do not need to know where they are located to access them. Luos will detect the physical position of all the nodes of your product, list all the services among them, and share the result with all your services in a routing table. The network can physically change, Luos can update dynamically the routing table allowing your services to stay available.

Each service is hosted in a single node, but you can have the same service duplicated multiple times in your product. Luos do not allow to run a service in multiple nodes.

For instance, the Dynamixel example (available in the Luos engine example folder) can dynamically create servomotors services depending on the number of Dynamixel motors linked to it. Any Dynamixel service is visible as an independent servomotor similar to any other servomotor technology, such as the stepper service example or the controller motor service example. Then, you can use any of your Dynamixels from any other services or even from any computer, cloud program, or ecosystem such as ROS.

There are two categories of services, drivers or applications.

  • Drivers are services giving advanced access to a physical resource. Drivers cannot rely on any other services; they are independent. Drivers should aim to comply to the adapted service profile provided by Luos and the community, allowing an universal access to any physical resource.
  • Applications are the behaviors of your product and don't rely on any hardware. Application services search for the driver services they need and use them to physically control the device.

Following the rules of these categories will help you to improve the maintainability and the re-usability of all your developments.

Know more about Services

Service detection

Services in the network are automatically detected and being assigned IDs depending on their node's physical position in the network, and a routing table is generated.

IDs are assigned from the nearest to the furthest node branch by branch, from the point of view of the service running the detection. Following this logic, the service running the detection will have ID 1, the next one will have ID 2, etc.

Note: Multiple detections by different services at the same time is not allowed.

It is possible to execute a detection in the network frequently in order to dynamically discover included or excluded services while running. This allows to detect if hardware has been added or removed.

Routing table

A routing table is a data structure managed by the Luos network and available for any services on any nodes. This data structure lists all the services in the network and allows any services to access and use basic information of any other services or nodes. The routing table's data can be loaded or auto-generated during detection, and can be refreshed on demand.

Know more about Routing Table

Messages

Communication between services and apps is performed through messages. A message contains information on the destination service(s), the type of operation to be performed (the type of message), as well as the data. The message will be sent in the network and will arrive at the destination, no matter where the service is placed in the architecture.

Know more about Messages handling