
Chirpstack เป็นเซิร์ฟเวอร์เครือข่าย Lorawan (R) โอเพนซอร์ซซึ่งสามารถใช้ในการตั้งค่าเครือข่าย Lorawan Chirpstack ให้บริการเว็บอินเตอร์เฟสสำหรับการจัดการเกตเวย์อุปกรณ์และผู้เช่ารวมถึงการตั้งค่าการรวมข้อมูลกับผู้ให้บริการคลาวด์หลักฐานข้อมูลและบริการที่ใช้กันทั่วไปสำหรับการจัดการข้อมูลอุปกรณ์ Chirpstack ให้ API ที่ใช้ GRPC ซึ่งสามารถใช้ในการรวมหรือขยาย Chirpstack
โปรดดูที่เว็บไซต์ Chirpstack สำหรับเอกสารและไบนารีที่รวบรวมไว้ล่วงหน้า
การสร้าง Chirpstack ต้องการ:
Nix ใช้สำหรับการตั้งค่าสภาพแวดล้อมการพัฒนาที่ใช้สำหรับการพัฒนาในท้องถิ่นและสำหรับการสร้างไบนารี
หากคุณไม่ได้ติดตั้ง NIX และไม่ต้องการติดตั้งคุณสามารถใช้สภาพแวดล้อม NIX ที่ใช้ Compose Compose ในการเริ่มต้นสภาพแวดล้อมนี้ดำเนินการคำสั่งต่อไปนี้:
make docker-devshell หมายเหตุ: คุณจะสามารถเรียกใช้คำสั่งทดสอบและเรียกใช้ cargo build แต่การคอมไพล์ข้ามจะไม่ทำงานภายในสภาพแวดล้อมนี้ (เพราะมันจะลองเริ่ม Docker ภายใน Docker)
Docker ถูกใช้โดย Cross-Rs สำหรับการคอมไพล์ข้ามรวมถึงคำสั่ง make บางส่วน
เรียกใช้คำสั่งต่อไปนี้เพื่อเริ่มการพัฒนาเชลล์:
nix-shellหรือหากคุณไม่ได้ติดตั้ง NIX ให้ดำเนินการคำสั่งต่อไปนี้:
make docker-devshellในการสร้าง chirpstack UI ให้ดำเนินการคำสั่งต่อไปนี้:
make build-ui
Chirpstack ต้องใช้บริการหลายอย่างเช่น PostgreSQL, Redis, Mosquitto, ... ที่จะทำงานก่อนที่คุณจะสามารถทำการทดสอบได้ คุณต้องเริ่มต้นบริการเหล่านี้ด้วยตนเองหากคุณเริ่มต้นการพัฒนาเชลล์โดยใช้ nix-shell :
docker compose up -dเรียกใช้คำสั่งต่อไปนี้เพื่อเรียกใช้การทดสอบ Chirpstack:
# Test (with PostgresQL database backend)
make test
# Test with SQLite database backend
DATABASE=sqlite make testก่อนที่จะรวบรวมไบนารีคุณจะต้องติดตั้งเครื่องมือพัฒนาเพิ่มเติม (สำหรับการคอมไพล์ข้ามบรรจุภัณฑ์, ED) ดำเนินการคำสั่งต่อไปนี้:
make dev-dependencies เรียกใช้คำสั่งต่อไปนี้ภายในโฟลเดอร์ย่อย ./chirpstack :
# Build AMD64 debug build (optimized for build speed)
make debug-amd64
# Build AMD64 release build (optimized for performance and binary size)
make release-amd64
# Build all packages (all targets, .deb, .rpm and .tar.gz files)
make dist โดยค่าเริ่มต้นคำสั่งข้างต้นจะสร้าง Chirpstack ด้วยแบ็กเอนด์ฐานข้อมูล PostgreSQL ฐานข้อมูล ตั้ง DATABASE=sqlite env ตัวแปรเพื่อรวบรวม Chirpstack ด้วยแบ็กเอนด์ฐานข้อมูล SQLite
หากต้องการสร้างการโยกย้ายฐานข้อมูลใหม่ให้ดำเนินการ:
make migration-generate NAME=test-migration
หากต้องการใช้การย้ายถิ่นให้ดำเนินการ:
make migration-run
หากต้องการเปลี่ยนการย้ายถิ่นให้ดำเนินการ:
make migration-revert
โดยค่าเริ่มต้นคำสั่งข้างต้นจะเรียกใช้คำสั่งการย้ายถิ่นโดยใช้แบ็กเอนด์ฐานข้อมูล PostgreSQL ในการเรียกใช้คำสั่งการย้ายข้อมูลสำหรับแบ็กเอนด์ฐานข้อมูล SQLite ให้ตั้ง DATABASE=sqlite Env ตัวแปร.
Chirpstack Network Server จัดจำหน่ายภายใต้ใบอนุญาต MIT ดูใบอนุญาตด้วย