The example demonstrates support for the MQTT (Message Queue Telemetry Transport) messaging protocol in KasperskyOS, and the integration of several virtual file systems (hereinafter VFS) in one solution. For more information about using multiple VFS programs, please refer to the File systems and network section.
Example directory in the SDK
The code of the example and build scripts are available at the following path:
/opt/KasperskyOS-Community-Edition-<platform>-<version>/examples/mqtt_subscriber
List of programs
Subscriber – MQTT subscriber application.Ntpd – system program that implements an NTP client that receives time parameters from external NTP servers in the background and forwards them to the KasperskyOS kernel.VfsSdCardFs – system program that supports the file system of SD cards.VfsNet – system program that supports network protocols.Dhcpcd – system program that implements the DHCP client.DCM – system program that lets you dynamically create IPC channels.EntropyEntity – system program that implements random number generation.DNetSrv – network card driver.SDCard – SD card driver.When you build an example for the target hardware platform, platform-specific drivers are automatically included in the solution:
BSP is a hardware platform support package (Board Support Package). Provides cross-platform configuration of peripherals for the Radxa ROCK 3A and Raspberry Pi 4 B.Bcm2711MboxArmToVc – driver for working with the VideoCore (VC6) coprocessor via mailbox technology for Raspberry Pi 4 B.GPIO – GPIO support driver for the Radxa ROCK 3A.PinCtrl – low-level pin multiplexing (pinmux) configuration driver for the Radxa ROCK 3A.Initialization description
The solution initialization description file named init.yaml is generated during the solution build process based on the ./einit/src/init.yaml.in template. Macros in @INIT_*@ format contained in the template are automatically expanded in the resulting init.yaml file. For more details, refer to init.yaml.in template.
Security policy description
The security.psl file contains a description of a security policy for a KasperskyOS-based solution and is located in the ./einit/src directory. The declarations in the PSL file are provided with comments that explain the purpose of these declarations.
Resources
The ./resources/xdl/mqtt_subscriber directory contains the Subscriber.edl file, which is the EDL description for the Subscriber program.
The directory ./resources/hdd/etc contains the configuration files for the VfsNet, Dhcpcd and Ntpd programs: hosts, dhcpcd.conf and ntp.conf, respectively.
The ./resources/hdd/var/db/dhcpcd directory is used by the Dhcpcd program to store network connection data.
Operating scenario
In this example, an MQTT publisher must be started on the host operating system, and an MQTT subscriber must be started on KasperskyOS. The Subscriber program is an implementation of an MQTT subscriber.
When the example starts and runs successfully, an MQTT subscriber started on KasperskyOS prints a "Got message with topic: my/awesome/topic, payload: hello" message.
Building and running the example
The CMake system, which is included with KasperskyOS Community Edition, is used to build and run the example.
To run this example, a Mosquitto MQTT broker must be installed and started on the host system. To install and start Mosquitto, run the following commands:
$ sudo apt install mosquitto mosquitto-clients
$ sudo /etc/init.d/mosquitto start
To start an MQTT publisher on the host system, run the following command:
$ mosquitto_pub -t "my/awesome/topic" -m "hello"
See Building and running examples section.
Page top