Real Time Wireless Sensor Network
General Description
The AI-PRISM real-time communication network facilitates communication between sensors, the AI-PRISM Data Platform, edge devices, and software components. Its goal is to ensure high-quality service while remaining adaptable. It employs advanced industrial IoT technologies for flexible wireless sensing combined with industry-integrated software-defined networks (SDN). SDN centralizes network management by offering a comprehensive view across various technologies, such as Time Sensitive Networks, Ethernet, Wi-Fi, and IEEE 802.15.4. This centralized approach, overseen by the SDN controller, optimizes end-to-end service quality. The SDN controller manages multiple network technologies, simplifying device configurations. This relaxes application development in the fog as the controller provides high-level APIs, connecting apps to networks without complex configurations.
As highlighted in the architecture figure, this infrastructure is the enabler to achieving real-time communications in AI-PRISM. It has a stack of protocols that allow centralized control of all node processes (e.g. Medium Access Control - MAC, Routing, QoS, Application). As mentioned above, this is based on the SDN paradigm, which manages networks by separating the control and data planes. The control plane is entirely software-controlled, where a centralized agent, in this case, an SDN controller, decides to configure resources and rules in the nodes. The data or forwarding plane are made up of the nodes, which operate in plug-and-play mode, as the controller sends each node all the necessary instructions to achieve maximum performance. In addition, the SDN controller is used as an integration point for the physical network infrastructure and the application that collects the network information and requests network reconfiguration. For that, use a specific protocol for each network technology, for example, OpenFlow for wired SDN network, NetFlow for TSN, and even non-standard protocols such as SDN WISE for WSN.
Key benefits of this setup include:
- Centralized network oversight
- Efficient routing and optimization
- Proactive network monitoring and adaptation
- Scheduled wireless medium access
- Resource allocation based on demand
- Traffic flow prioritization and separation
- Comprehensive QoS management.
| Resource | Link |
|---|---|
| Source code | Link to source code |
| Demo Video | Link to video |
✔️ Generate a GIF with screenshots or images that represent the main functionalities of the component and add it to the
it img subfolder, and link it in the image below.
Contact
The following table includes contact information of the main developers in charge of the component:
| Name | Organisation | |
|---|---|---|
| Federico Orozco | forozco@iti.es |  |
License
GNU General Public License v3.0
Technical Foundations
✔️ Describe the technical foundations of your component. Describe in detail the models, algorithms, or methods you use. If the documentation is available in a different source, for instance, an open access paper, provide here a high-level overview and links to external references.
Integrated and Open Source Components
This section outlines both pre-existing technologies and open-source components that have been integrated into the component. It provides details on their sources, purposes, modifications, and compliance with licensing terms.
Overview
✔️ Provide a high-level overview of the integrated and open-source components. Provide a high-level description of the funding received in previous projects and what is the progress in AI-PRISM.
Pre-existing Components
[Repeat for each sub-component] Sub-component Name
Source
✔️ For previous background, provide the project name or origin of the sub-component. Provide a link to project or origin. ✔️ For open source, provide a link to the open source repository.
Description
✔️ Provide a high-level description of the sub-component.
Modifications
✔️ Describe the modifications made to the sub-component to adapt it to the AI-PRISM project. Describe enhancements, or additional features that have been generated thanks to AI-PRISM.
Purpose in AI-PRISM
✔️ Describe how the sub-component is used in AI-PRISM. Describe the role of the component in the project.
License
✔️ Describe the license of the sub-component. Provide a link to the license if available.
How to install
✔️ Every AI-PRISM component is installed using the Cluster management service. During the installation process, the user needs to configure a set of high-level parameters. Provide here a description of the parameters that the user needs to fill in.
How to use
1. Launching the Controller in Docker
To start the SDN controller in a Docker container, follow these steps:
- Ensure that Docker is installed on your system.
- Connect the wireless receiver to the designated USB port (
/dev/tty1). - Run the following command to launch the container: ```sh docker run --rm -d --name sdn-controller \ --device=/dev/tty1 \ -p 8080:8080 \ sdn-controller-image
2. Accessing the API via Swagger
The SDN controller exposes an API that can be accessed and explored using Swagger.
- Open a web browser and go to:
http://localhost:8080/swagger-ui/ - From this interface, you can review the documentation and test various API functionalities.
3. Available API Features
Through Swagger or HTTP requests, you can perform the following operations:
3.1. Querying Network Resources
To obtain information about connected devices and network status, use the following endpoint:
3.2. Requesting Data Transmission
To request data transmission from a network device, use:
Parameters:
device_id: Identifier of the target device.data: Information to be sent.
3.3. Modifying Transmission Frequency
To adjust the transmission frequency of connected devices:
Parameters:
device_id: Identifier of the device.frequency: New transmission frequency in Hz.
4. Additional Documentation
For more details on the API and its advanced functionalities, refer to the documentation available in the Swagger interface.