Skip to content

Commit 20c7857

Browse files
fix(iot): review faq (#4729)
* fix(iot): review faq * Update pages/iot-hub/faq.mdx * Update pages/iot-hub/faq.mdx Co-authored-by: ldecarvalho-doc <[email protected]> --------- Co-authored-by: ldecarvalho-doc <[email protected]>
1 parent 1255197 commit 20c7857

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

pages/iot-hub/faq.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,26 +5,26 @@ meta:
55
content:
66
h1: IoT Hub FAQ
77
dates:
8-
validation: 2024-09-19
8+
validation: 2025-03-27
99
category: managed-services
1010
productIcon: IotProductIcon
1111
---
1212

1313
## What is IoT Hub?
1414

1515
IoT Hub is an IoT Platform as a service, it sits between connected devices and business-specific software.
16-
Connected devices is the common name for all devices able to communicate over the internet (via Wi-Fi or 4G for instance). Connected devices are everywhere and can be used in a very broad range of applications. They can be smartphones, doorbells, light bulbs, refrigerators, cars, or TVs. Even a web browser can act as a connected device.
16+
Connected devices is the common name for all devices able to communicate over the internet (via Wi-Fi or 4G, for instance). Connected devices are everywhere and can be used in a very broad range of applications. They can be smartphones, doorbells, light bulbs, refrigerators, cars, or TVs. Even a web browser can act as a connected device.
1717

1818
[MQTT](https://mqtt.org/) is a lightweight and standardized publish/subscribe messaging transport protocol, designed for low-power usage, minimized data packets, and efficient distribution of information to one or many receivers. MQTT supports secure communication using TLS, and it is often used in IoT use cases.
1919
All kinds of connected devices supporting the MQTT protocol can be connected to IoT Hub. MQTT through WebSockets is also supported. There is no limitation to specific vendors.
20-
To learn more about what is a **Hub**, what is a **Device** and what is a **Route**, head over to our dedicated pages:
20+
To learn more about **Hubs**, **Devices*,* and **Routes**, head over to our dedicated pages:
2121

2222
* [Scaleway IoT Hub Overview](/iot-hub/quickstart/)
2323
* [Hub](/iot-hub/reference-content/hubs/)
2424
* [Device](/iot-hub/concepts/#device)
2525
* [Route](/iot-hub/concepts/#routes)
2626

27-
IoT Hub is only available at PAR1 (Paris, France) for the moment, other regions are planned.
27+
IoT Hub is only available in PAR1 (Paris, France).
2828

2929
## What are the differences between the IoT Hub offers?
3030

@@ -47,12 +47,12 @@ For devices not supporting secure connections, it is possible to also enable pla
4747

4848
## Can you detail what messages are?
4949
MQTT is a Publish/Subscribe protocol (more info on the MQTT protocol here).
50-
A message is the base unit for data transmission, it mainly contains:
50+
A message is the base unit for data transmission. It contains:
5151

5252
- a **topic**: the message information type identifier, such as fr/paris/weather. Devices that have subscribed to a topic will receive any message published to this topic.
5353
- a **payload**: the actual data to be transmitted. Can be anything (temperature, image, notification, …) in any format (binary, xml, json, yaml, …)
5454

55-
The Hub will provide an endpoint to connect the devices to and supports the following protocols:
55+
The Hub will provide an endpoint to connect the devices to, and supports the following protocols:
5656

5757
- `MQTTs`: `MQTT` over `TLS`, port `8883`
5858
- `MQTT`: Plaintext `MQTT`, port `1883`
@@ -67,7 +67,7 @@ It must also be used as the MQTT Client Identifier field during connection.
6767
If your software doesn't have a setting for Client ID, you can use the Device ID in the Username field instead. If no Device ID is found in the client ID field, but it is present in the Username field, the one used in the Username field will be used as the Client ID.
6868

6969
## My software/library limits MQTT client ID to 23 characters, what should I do?
70-
MQTT's specifications state The Server MUST allow ClientIds which are between 1 and 23 UTF-8 encoded bytes in length and The Server MAY allow ClientId's that contain more than 23 encoded bytes. Certain software/libraries restrict MQTT client ID field to 23 characters **maximum**.
70+
MQTT's specifications state The Server MUST allow ClientIds which are between 1 and 23 UTF-8 encoded bytes in length. The Server MAY allow ClientId's that contain more than 23 encoded bytes. Certain software/libraries restrict the MQTT client ID field to 23 characters **maximum**.
7171

7272
If you fall into this situation, you can type your Device ID in the MQTT Username field. If no valid Device ID is found in the MQTT client ID field, but one is found in the MQTT Username field, the one found in the Username field will be used as the client ID.
7373

@@ -86,7 +86,7 @@ When creating a “shared” Hub, your Devices connect to the same message broke
8686
On a dedicated or High-Availability Hub, you are the only customer on the message brokers, you can access this topic subtree.
8787

8888
## How are messages billed?
89-
Any MQTT message between the Hub and a Device will be billed. If the message is bigger than 4 kB, then each 4 kB chunk of the message will be counted billed as one message. For example, a 9 kB message will be billed as 3 messages.
89+
Any MQTT message between the Hub and a Device will be billed. If the message is bigger than 4 kB, then each 4 kB chunk of the message will be counted as a message for billing purposes. For example, a 9 kB message will be billed as 3 messages.
9090

9191
## What is the maximum message size?
9292
The maximum size for a message is 4 MB.

0 commit comments

Comments
 (0)