hybridgroup.gobot/platforms/mqtt
Thomas Kohler 3039b2c7cb
test(all): switch to test package stretchr testify (#1006)
2023-10-20 10:27:09 +02:00
..
LICENSE Build(v2): revert move to v2 subfolder (#932) 2023-05-29 19:23:28 +02:00
README.md core(build): CLI removed (#946) 2023-06-04 18:36:55 +02:00
doc.go core(build): CLI removed (#946) 2023-06-04 18:36:55 +02:00
mqtt_adaptor.go ble: simplify and substitute errors.Wrap() (#958) 2023-06-14 18:27:22 +02:00
mqtt_adaptor_test.go test(all): switch to test package stretchr testify (#1006) 2023-10-20 10:27:09 +02:00
mqtt_driver.go Build(v2): revert move to v2 subfolder (#932) 2023-05-29 19:23:28 +02:00
mqtt_driver_test.go test(all): switch to test package stretchr testify (#1006) 2023-10-20 10:27:09 +02:00

README.md

MQTT

MQTT is an Internet of Things connectivity protocol featuring a lightweight publish/subscribe messaging transport. It is useful for its small code footprint and minimal network bandwidth usage.

This repository contains the Gobot adaptor/driver to connect to MQTT servers. It uses the Paho MQTT Golang client package (https://eclipse.org/paho/) created and maintained by the Eclipse Foundation (https://github.com/eclipse) thank you!

For more info about the MQTT machine to machine messaging standard, go to http://mqtt.org/.

How to Install

Please refer to the main README.md

How to Use

Before running the example, make sure you have an MQTT message broker running somewhere you can connect to

package main

import (
  "gobot.io/x/gobot/v2"
  "gobot.io/x/gobot/v2/platforms/mqtt"
  "fmt"
  "time"
)

func main() {
  mqttAdaptor := mqtt.NewAdaptor("tcp://0.0.0.0:1883", "pinger")

  work := func() {
    mqttAdaptor.On("hello", func(msg mqtt.Message) {
      fmt.Println(msg)
    })
    mqttAdaptor.On("hola", func(msg mqtt.Message) {
      fmt.Println(msg)
    })
    data := []byte("o")
    gobot.Every(1*time.Second, func() {
      mqttAdaptor.Publish("hello", data)
    })
    gobot.Every(5*time.Second, func() {
      mqttAdaptor.Publish("hola", data)
    })
  }

  robot := gobot.NewRobot("mqttBot",
    []gobot.Connection{mqttAdaptor},
    work,
  )

  robot.Start()
}

Supported Features

  • Publish messages
  • Respond to incoming message events

License

Copyright (c) 2013-2018 The Hybrid Group. Licensed under the Apache 2.0 license.