diff --git a/astro.config.mjs b/astro.config.mjs index e750793f..7e079511 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -38,4 +38,4 @@ export default defineConfig({ ], adapter: cloudflare(), -}); \ No newline at end of file +}); diff --git a/public/img/blogs/beagle-to-magistrala-connection/beaglev-fire.png b/public/img/blogs/beagle-to-magistrala-connection/beaglev-fire.png new file mode 100644 index 00000000..87be1c2e Binary files /dev/null and b/public/img/blogs/beagle-to-magistrala-connection/beaglev-fire.png differ diff --git a/src/content/blogs/beagle-to-magistrala-connection.md b/src/content/blogs/beagle-to-magistrala-connection.md new file mode 100644 index 00000000..ab65bef2 --- /dev/null +++ b/src/content/blogs/beagle-to-magistrala-connection.md @@ -0,0 +1,250 @@ +--- +title: "Connecting BeagleV Fire to Magistrala and send data via MQTT and CoAP" +slug: "connecting_the_beaglev_fire_to_magistrala" +excerpt: "Publishing and Subscribing data to Magistrala via CoAP and MQTT using the BeagleV Fire" +description: "Learn about the highly scalable, secure and open-source cloud platform Magistrala, how to connect the BeagleV Fire to it and publish data via CoAP and MQTT" +date: "2026-04-28" +author: + name: "Jones Kisaka" + picture: "https://avatars.githubusercontent.com/u/85192767?v=4" +coverImage: "/img/blogs/beagle-to-magistrala-connection/beaglev-fire.png" +ogImage: + url: "/img/blogs/beagle-to-magistrala-connection/beaglev-fire.png" +category: blog +tags: + +- Abstract Machines +- Magistrala +- BeagleV Fire +- S1 +- IoT +- MQTT +- CoAP + +--- + +Today, the [BeagleV-Fire](https://www.beagleboard.org/boards/beaglev-fire) is one of the most exciting RISC-V development boards built for experiments in AI acceleration, FPGAs, Linux, and real hardware exploration. But one of its biggest strengths is how easily it can integrate with modern IoT platforms. + +[Magistrala](https://github.com/absmach/magistrala/blob/main/README.md) is an open-source IoT platform built for engineers who need full control over their messaging, device management, and data pipelines. +It accepts user and client connections over various network protocols (i.e. HTTP, MQTT, WebSocket, CoAP), thus making a seamless bridge between them. It is used as the IoT middleware for building IoT solutions. + +In this guide, I'll walk you step-by-step through how to connect the BeagleV-Fire to Magistrala using MQTT and CoAP, authenticate your client, and publish messages to a topic. + +## What You Need + +- The BeagleV-Fire running Linux/RISC-V +- Magistrala cloned and running in your PC. + +## 1. Setting up and running Magistrala on your PC + +Setting up Magistrala is easy. Clone the repository from Github to your PC. + +```bash +git clone https://github.com/absmach/magistrala.git +cd magistrala +make run_latest +``` + +### Install the Magistrala CLI + +The cli makes it easy to to manage users, clients, channels and messages. It can be downloaded as separate asset from project realeses or it can be built. For our purposes we will build the CLI. + +Build the Magistrala cli and see the available commands using the commands. + +```bash +make cli +magistrala-cli health +``` + +### Create a User + +We start off by creating a user. + +```bash +magistrala-cli users create +``` + +example: + +```bash + magistrala-cli users create john doe johndoe@example.com johndoe 12345678 +``` + +Expected Response: + +```bash +{ + "created_at": "2025-02-11T16:15:12.607701Z", + "credentials": { + "username": "johndoe" + }, + "email": "johndoe@example.com", + "first_name": "jane", + "id": "26ae3198-6060-4308-824c-c846953b9898", + "last_name": "doe", + "role": "user", + "status": "enabled", + "updated_at": "0001-01-01T00:00:00Z" +} +``` + +### Get Access Token + +```bash +# command: magistrala-cli users token +# The command returns the user token.git status +# Then save the access token as USER_TOKEN +magistrala-cli users token johndoe 12345678 +export USER_TOKEN= +``` + +### Create a Domain + +```bash +# command: magistrala-cli domains create $USER_TOKEN +# This returns the domain ID +# Then save the domain ID as DOMAIN_ID +# export DOMAIN_ID= +magistrala-cli domains create "mydomain" "myalias" $USER_TOKEN +export DOMAIN_ID="56a4462e-5001-4bcf-b421-dbbe3d59c53c" +``` + +### Create a Client + +```bash +# command: magistrala-cli clients create '{"name":"client-name"}' $DOMAIN_ID $USER_TOKEN +# This command returns the client id and the client key +# Then save the client ID and client secret as CLIENT_ID and CLIENT_KEY +# export CLIENT_ID= +# export CLIENT_KEY= +magistrala-cli clients create '{"name":"client_name"}' $DOMAIN_ID $USER_TOKEN +export CLIENT_ID="bd2733d1-fcda-4974-bd7b-63b87a2e150f" +export CLIENT_KEY="6b648c99-d753-4ccb-9954-db6a504f0737" +``` + +### Create a Channel + +```bash +# command: magistrala-cli channels create '{"name":"channel-name"}' $DOMAIN_ID $USER_TOKEN +# This command returns the channel id +# Then save the channel ID as CHANNEL_ID +# export CHANNEL_ID= +magistrala-cli channels create '{"name":"mychannel"}' $DOMAIN_ID $USER_TOKEN +export CHANNEL_ID="0efb859c-f606-442d-9c9e-fd924cfee654" +``` + +### Connect Client to Channel + +```bash +magistrala-cli clients connect $CLIENT_ID $CHANNEL_ID '["publisher","subscriber"]' $DOMAIN_ID $USER_TOKEN +``` + +Magistrala setup is now complete. We now setup BeagleV Fire. + +## Setup the BeagleV Fire + +Power the BeagleV-Fire using the USB cable. Find the serial device and connect with your board using screen + +```bash +ls /dev/ttyUSB* /dev/ttyACM* +# Usually /dev/ttyUSB0 or /dev/ttyACM0 +sudo screen /dev/ttyUSB0 115200 +``` + +### Login to the terminal + +```bash +Username: beagle +Password: temppwd +``` + +Connect an Ethernet cable from the router to the Beagle and get an IP address: + +```bash +sudo dhcpcd eth0 +ip addr show eth0 +# Look for the inet line, e.g., 192.168.8.133 +``` + +With this the Board is connected to the internet and you can now install packages. + +### Install mosquitto-clients + +```bash +sudo apt update +sudo apt install mosquitto mosquitto-clients -y +``` + +Set the environment variables by configuring the connection details from the credentials acquired in the Magistrala setup. + +```bash +export MAGISTRALA_HOST= +# Magistrala runs in your PC Therefore use your PC's IP +export DOMAIN_ID="56a4462e-5001-4bcf-b421-dbbe3d59c53c" +export CHANNEL_ID="0efb859c-f606-442d-9c9e-fd924cfee654" +export CLIENT_ID="bd2733d1-fcda-4974-bd7b-63b87a2e150f" +export CLIENT_KEY="6b648c99-d753-4ccb-9954-db6a504f0737" +``` + +Test the connection. It should result to: + +```bash +ping -c 4 $MAGISTRALA_HOST + +PING () 56(84) bytes of data. +64 bytes from : icmp_seq=1 ttl=XX time=YY ms +64 bytes from : icmp_seq=2 ttl=XX time=YY ms +64 bytes from : icmp_seq=3 ttl=XX time=YY ms +64 bytes from : icmp_seq=4 ttl=XX time=YY ms + +--- ping statistics --- +4 packets transmitted, 4 received, 0% packet loss, time ZZZ ms +rtt min/avg/max/mdev = aaaa/bbbb/cccc/dddd ms +``` + +Now that the board is all setup and mosquitto is installed, we can connect to Magistrala. + +## MQTT Connection + +Using MQTT, on your PC terminal, subscribe to a topic with the following command: + +```bash +mosquitto_sub -u $CLIENT_KEY -P "" -t "m/$DOMAIN_ID/c/$CHANNEL_ID/messages" -h localhost -v +``` + +In this case, we have created a topic called messages and are subscribing to it . This will wait and display any messages published to this channel. + +### To publish messages on the BeagleV Fire terminal + +```bash +mosquitto_pub -u $CLIENT_KEY -P "" -t "m/$DOMAIN_ID/c/$CHANNEL_ID/messages" -h $MAGISTRALA_HOST -m '{"temperature": 25.5, "humidity": 60}' +``` + +The message should appear in your PC subscriber terminal. + +## CoAP Connection + +For this protocol we first need to install the CoAP CLI on your PC. + +```bash +git clone https://github.com/absmach/coap-cli.git +cd coap-cli +make all +scp ./build/coap-cli-linux-riscv64 beagle@:/home/beagle/coap-cli +# This sends the CoAP cli from your PC to the BeagleV board +``` + +### Publishing via CoAP from BeagleV side + +```bash +./coap-cli post m/$DOMAIN_ID/c/$CHANNEL_ID -a $CLIENT_KEY -H $MAGISTRALA_HOST -d '[{"bn":"coap-device:","n":"temperature","u":"Cel","v":25.5}]' +``` + +### Subscribing via CoAP from BeagleV side + +```bash +coap-cli get m/$DOMAIN_ID/c/$CHANNEL_ID -a $CLIENT_KEY -H $MAGISTRALA_HOST -o +``` + +With this, that is how you connect the BeagleV Fire to Magistrala and send messages via CoAP and MQTT. +Have fun with it. Happy Coding ;-)