espressif/esp-idf
1
0
Fork 1
mirror of https://github.com/espressif/esp-idf.git synced 2025-07-30 10:47:19 +02:00
Code Issues Packages Projects Releases Wiki Activity

doc: Update mqtt open source test server address

Browse Source
This commit is contained in:
yuanjm
2021-02-23 15:30:06 +08:00
committed by bot
parent 2d1e1c50e8
commit 3eceea7f5d
1 changed files with 11 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/en/api-reference/protocols/mqtt.rst
View File

@ -33,30 +33,30 @@ URI
- Curently support ``mqtt``, ``mqtts``, ``ws``, ``wss`` schemes - Curently support ``mqtt``, ``mqtts``, ``ws``, ``wss`` schemes
- MQTT over TCP samples: - MQTT over TCP samples:
- ``mqtt://mqtt.eclipse.org``: MQTT over TCP, default port 1883: - ``mqtt://mqtt.eclipseprojects.io``: MQTT over TCP, default port 1883:
- ``mqtt://mqtt.eclipse.org:1884`` MQTT over TCP, port 1884: - ``mqtt://mqtt.eclipseprojects.io:1884`` MQTT over TCP, port 1884:
- ``mqtt://username:password@mqtt.eclipse.org:1884`` MQTT over TCP, - ``mqtt://username:password@mqtt.eclipseprojects.io:1884`` MQTT over TCP,
port 1884, with username and password port 1884, with username and password
- MQTT over SSL samples: - MQTT over SSL samples:
- ``mqtts://mqtt.eclipse.org``: MQTT over SSL, port 8883 - ``mqtts://mqtt.eclipseprojects.io``: MQTT over SSL, port 8883
- ``mqtts://mqtt.eclipse.org:8884``: MQTT over SSL, port 8884 - ``mqtts://mqtt.eclipseprojects.io:8884``: MQTT over SSL, port 8884
- MQTT over Websocket samples: - MQTT over Websocket samples:
- ``ws://mqtt.eclipse.org:80/mqtt`` - ``ws://mqtt.eclipseprojects.io:80/mqtt``
- MQTT over Websocket Secure samples: - MQTT over Websocket Secure samples:
- ``wss://mqtt.eclipse.org:443/mqtt`` - ``wss://mqtt.eclipseprojects.io:443/mqtt``
- Minimal configurations: - Minimal configurations:
.. code:: c .. code:: c
const esp_mqtt_client_config_t mqtt_cfg = { const esp_mqtt_client_config_t mqtt_cfg = {
.uri = "mqtt://mqtt.eclipse.org", .uri = "mqtt://mqtt.eclipseprojects.io",
// .user_context = (void *)your_context // .user_context = (void *)your_context
}; };
esp_mqtt_client_handle_t client = esp_mqtt_client_init(&mqtt_cfg); esp_mqtt_client_handle_t client = esp_mqtt_client_init(&mqtt_cfg);
@ -69,15 +69,15 @@ URI
SSL SSL
^^^ ^^^
- Get certificate from server, example: ``mqtt.eclipse.org`` - Get certificate from server, example: ``mqtt.eclipseprojects.io``
``openssl s_client -showcerts -connect mqtt.eclipse.org:8883 </dev/null 2>/dev/null|openssl x509 -outform PEM >mqtt_eclipse_org.pem`` ``openssl s_client -showcerts -connect mqtt.eclipseprojects.io:8883 </dev/null 2>/dev/null|openssl x509 -outform PEM >mqtt_eclipse_org.pem``
- Check the sample application: ``examples/mqtt_ssl`` - Check the sample application: ``examples/mqtt_ssl``
- Configuration: - Configuration:
.. code:: c .. code:: c
const esp_mqtt_client_config_t mqtt_cfg = { const esp_mqtt_client_config_t mqtt_cfg = {
.uri = "mqtts://mqtt.eclipse.org:8883", .uri = "mqtts://mqtt.eclipseprojects.io:8883",
.event_handle = mqtt_event_handler, .event_handle = mqtt_event_handler,
.cert_pem = (const char *)mqtt_eclipse_org_pem_start, .cert_pem = (const char *)mqtt_eclipse_org_pem_start,
}; };