Unduhan ubidots particle - unduhan kode sumber ubidots particle

ubidots particle

Kategori lainnya

v3.1.4

Unduh

Partikel

Di sini Anda akan mempelajari cara mengirim data ke Ubidots menggunakan perangkat Particle Photon atau Electron. Anda hanya memerlukan label variabel dan nilai yang ingin Anda kirimkan beserta TOKEN valid Ubidots. Selain itu, Anda bisa mendapatkan nilai terakhir suatu variabel dari akun Ubidots Anda.

Persyaratan

Perangkat Partikel
Kabel mikro USB
Koneksi internet
Catatan: Untuk versi terakhir perpustakaan diperlukan perangkat partikel Anda dengan firmware versi 0.7.0 atau lebih tinggi.

Pengaturan

Siapkan koneksi WiFi ke foton. Ada dua cara untuk melakukan ini:
- Menggunakan ponsel pintar Anda.
- Menghubungkannya ke komputer Anda melalui USB.
Setelah mengklaim Foton Anda dan menyiapkan akun Ubidots Anda, mari buka IDE Web Partikel.
- Di IDE Web Partikel, buat aplikasi baru dan tetapkan namanya.
- Buka tab perpustakaan.
- Di perpustakaan yang dikontribusikan, tulis Ubidots dan pilih perpustakaan Ubidots.
- Klik TERMASUK DALAM APLIKASI . Dan kembali ke "MYAPP.ino"

Pustaka ini secara default membuat Sumber Data baru. Nama sumber data ini akan menjadi "Partikel" secara default, dan labelnya akan menjadi ID Partikel Anda.

Metode defaultnya adalah TCP, jika Anda ingin mengubahnya, buka bagian fitur dan ikuti contohnya.

Peringatan: Tentang Partikel Mesh

Setelah pengumuman penghentian protokol Particle Mesh IoT, karena Particle tidak lagi memproduksi unit Mesh, Ubidots memutuskan untuk berhenti mendukungnya secara langsung di perpustakaan ini. Jika Anda masih perlu menggunakan protokol Mesh IoT dalam proyek Anda bersama dengan perpustakaan kami, harap kompilasi proyek Anda melalui Particle CLI dengan versi v3.1.4 dari perpustakaan ini.

Dokumentasi

Konstruktor

Ubidot

 Ubidots(char* token, UbiServer server, IotProtocol iot_protocol)

@token, [Wajib]. TOKEN akun unik Ubidots Anda.
@server, [Opsional], [Pilihan] = [ UBI_INDUSTRIAL ], [Default] = UBI_INDUSTRIAL .
@iot_protocol, [Opsional], [Opsi] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [Default] = UBI_TCP . Protokol IoT yang akan Anda gunakan untuk mengirim atau mengambil data.

Membuat instance Ubidots.

CATATAN

UBI_PARTICLE mengirimkan data menggunakan webhook, jadi pastikan untuk mengikuti petunjuk untuk menyiapkan webhook Anda dengan benar di sini.

Metode

 void add(char *variable_label, float value, char *context, unsigned long dot_timestamp_seconds, unsigned int dot_timestamp_millis)

@variable_label, [Wajib]. Label variabel tempat titik akan disimpan.
@nilai, [Wajib]. Nilai titik.
@konteks, [Opsional]. Konteks titik tersebut.
@dot_timestamp_seconds, [Opsional]. Stempel waktu titik dalam hitungan detik.
@dot_timestamp_millis, [Opsional]. Jumlah stempel waktu titik dalam milidetik. Jika nilai milidetik stempel waktu tidak disetel, detik akan dikalikan dengan 1000.

Menambahkan titik dengan nilai terkait, konteks, dan stempel waktu untuk dikirim ke sumber data tertentu, setelah Anda menggunakan add().

Penting: Panjang payload maksimal adalah 700 byte, jika payload Anda lebih besar maka payload tidak akan terkirim dengan benar. Anda dapat melihat di konsol serial payload yang akan dikirim jika Anda memanggil metode setDebug(bool debug) dan memberikan nilai sebenarnya ke metode tersebut.

 float get(const char* device_label, const char* variable_label)

@device_label, [Wajib]. Label perangkat yang berisi variabel untuk mengambil nilai.
@variable_label, [Wajib]. Label variabel untuk mengambil nilai.

Mengembalikan sebagai float nilai terakhir titik dari variabel. IotProtocol dapatkanCloudProtocol()

 std::map<int, float> tcpMap getMultipleValues(const char* deviceLabel, const char* variableLabels)

@deviceLabel penunjuk [Wajib] yang menyimpan label perangkat untuk mengambil nilai.
@variableLabels [Wajib] label variabel yang dipisahkan koma untuk mengambil nilai

Mengembalikan daftar peta yang diurutkan dengan nilai yang diambil untuk label variabel yang disediakan. Nilai dapat diakses berdasarkan indeks, dimulai dari posisi 0, dan dipetakan ke setiap kumpulan label variabel dalam larik yang dipisahkan koma.

 void addContext(char *key_label, char *key_value)

@key_label, [Wajib]. Label konteks kunci untuk menyimpan nilai.
@key_value, [Wajib]. Nilai pasangan kunci.

Menambahkan kunci konteks nilai kunci baru ke memori lokal. Input metode harus berupa pointer char. Metode ini memungkinkan untuk menyimpan hingga 10 pasangan nilai kunci.

 void getContext(char *context)

@konteks, [Wajib]. Penunjuk karakter tempat konteks akan disimpan.

Membangun konteks sesuai dengan protokol yang dipilih dan menyimpannya dalam penunjuk karakter konteks.

 void setDebug(bool debug);;

@debug, [Wajib]. Ketik Boolean untuk mematikan/menghidupkan pesan debug.

Sediakan pesan debug melalui port serial.

 bool send(const char* device_label, const char* device_name, PublishFlags flags);

@device_label, [Opsional], [Default] = ID PERANGKAT PARTIKEL. Label perangkat untuk mengirim data. Jika tidak disetel, ID PERANGKAT PARTIKEL akan digunakan.
@nama_perangkat, [Opsional], [Default] = @label_perangkat. Nama perangkat ditetapkan jika perangkat tersebut belum ada di akun Ubidots Anda. Jika tidak disetel, parameter label perangkat akan digunakan. CATATAN : Nama perangkat hanya didukung melalui TCP/UDP, jika Anda menggunakan protokol lain, nama perangkat akan sama dengan label perangkat.
@flags, [Opsional], [Opsi] = [ PUBLIC , PRIVATE , WITH_ACK , NO_ACK ]. Bendera webhook partikel.

Mengirimkan semua data yang ditambahkan menggunakan metode add(). Mengembalikan nilai benar jika data dikirim.