Arduino Library – pubsubclient
Installatie van Arduino IDE libraries: Arduino info
Informatie (ENG):
Arduino Client for MQTT
This library provides a client for doing simple publish/subscribe messaging with a server that supports MQTT.
Examples
The library comes with a number of example sketches. See File > Examples > PubSubClient within the Arduino application.
Full API documentation is available here: http://pubsubclient.knolleary.net
- It can only publish QoS 0 messages. It can subscribe at QoS 0 or QoS 1.
- The maximum message size, including header, is 128 bytes by default. This is configurable via
MQTT_MAX_PACKET_SIZEinPubSubClient.h. - The keepalive interval is set to 15 seconds by default. This is configurable via
MQTT_KEEPALIVEinPubSubClient.h. - The client uses MQTT 3.1.1 by default. It can be changed to use MQTT 3.1 by changing value of
MQTT_VERSIONinPubSubClient.h.
The library uses the Arduino Ethernet Client api for interacting with the underlying network hardware. This means it Just Works with a growing number of boards and shields, including:
- Arduino Ethernet
- Arduino Ethernet Shield
- Arduino YUN – use the included
YunClientin place ofEthernetClient, and be sure to do aBridge.begin()first - Arduino WiFi Shield – if you want to send packets > 90 bytes with this shield, enable the
MQTT_MAX_TRANSFER_SIZEdefine inPubSubClient.h. - Sparkfun WiFly Shield – library
- TI CC3000 WiFi – library
- Intel Galileo/Edison
- ESP8266
The library cannot currently be used with hardware based on the ENC28J60 chip – such as the Nanode or the Nuelectronics Ethernet Shield. For those, there is an alternative library available.
This code is released under the MIT License.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 |
2.6 Revert breaking change to callback signature 2.5 Add a library.json file for PlatformIO Handle dns failure on connect properly Made use of callback std::function ESP8266-specific Allow existing #-defines to be predefined 2.4 Add MQTT_SOCKET_TIMEOUT to prevent it blocking indefinitely whilst waiting for inbound data Fixed return code when publishing >256 bytes 2.3 Add publish(topic,payload,retained) function 2.2 Change code layout to match Arduino Library reqs 2.1 Add MAX_TRANSFER_SIZE def to chunk messages if needed Reject topic/payloads that exceed MQTT_MAX_PACKET_SIZE 2.0 Add (and default to) MQTT 3.1.1 support Fix PROGMEM handling for Intel Galileo/ESP8266 Add overloaded constructors for convenience Add chainable setters for server/callback/client/stream Add state function to return connack return code |