UserID: 

 Last logged in: 


For English language. 

APIs IoTtweet.com

การใช้งานคำสั่งต่างๆใน APIs ของ IoTtweet

   สวัสดีครับ ผู้ใช้งาน IoTtweet.com ทุกท่าน ขอบพระคุณที่เข้ามาใช้งานการเก็บข้อมูลและควบคุมอุปกรณ์ Internet of Things ผ่านทางหน้า
dashboard ของเรา ในบทความนี้จะอธิบายถึงการใช้งานในแต่ละคำสั่งของ IoTtweet Library ที่จะทำการเชื่อมต่อเข้ากับระบบการทำงานของ IoTtweet server
ตั้งแต่การ Connect WiFi, การส่งข้อมูลจาก IoT มายังหน้า Dashboad, การควบคุมอุปกรณ์ IoT ของคุณผ่าน Switch และ Slider จากหน้า Dashboard
รายละเอียดทั้งหมด สามารถอ่านได้จากด้านล่างนี้เลยครับ

แต่ก่อนอื่น, ต้องทำการดาวน์โหลด IoTtweet library จาก Github:IoTtweet มาบันทึกลงในเครื่องกันก่อนนะครับ. ถ้าใครใช้ Arduino IDE,
ให้ save โฟลเดอร์ที่ชื่อ IoTtweet ซึ่งภายในจะบรรจุไฟล์ 2 ตัวคือ IoTtweet.h และ IoTtweet.cpp. Save ทั้งโฟลเดอร์นี้ไว้ที่ Arduino > libraries ครับ



WiFi connecting command

การเชื่อมต่อ WiFi network

.begin(ssid,password);


ตัวแปรในคำสั่ง ประเภทของข้อมูล ความหมาย
SSID const char ชื่อของเครือข่าย WiFi ที่คุณต้องการเชื่อมต่อกับ IoT device.
Password const char รหัสผ่านของเครือข่าย WiFi ที่คุณต้องการเชื่อมต่อ.

ผลลัพธ์ ประเภทของข้อมูลที่ส่งกลับมา ค่าที่ส่งกลับมา
สามารถเชื่อมต่อ WiFi ได้สำเร็จ bool true
ไม่สามารถทำการเชื่อมต่อ WiFi ได้ bool false


การส่งข้อมูลจาก IoT มายัง Dashboard

การส่งข้อมูลจาก IoT device ไปยัง Dashboard IoTtweet

จากไฟล์ที่เราดาวน์โหลดมาจาก Github:IoTtweet, ในนั้นจะมีไฟล์ Example อยู่ด้วยครับ และในแต่ละไฟล์ ก็จะมีคำสั่งการใช้งานดังนี้.


.WriteDashboard(userid,key,data0,data1,data2,data3,private_tweet,public_tweet);


ตัวแปรในคำสั่ง ประเภทของข้อมูล ความหมาย
userid const char เลขประจำตัวผู้ใช้งานของสมาชิก IoTtweet.com, เลขนี้จะมีความยาว 6 หลัก เช่น 000001 เป็นต้น.
key const char รหัสประจำอุปกรณ์ของเรา ที่ได้จากการลงทะเบียนในระบบ "My IoT garage".
data0-data3 float ข้อมูลตัวเลขแบบมีทศนิยม ที่เราต้องการส่งขึ้นไปเก็บในฐานข้อมูล และแสดงผลบนกราฟในหน้า dashboard.
private_tweet const char ข้อความที่ต้องการส่งไปแสดงผลบนหน้า dashboard เป็นแบบส่วนตัว.
public_tweet const char ข้อความที่ต้องการส่งไปแสดงผลบนหน้า dashboard เป็นแบบสาธารณะ(User ผู้อืนจะสามารถเห็นได้จากหน้า Home ของ IoTtweet.com).

ผลลัพธ์ ประเภทของข้อมูลที่ส่งกลับมา ค่าที่ส่งกลับมา
สร้างฐานข้อมูลได้สำเร็จ (จะแสดงเฉพาะครั้งแรกที่ส่งข้อมูลมายัง IoTtweet) JSON {"iottweet":[{"create":"success"}]}
บันทึกข้อมูลลงฐานข้อมูลได้สำเร็จ JSON {"iottweet":[{"record":"success"}]}

[คำแนะนำ]
สำหรับการส่งข้อมูลมายังฐานข้อมูลบน IoTtweet, ในการส่งแต่ละครั้ง ควรจะเว้นระยะเวลาในการส่งอย่างน้อย 15 วินาที.
เพื่อป้องกันการบันทึกข้อมูลลงฐานข้อมูลผิดพลาด.




การควบคุมอุปกรณ์ IoT จาก Dashboard


การควบคุมผ่านทาง Switch และ Slider บน Dashboard

บน Dashboard, ทาง IoTtweet จัดเตรียมการใช้งานการส่งและควบคุมอุปกรณ์ IoT ไว้ 2 ประเภทคือ Switch และ Slider.
Switch ใช้สำหรับการใช้งานแบบ เปิด/ปิด output ที่ IoT port ตามต้องการ.
Slider ใช้สำหรับการส่งข้อมูลเชิงแอนาล็อก (Analog) ไปยังอุปกรณ์. ค่าที่ส่งไปจะเป็นจุดทศนิยม ซึ่งการใช้งานประเภทนี้ได้แก่ การทำ dimmer หลอดไฟ, การประความเร็วของมอเตอร์ เป็นต้น.



.ReadControlPanel(userid,key);


ตัวแปรในคำสั่ง ประเภทของข้อมูล ความหมาย
userid const char เลขประจำตัวผู้ใช้งานของสมาชิก IoTtweet.com, เลขนี้จะมีความยาว 6 หลัก เช่น 000001 เป็นต้น.
key const char รหัสประจำอุปกรณ์ของเรา ที่ได้จากการลงทะเบียนในระบบ "My IoT garage".

ผลลัพธ์ ประเภทของข้อมูลที่ส่งกลับมา ค่าที่ส่งกลับมา
Server จะทำการส่งข้อมูลสถาณะทั้งหมดของ Switch และ Slider บนหน้า Dashboard ของเราขณะนั้น, กลับมายัง IoT JSON {"sw1":"status","sw2":"status",...,"slider3":"value"}

ข้อมูลที่ส่งกลับมา จะอยู่รูปแบบของ "JSON" ฟอร์แมต. ดังนั้นหากจะนำไปใช้งานต่อ, สามารถทำการถอดรหัสได้โดยใช้คำสั่ง
จาก library ที่ชื่อว่า "ArduinoJson.h" ครับ


.ReadDigitalSwitch(userid,key,switch_number);


ตัวแปรในคำสั่ง ประเภทของข้อมูล ความหมาย
userid const char เลขประจำตัวผู้ใช้งานของสมาชิก IoTtweet.com, เลขนี้จะมีความยาว 6 หลัก เช่น 000001 เป็นต้น.
key const char รหัสประจำอุปกรณ์ของเรา ที่ได้จากการลงทะเบียนในระบบ "My IoT garage".
switch_number Integer เบอร์ของ switch ที่เราต้องการทราบสถานะ (มีให้ใช้ 1-5).

ผลลัพธ์ ประเภทของข้อมูลที่ส่่งกลับมา ค่าที่ส่งกลับมา
สถานะของ Switch ที่เราระบุ String "ON" or "OFF"


.ReadAnalogSlider(userid,key,slider_number);


ตัวแปรในคำสั่ง ประเภทของข้อมูล ความหมาย
userid const char เลขประจำตัวผู้ใช้งานของสมาชิก IoTtweet.com, เลขนี้จะมีความยาว 6 หลัก เช่น 000001 เป็นต้น.
key const char รหัสประจำอุปกรณ์ของเรา ที่ได้จากการลงทะเบียนในระบบ "My IoT garage".
slider_number Integer เบอร์ของ slider ที่เราต้องการทราบสถานะ (มีให้ใช้ 1-3).

ผลลัพธ์ ประเภทของข้อมูลที่ส่งกลับมา ค่าที่ส่งกลับมา
ค่าของ slider ในขณะนั้น ตามหมายเลขที่เราระบุลงไป float ตัวอยาง : "40.55"

ในการส่งข้อมูล Slider แต่ละครั้งไปยังอุปกรณ์ IoT, ต้องทำการกดปุ่มชื่อ "Fire to IoT" ทุกครั้ง เพื่อทำการส่งข้อมูล
ไปอัพเดทในฐานข้อมูล ก่อนที่จะให้ IoT เรียกใช้คำสั่งนี้.




การใช้งานอื่นๆ


.getVersion();


ตัวแปรในคำสั่ง ประเภทของข้อมูล ความหมาย
- - เพื่อขอทราบเวอร์ชั่นของ IoTtweet library ตัวที่ใช้งานอยู่ในปัจจุบัน

ผลลัพธ์ ประเภทของข้อมูลที่ส่งกลับมา ค่าที่ส่งกลับมา
เวอร์ชั่นของ IoTtweet library ที่กำลังใช้งานอยู่ const char ตัวอย่าง : "v0.2.0"

คุณสามารถดาวน์โหลดเวอร์ชั่นล่าสุดของ IoTtweet library ได้จาก github:IoTtweet.




มาเริ่ม Tweet กันเลย !
- Support team / IoTtweet.com -