İlk cihazınızı bağlayın

Bu sayfa, erişim belirteciyle oturum açan bir cihazı bağlar. Yaklaşık beş dakika sürer. Gerçek cihazı kullanabilir ya da onun yerine bir MQTT istemcisi veya curl bulunan bir bilgisayarı kullanabilirsiniz. LoRaWAN sensörleri için bunun yerine İlk LoRaWAN sensörünüzü bağlayın bölümünü izleyin; lisanslı cihazlar için Cihaz ekleme ve sahiplenme bölümüne bakın.

Gerekenler

• Admin veya Owner rolü (cihaz oluşturma ve cihaz kimlik bilgilerini yönetme izni).
• TLS destekli bir MQTT 3.1.1 istemcisi veya curl. Örneklerde, cihaz sayfasında da gösterilen istemci olan mosquitto_pub kullanılır.
• TCP 8883 (TLS üzerinden MQTT) veya 443 (HTTPS) portuna giden erişim.

1. Cihazı ekleyin

1. IoT menüsünde Devices öğesini açın.
2. New device öğesini seçin. Birden fazla yöntem sunulduğunda çekmece What are you adding? sorusunu sorar; Other device seçeneğini belirleyin (“Diğer herhangi bir cihaz: ona bir ad ve profil verin, bir erişim belirteci alır.”).
3. Formu doldurun:

Alan	Girilecek değer
Name	Kuruluşunuzda benzersiz bir ad, örneğin boiler-07. Zorunlu, en fazla 128 karakter.
Label	İsteğe bağlı serbest metin, örneğin Boiler room, north.
Device profile	Şimdilik The default profile seçili kalsın. Cihazı daha sonra başka bir profile taşıyabilirsiniz.
This device is a gateway	Kapalı bırakın. Yalnızca başka cihazlar adına veri ileten bir cihaz için açın.

1. Create device öğesini seçin.

Çekmece New secret: Copy it now: it is shown once and cannot be read back. uyarısını, cihazın Access token değerini ve örnek satırlarında belirteci zaten içeren bir Connection details kartını gösterir.

Hiç belirteç gösterilmiyorsa, kuruluşunuz Issue an access token for new devices seçeneğini kapatmıştır (Devices > ⋯ > Settings). Bu durumda cihaz kimlik bilgisi olmadan oluşturulur; bkz. Device credentials.

2. Bağlantı ayrıntılarını okuyun

Connection details kartı şunları listeler:

Öğe	Anlamı
MQTT broker	Cihazın bağlandığı ana makine ve port.
Security	TLS (mqtts): the server certificate is a public one, ya da profil izin veriyorsa düz MQTT.
Login	Username = the access token, password empty, any client ID
Telemetry topic ve Attributes topic	Cihazın yayın yaptığı konular.
Commands (subscribe)	Cihazın komutları dinlediği konular.
HTTPS telemetry ve Header	HTTPS kullanan cihazlar için adres ve başlık.
Example message (JSON), Send it with mosquitto_pub, Send it with curl	Kopyalayıp çalıştırabileceğiniz satırlar.

Daha sonra yöneticiler aynı kartı cihazın Credentials sekmesinde bulur (belirteç yerine bir yer tutucu ile).

3. MQTT üzerinden bir mesaj gönderin

Kullanıcı adı olarak belirteci, parola alanını boş bırakarak oturum açın, ardından QoS 1 ile v1/telemetry konusuna bir JSON nesnesi yayınlayın:

mosquitto_pub -h <broker host> -p 8883 \
  --capath /etc/ssl/certs \
  -u "<ACCESS_TOKEN>" \
  -i boiler-07 \
  -q 1 \
  -t v1/telemetry \
  -m '{"temperature": 21.5, "humidity": 40}'

• Kartta gösterilen ana makine adını kullanın. TLS, IP adresi değil ad gerektirir.
• İstemci kimliği, A–Z a–z 0–9 . _ : - karakterlerinden oluşan 1 ila 64 karakter olabilir.
• Hermetry her anahtarı kendi serisi olarak saklar ve değerleri alındıkları zamanla damgalar.

3b. Ya da HTTPS üzerinden gönderin

curl -X POST "https://<device host>/api/v1/telemetry" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"temperature": 21.5, "humidity": 40}'

Boş gövdeli 200 yanıtı, mesajın kabul edildiği anlamına gelir. Bkz. Device HTTP API.

4. Ulaştığını kontrol edin

1. Devices öğesini açın ve cihazın adını seçin.
2. Bir MQTT oturumu açık olduğunda Connection sütunu ve cihaz başlığı Online gösterir (varsayılan profilin Live connection kuralında). Yalnızca HTTP kullanan ve bu kurala tabi bir cihaz hiçbir zaman çevrimiçi görünmez; bkz. Connection status and activity.
3. Telemetry sekmesini açın. Latest values tablosu, temperature ve humidity değerlerini zamanlarıyla listeler.
4. Sayısal bir anahtarı işaretleyin ve Last hour ile Last 7 days arasındaki eğilimini görmek için Chart öğesini kullanın.

Grafiğin hareketini görmek için farklı değerlerle birkaç mesaj daha gönderin.

Hiçbir şey ulaşmıyorsa

Belirti	Olası neden
İstemci “bad username or password” (CONNACK 4) diyor.	Belirteç yanlış ya da yenilenmiş.
İstemci “not authorised” (CONNACK 5) diyor.	Cihaz devre dışı ya da profil bu oturum açma türüne, bu ağa izin vermiyor ya da TLS gerektiriyor. Nedeni cihazın Log sekmesine yazılır.
1883 portundaki bağlantı reddediliyor.	Profil TLS gerektiriyor. 8883 portunu kullanın.
TLS el sıkışması başarısız oluyor.	IP adresiyle bağlandınız ya da istemcinizde CA paketi yok. Ana makine adını ve sistemin CA deposunu kullanın.
HTTP 401 yanıtı veriyor.	Authorization: Bearer başlığı eksik ya da belirteç yanlış.
Cihaz çevrimiçi görünüyor ama hiçbir değer gözükmüyor.	Yük bir JSON nesnesi değil ya da bir anahtar anahtar kurallarını bozuyor (örneğin _ veya fw_ ile başlıyor). Bkz. MQTT topics and payload reference.

Daha fazla neden A device does not connect ve Data does not arrive sayfalarında listelenir.

Ne yaptınız

• TLS gerektiren ve erişim belirteçlerini kabul eden varsayılan profilde bir cihaz oluşturdunuz.
• Cihaz belirteciyle oturum açtı ve telemetri yayınladı.
• Her mesaj, kuruluşunuzun aylık mesaj kotasına sayılır. Bkz. Message quota and usage.

Sonraki adım

İlk panonuzu oluşturun.