cumulocity lora

การเชื่อมต่อ LORA สำหรับ cumulocity

การติดตั้งปลั๊กอิน Lora Cumulocity

คุณสามารถติดตั้งปลั๊กอิน LORA CUMULOCITY จากแอพการดูแลระบบควรมีอยู่ในระบบนิเวศ -> แอปพลิเคชัน -> เมนูแพ็คเกจ

ถ้าไม่ดาวน์โหลดไฟล์ zip จากรุ่นล่าสุดและติดตั้งในแพ็คเกจแอปพลิเคชัน (มีให้จากเมนูที่ชี้ด้านบน): https://github.com/softwareag/cumulocity-lora/releases/latest/download/sag-ps-iot-pkg-lora-package.zipage

มีจุดประสงค์เพื่อติดตั้งในแอปพลิเคชัน DeviceManagement เท่านั้น

ปลั๊กอินนี้ต้องการคุณสมบัติ Microservice ที่เปิดใช้งานบนผู้เช่าของคุณในการทำงาน หากคุณอยู่ในผู้เช่าทดลองใช้โปรดติดต่อตัวแทนขายของคุณเพื่อทำเช่นนั้นหรือติดต่อฝ่ายสนับสนุนเกี่ยวกับ Empower

เมื่อเปิดใช้งานคุณสมบัติ Microservice โปรดติดตั้ง microservice github-proxy ที่สามารถดาวน์โหลดได้จาก URL นี้: https://github.com/softwareag/cumulocity-lora/Releases/latest/download/github-proxy.zip

เมื่อติดตั้ง microservice github-proxy เพียงไปที่แอปพลิเคชัน deviceManagement จากนั้นไปยังเมนู LORA/Config จากที่นั่นเพียงเลือกไมโครเซิร์ตที่คุณต้องการติดตั้งบนผู้เช่าของคุณ

คุณจะเห็น microservices 2 ชนิด: ตัวเชื่อมต่อ LNS มักจะชื่อ LORA-NS- และ CODECS โดยปกติจะชื่อ LORA-CODEC-

เอกสารผู้ใช้

การเพิ่มขั้วต่อ LNS ใหม่

ในแอปพลิเคชัน Devicemanagement-Lora ไปที่เมนูเซิร์ฟเวอร์ LORA/LORA Network เพียงให้ชื่อกับตัวเชื่อมต่อของคุณจากนั้นเลือกประเภทของ LNS ที่คุณต้องการเชื่อมต่อ (ประเภทที่คุณกำลังมองหาจะปรากฏขึ้นหากติดตั้ง microservice ที่เกี่ยวข้อง)

ตรวจสอบให้แน่ใจว่าคุณต้องการเชื่อมต่อกับ cumulocity ได้รับการกำหนดค่าอย่างถูกต้อง (LN บางอย่างต้องการการสร้างคีย์ API เป็นต้น) เมื่อเลือกประเภทแล้วให้ทำตามคำแนะนำตัวช่วยสร้าง อุปกรณ์ที่ได้รับการจัดเตรียมแล้วจะถูกเพิ่มลงในการสะสมโดยอัตโนมัติเมื่อพวกเขาส่งข้อมูลและข้อมูลของพวกเขาจะถูกส่งต่อโดย LNS ไปยัง Cumulocity ตัวอย่างสำหรับ ttn:

และอีกอันสำหรับ Chirpstack:

การนำเข้าอุปกรณ์อัตโนมัติ

เมื่อตัวเชื่อมต่อถูกสร้างขึ้นแล้ว Cumulocity จะสร้างเส้นทาง HTTP โดยอัตโนมัติใน LNS เพื่อผลักดันข้อมูลจาก LNS ไปยังผู้เช่า Cumulocity ปัจจุบัน ยิ่งไปกว่านั้นอุปกรณ์ที่มีอยู่ทั้งหมดใน LNS จะถูกสร้างขึ้นโดยอัตโนมัติในการสะสมโดยอัตโนมัติเมื่อพวกเขาส่งข้อมูลและข้อมูลถูกผลักไปยัง cumulocity ผ่านเส้นทาง HTTP ที่กำหนดค่า อุปกรณ์เหล่านั้นจะถูกสร้างขึ้นโดยไม่มีตัวแปลงสัญญาณที่เกี่ยวข้องกับพวกเขาดังนั้นคุณจะต้องไปที่มุมมองรายละเอียดอุปกรณ์เพื่อเลือกตัวแปลงสัญญาณที่เหมาะสม น้ำหนักบรรทุกใด ๆ ที่ส่งไปยังการเลือก Cumulocity Priori Codec จะไม่หายไป: พวกเขาจะถูกเก็บไว้และคุณจะสามารถประมวลผลได้เมื่อคุณเลือกตัวแปลงสัญญาณที่เหมาะสม

การจัดเตรียมอุปกรณ์ LORA ใหม่

ในแอปพลิเคชัน Devicemanagement-Lora ไปที่เมนูอุปกรณ์ LORA/LORA

ในการจัดเตรียมอุปกรณ์ใน LNS คุณจะต้องทำเครื่องหมายในกล่องที่มีป้ายกำกับว่า "อุปกรณ์จัดเตรียมใน LORA Network Server": จากนั้นคุณจะสามารถเลือกตัวเชื่อมต่อ LNS ที่เกี่ยวข้องกับ LNS ที่คุณต้องการจัดเตรียมอุปกรณ์เข้า ขึ้นอยู่กับประเภทของตัวเชื่อมต่อ LNS ที่คุณเลือกฟิลด์ที่แตกต่างกันจะปรากฏขึ้นเพื่อสรุปการจัดเตรียมอุปกรณ์ใน LNs เฉพาะนั้น

ตัวอย่างสำหรับ ttn:

และอีกอันสำหรับ Chirpstack:

การจัดเตรียมเกตเวย์ใหม่

ในแอปพลิเคชัน Devicemanagement-Lora ไปที่เมนู LORA/LORA Gateways

ขึ้นอยู่กับตัวเชื่อมต่อ LNS ที่คุณจะเลือกฟิลด์ที่แตกต่างกันจะปรากฏขึ้น

ตัวอย่างด้วย TTN:

อีกอย่างหนึ่งที่มีความสามารถ:

เพื่อให้สามารถจัดเตรียมเกตเวย์ได้ LN บางอย่างจำเป็นต้องได้รับอนุญาตเฉพาะ ตัวอย่างเช่น TTN ต้องใช้คีย์ API ผู้ใช้เนื่องจากคีย์ Application API จะช่วยให้คุณจัดการอุปกรณ์ในแอปพลิเคชันเฉพาะเท่านั้น

การจัดการอุปกรณ์

อุปกรณ์ LORA ที่ระบุโดยชิ้นส่วน JSON lora_ns_device_LoRaDevice สามารถจัดการได้จากมุมมองเฉพาะที่สามารถเข้าถึงได้ผ่าน Submenu "Lora" บนมุมมองรายละเอียดของอุปกรณ์

การกระทำหลายอย่างสามารถทำได้ในมุมมองนี้:

1. กำหนดค่าตัวแปลงสัญญาณอุปกรณ์

คุณสามารถเปลี่ยนตัวแปลงสัญญาณได้ตลอดเวลา หากคุณเลือกผิดและไม่สามารถประมวลผลน้ำหนักบรรทุกที่เข้ามาได้น้ำหนักบรรทุกจะอยู่ในสถานะที่ยังไม่ผ่านกระบวนการและคุณจะสามารถประมวลผลใหม่ได้ในภายหลัง

2. ตัวเลือกตัวแปลงสัญญาณ

คุณสามารถเปิดใช้งานโหมดการดีบักซึ่งจะสร้างกิจกรรมพิเศษสำหรับแต่ละน้ำหนักบรรทุกที่เข้ามาซึ่งจะมีน้ำหนักบรรทุกที่ถอดรหัสเต็มรูปแบบ

นอกจากนี้คุณยังสามารถเลือกที่จะจัดเก็บการวัดล่าสุดบนอุปกรณ์เองดังนั้นคุณจะสามารถใช้กับวิดเจ็ตเฉพาะ แต่ยังเพิ่มเป็นคอลัมน์ในตาราง "อุปกรณ์ทั้งหมด"

3. ประมวลผล payloads ที่ยังไม่ผ่านกระบวนการ

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

4. สลับ LNS

คุณสามารถสลับอุปกรณ์เป็น LN อื่นได้ เมื่อทำเช่นนั้นอุปกรณ์จะถูกขยายออกจาก LNS ปัจจุบันและจัดเตรียมให้กับ LNS ที่เลือกใหม่

5. ส่งคำสั่ง

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

คุณสามารถอัปเดตการกำหนดค่าอุปกรณ์ได้โดยการแก้ไข JSON โดยตรงหรือโดยการส่งคำสั่งจากแท็บ LORA คำสั่งที่มีอยู่ในแท็บ LORA จะมีฟิลด์อินพุตของพวกเขาล่วงหน้าด้วยค่าที่เก็บไว้ในการกำหนดค่าอุปกรณ์:

เมื่อมีการส่งคำสั่งมันจะต้องผ่านวงจรการดำเนินการ cumulocity ปกติ: วงจรการดำเนินการ:

รอดำเนินการ -> การดำเนินการ -> ความสำเร็จหรือล้มเหลว

สถานะของการดำเนินการจะได้รับการอัปเดตเมื่อ LNS ส่งเหตุการณ์การอัปเดต downlink

โปรดทราบว่าเหตุการณ์การอัปเดต Downlink ของ LNS ทั้งหมดนั้นไม่ใช่การเปิดใช้งานอย่างชัดเจนทั้งในโปรไฟล์อุปกรณ์หรือในการกำหนดค่า LNS

เหตุการณ์ LNS

กิจกรรม LNS ทั้งหมดจะพร้อมใช้งานเป็นกิจกรรมในวัตถุที่จัดการตัวเชื่อมต่อ LNS ในรูปแบบ JSON ดิบตามที่ส่งโดย LNS

กิจกรรมอัปลิงค์จะมีอยู่ในอุปกรณ์ในรูปแบบที่มี FPort, เพย์โหลดในรูปแบบ hex ไม่ว่าจะมีการประมวลผลน้ำหนักบรรทุกหรือไม่และข้อมูลอื่น ๆ ที่เกี่ยวข้อง

ตัวแปลงสัญญาณ IDE

เฟรมเวิร์กเสนอความสามารถในการสร้างตัวแปลงสัญญาณโดยตรงจาก Cumulocity UI ด้วย IDE แบบบูรณาการตามตัวแก้ไข Monaco

ในการเปิดใช้งานคุณสมบัตินี้คุณต้องติดตั้ง Microservice lora-ns-custom ที่กำหนดเอง

IDE สามารถเข้าถึงได้ในเมนู LORA/Custom Codecs และถูกนำไปใช้ใน 3 ส่วน:

• การประมวลผลอัปลิงค์ (ตัวถอดรหัส)

• การประมวลผล downlink (encoder)

• คำจำกัดความการดำเนินงาน

เมื่อคุณมีความสุขกับตัวแปลงสัญญาณของคุณและคุณบันทึกมันจะสามารถเข้าถึงได้จากแท็บอุปกรณ์ LORA ใด ๆ เป็นรุ่นของตัวแปลงสัญญาณที่กำหนดเอง