xref: /aosp_15_r20/external/libwebsockets/minimal-examples/mqtt-client/minimal-mqtt-client/README.md (revision 1c60b9aca93fdbc9b5f19b2d2194c91294b22281)
1*1c60b9acSAndroid Build Coastguard Worker# lws minimal MQTT client
2*1c60b9acSAndroid Build Coastguard Worker
3*1c60b9acSAndroid Build Coastguard WorkerThe application connects to a broker at localhost 1883 (unencrypted) or
4*1c60b9acSAndroid Build Coastguard Worker8883 (tls)
5*1c60b9acSAndroid Build Coastguard Worker
6*1c60b9acSAndroid Build Coastguard Worker## build
7*1c60b9acSAndroid Build Coastguard Worker
8*1c60b9acSAndroid Build Coastguard Worker```
9*1c60b9acSAndroid Build Coastguard Worker $ cmake . && make
10*1c60b9acSAndroid Build Coastguard Worker```
11*1c60b9acSAndroid Build Coastguard Worker
12*1c60b9acSAndroid Build Coastguard Worker## usage
13*1c60b9acSAndroid Build Coastguard Worker
14*1c60b9acSAndroid Build Coastguard WorkerCommandline option|Meaning
15*1c60b9acSAndroid Build Coastguard Worker---|---
16*1c60b9acSAndroid Build Coastguard Worker-d <loglevel>|Debug verbosity in decimal, eg, -d15
17*1c60b9acSAndroid Build Coastguard Worker-s| Use tls and connect to port 8883 instead of 1883
18*1c60b9acSAndroid Build Coastguard Worker
19*1c60b9acSAndroid Build Coastguard WorkerStart mosquitto server locally
20*1c60b9acSAndroid Build Coastguard Worker
21*1c60b9acSAndroid Build Coastguard Worker```
22*1c60b9acSAndroid Build Coastguard Worker$ mosquitto
23*1c60b9acSAndroid Build Coastguard Worker```
24*1c60b9acSAndroid Build Coastguard Worker
25*1c60b9acSAndroid Build Coastguard WorkerRun the example
26*1c60b9acSAndroid Build Coastguard Worker
27*1c60b9acSAndroid Build Coastguard Worker```
28*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:23:7789] U: LWS minimal MQTT client unencrypted [-d<verbosity>][-s]
29*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:23:8539] N: lws_mqtt_generate_id: User space provided a client ID 'lwsMqttClient'
30*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:23:9893] N: _lws_mqtt_rx_parser: migrated nwsi 0x50febd0 to sid 1 0x5106820
31*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:23:9899] U: callback_mqtt: MQTT_CLIENT_ESTABLISHED
32*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:23:9967] U: callback_mqtt: WRITEABLE: Subscribing
33*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:24:0068] U: callback_mqtt: MQTT_SUBSCRIBED
34*1c60b9acSAndroid Build Coastguard Worker```
35*1c60b9acSAndroid Build Coastguard Worker
36*1c60b9acSAndroid Build Coastguard WorkerSend something to the test client
37*1c60b9acSAndroid Build Coastguard Worker
38*1c60b9acSAndroid Build Coastguard Worker
39*1c60b9acSAndroid Build Coastguard Worker```
40*1c60b9acSAndroid Build Coastguard Workermosquitto_pub -h 127.0.0.1 -p 1883 -t test/topic0 -m "hello"
41*1c60b9acSAndroid Build Coastguard Worker```
42*1c60b9acSAndroid Build Coastguard Worker
43*1c60b9acSAndroid Build Coastguard WorkerObserve it received at the test client
44*1c60b9acSAndroid Build Coastguard Worker
45*1c60b9acSAndroid Build Coastguard Worker```
46*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:27:1845] U: callback_mqtt: MQTT_CLIENT_RX
47*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:27:1870] N:
48*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:27:1945] N: 0000: 74 65 73 74 2F 74 6F 70 69 63 30                   test/topic0
49*1c60b9acSAndroid Build Coastguard Worker[2020/01/31 10:40:27:1952] N:
50*1c60b9acSAndroid Build Coastguard Worker
51*1c60b9acSAndroid Build Coastguard Worker```
52