ubidots particle

อนุภาค

ที่นี่คุณจะได้เรียนรู้วิธีส่งข้อมูลไปยัง Ubidots โดยใช้อุปกรณ์ Particle Photon หรือ Electron คุณเพียงแค่ต้องมีป้ายกำกับตัวแปรและค่าที่คุณต้องการส่งพร้อมกับ TOKEN ที่ถูกต้องของ Ubidots นอกจากนี้คุณยังสามารถรับค่าสุดท้ายของตัวแปรจากบัญชี Ubidots ของคุณได้

ความต้องการ

• อุปกรณ์อนุภาค
• สายไมโครยูเอสบี
• การเชื่อมต่ออินเทอร์เน็ต
• หมายเหตุ: สำหรับไลบรารีเวอร์ชันล่าสุดจำเป็นต้องมีอุปกรณ์อนุภาคที่มีเฟิร์มแวร์เวอร์ชัน 0.7.0 ขึ้นไป

ตั้งค่า

1. ตั้งค่าการเชื่อมต่อ WiFi กับโฟตอน มีสองวิธีในการทำเช่นนี้:
   • การใช้สมาร์ทโฟนของคุณ
   • การเชื่อมต่อกับคอมพิวเตอร์ของคุณผ่าน USB
2. หลังจากรับสิทธิ์ Photon และตั้งค่าบัญชี Ubidots แล้ว ไปที่ Particle's Web IDE
   • ใน Web IDE ของ Particle ให้สร้างแอปใหม่และตั้งชื่อ
   • ไปที่แท็บห้องสมุด
   • ในไลบรารีที่สนับสนุนให้เขียน Ubidots และเลือกไลบรารี Ubidots
   • คลิกที่ รวมในแอป และกลับไปที่ "MYAPP.ino"

ไลบรารีนี้สร้างขึ้นตามค่าเริ่มต้นแหล่งข้อมูลใหม่ ชื่อของแหล่งข้อมูลนี้จะเป็น "อนุภาค" โดยค่าเริ่มต้น และป้ายกำกับของเขาจะเป็นรหัสอนุภาคของคุณ

วิธีการเริ่มต้นคือ TCP หากคุณต้องการเปลี่ยนให้ไปที่ส่วนคุณสมบัติแล้วทำตามตัวอย่าง

คำเตือน: เกี่ยวกับอนุภาคตาข่าย

หลังจากการประกาศเลิกใช้งานโปรโตคอล Particle Mesh IoT เนื่องจาก Particle ไม่ได้ผลิตหน่วย Mesh อีกต่อไป Ubidots จึงตัดสินใจหยุดให้การสนับสนุนทันทีในไลบรารีนี้ หากคุณยังคงจำเป็นต้องใช้โปรโตคอล Mesh IoT ในโปรเจ็กต์ของคุณร่วมกับไลบรารีของเรา โปรดคอมไพล์โปรเจ็กต์ของคุณผ่าน Particle CLI ด้วยเวอร์ชัน v3.1.4 ของไลบรารีนี้

เอกสารประกอบ

ตัวสร้าง

อุบิดอท

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

• @โทเค็น [จำเป็น] TOKEN บัญชีเฉพาะ Ubidots ของคุณ
• @server, [ไม่บังคับ], [ตัวเลือก] = [ UBI_INDUSTRIAL ], [ค่าเริ่มต้น] = UBI_INDUSTRIAL
• @iot_protocol, [ไม่บังคับ], [ตัวเลือก] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [ค่าเริ่มต้น] = UBI_TCP โปรโตคอล IoT ที่คุณจะใช้ในการส่งหรือดึงข้อมูล

สร้างอินสแตนซ์ Ubidots

หมายเหตุ

• UBI_PARTICLE ส่งข้อมูลโดยใช้ webhook ดังนั้นโปรดปฏิบัติตามคำแนะนำเพื่อตั้งค่า webhook ของคุณอย่างถูกต้องที่นี่

วิธีการ

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

• @variable_label, [จำเป็น]. ป้ายกำกับของตัวแปรที่จะจัดเก็บจุด
• @value, [จำเป็น]. ค่าของจุด
• @context [ไม่บังคับ] บริบทของจุด
• @dot_timestamp_seconds [ไม่บังคับ] การประทับเวลาของจุดเป็นวินาที
• @dot_timestamp_millis [ไม่บังคับ] จำนวนการประทับเวลาของจุดเป็นมิลลิวินาที หากไม่ได้ตั้งค่ามิลลิวินาทีของการประทับเวลา วินาทีจะคูณด้วย 1,000

เพิ่มจุดที่มีค่าที่เกี่ยวข้อง บริบท และการประทับเวลาที่จะส่งไปยังแหล่งข้อมูลบางแห่ง เมื่อคุณใช้ add()

สิ่งสำคัญ: ความยาวเพย์โหลดสูงสุดคือ 700 ไบต์ หากเพย์โหลดของคุณมากกว่านั้น ระบบจะไม่ส่งอย่างถูกต้อง คุณสามารถเห็นเพย์โหลดที่จะส่งบนคอนโซลอนุกรมของคุณหากคุณเรียกใช้เมธอด setDebug(bool debug) และส่งค่าจริงไป

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

• @device_label [จำเป็น] ป้ายกำกับอุปกรณ์ซึ่งมีตัวแปรสำหรับดึงค่า
• @variable_label, [จำเป็น]. ป้ายกำกับตัวแปรที่จะดึงค่ามา

ส่งคืนค่าลอยของค่าสุดท้ายของจุดจากตัวแปร IotProtocol รับ CloudProtocol()

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

• @deviceLabel ตัวชี้ [บังคับ] ที่เก็บป้ายกำกับของอุปกรณ์เพื่อดึงค่า
• @variableLabels [บังคับ] เครื่องหมายจุลภาคคั่นป้ายกำกับตัวแปรเพื่อดึงค่ามา

ส่งคืนรายการแผนที่เรียงลำดับพร้อมค่าที่ดึงมาสำหรับป้ายกำกับตัวแปรที่ให้มา ค่าต่างๆ สามารถเข้าถึงได้ด้วยดัชนี โดยเริ่มต้นที่ตำแหน่ง 0 และแมปกับป้ายกำกับตัวแปรทุกชุดที่ตั้งค่าในอาร์เรย์ที่คั่นด้วยเครื่องหมายจุลภาค

 void addContext(char *key_label, char *key_value)

• @key_label [จำเป็น] ป้ายกำกับบริบทที่สำคัญในการจัดเก็บค่า
• @key_value [จำเป็น] ค่าคู่คีย์

เพิ่มคีย์บริบท-ค่าคีย์ใหม่ลงในหน่วยความจำภายในเครื่อง อินพุตวิธีการจะต้องเป็นตัวชี้ถ่าน วิธีการนี้อนุญาตให้จัดเก็บคู่คีย์-ค่าได้มากถึง 10 คู่

 void getContext(char *context)

• @บริบท [จำเป็น] ตัวชี้ถ่านที่จะจัดเก็บบริบท

สร้างบริบทตามโปรโตคอลที่เลือกและจัดเก็บไว้ในตัวชี้อักขระบริบท

 void setDebug(bool debug);;

• @debug [จำเป็น] ประเภทบูลีนสำหรับปิด/เปิดข้อความแก้ไขข้อบกพร่อง

สร้างข้อความดีบักที่พร้อมใช้งานผ่านพอร์ตอนุกรม

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

• @device_label, [ไม่บังคับ], [ค่าเริ่มต้น] = รหัสอุปกรณ์ของอนุภาค ป้ายอุปกรณ์ในการส่งข้อมูล หากไม่ได้ตั้งค่า ระบบจะใช้ PARTICLE DEVICE ID
• @device_name, [ไม่บังคับ], [ค่าเริ่มต้น] = @device_label ชื่ออุปกรณ์ที่กำหนดหากอุปกรณ์ไม่มีอยู่ในบัญชี Ubidots ของคุณ หากไม่ได้ตั้งค่า ระบบจะใช้พารามิเตอร์ป้ายกำกับอุปกรณ์ หมายเหตุ : ชื่ออุปกรณ์ได้รับการสนับสนุนผ่าน TCP/UDP เท่านั้น หากคุณใช้โปรโตคอลอื่น ชื่ออุปกรณ์จะเหมือนกับป้ายกำกับอุปกรณ์
• @flags, [ไม่บังคับ], [ตัวเลือก] = [ PUBLIC , PRIVATE , WITH_ACK , NO_ACK ] ธง webhook ของอนุภาค

ส่งข้อมูลทั้งหมดที่เพิ่มโดยใช้ add() วิธีการ คืนค่าเป็นจริงหากข้อมูลถูกส่ง

 IotProtocol getCloudProtocol();

ดึงโปรโตคอลคลาวด์จริงที่ใช้ในการส่งข้อมูลจากเกตเวย์ Mesh

ตัวอย่าง

โปรดดูโฟลเดอร์ตัวอย่าง