Lorawan-stack: Ikhtisar Gerbang Tunggal
Ringkasan:
Konsol memerlukan halaman ikhtisar untuk gateway, melengkapi halaman ikhtisar kami untuk aplikasi dan perangkat. Lihat juga #26.
Halaman ikhtisar harus berisi:
- info dasar seperti id, nama, deskripsi, tanggal pembuatan
- info status (terakhir terlihat)
- lokasi gateway (antena)
- jumlah pesan yang dikirim/diterima
- rencana frekuensi
- informasi perangkat keras (merek, model, kekuatan sinyal, firmware)
- privasi (gerbang publik/pribadi)
Secara implisit, mengerjakan ikhtisar juga akan berisi:
- tampilan induk gateway (dengan bilah sisi, wadah remah roti)
Kenapa kita perlu ini?
Halaman ikhtisar entitas kami berfungsi sebagai akses cepat ke informasi terpenting dengan kedalaman klik rendah.
Apa yang sudah ada?
Titik akhir API yang sesuai. Untuk referensi, contoh respons GET /gateways/{gateway_ids.gateway_id} dari registri gateway:
{
"ids": {
"gateway_id": "string",
"eui": "string"
},
"created_at": "2019-03-06T08:55:43.727Z",
"updated_at": "2019-03-06T08:55:43.727Z",
"name": "string",
"description": "string",
"attributes": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"contact_info": [
{
"contact_type": "CONTACT_TYPE_OTHER",
"contact_method": "CONTACT_METHOD_OTHER",
"value": "string",
"public": true,
"validated_at": "2019-03-06T08:55:43.727Z"
}
],
"version_ids": {
"brand_id": "string",
"model_id": "string",
"hardware_version": "string",
"firmware_version": "string"
},
"gateway_server_address": "string",
"auto_update": true,
"update_channel": "string",
"frequency_plan_id": "string",
"antennas": [
{
"gain": 0,
"location": {
"latitude": 0,
"longitude": 0,
"altitude": 0,
"accuracy": 0,
"source": "SOURCE_UNKNOWN"
},
"attributes": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
}
}
],
"status_public": true,
"location_public": true,
"schedule_downlink_late": true,
"enforce_duty_cycle": true,
"downlink_path_constraint": "DOWNLINK_PATH_CONSTRAINT_NONE"
}
Apa yang hilang?
- Diskusi cepat tentang apa yang perlu ada di sana (apakah kita melewatkan sesuatu)
- Gambar rangka dan/atau desain layar
- Penerapan
Bagaimana Anda mengusulkan untuk menerapkan ini?
Melengkapi implementasi aplikasi kami.
Apa yang dapat Anda lakukan sendiri dan apa yang Anda butuhkan bantuan?
Saya ingin menindaklanjuti dengan wireframe cepat, setelah saya memiliki beberapa masukan tentang persyaratan.
kschiffer
Semua 7 komentar
Saya pikir kita perlu beberapa masukan di sini segera tentang apa yang akan ditampilkan di halaman ikhtisar gateway.
cc @htdvisser @johanstokking
kschiffer
pada 3 Mei 2019
Saya akan tetap sederhana; ID, EUI, nama, deskripsi dan rencana frekuensi.
Bagus akan menunjukkan indikator online dengan menekan GS dan memeriksa statistik koneksi. Jika 200 <= status < 300 terhubung, jika 404 tidak terhubung, dan yang lainnya adalah kesalahan. Ini adalah panggilan per entri yang ditampilkan tetapi layak dan murah untuk dilayani dari GS karena berasal dari memori.
johanstokking
pada 3 Mei 2019
dari https://github.com/TheThingsNetwork/lorawan-stack/issues/26#issue -404416151
menampilkan statistik koneksi per gateway (jika gateway_server_address cocok dengan konfigurasi API Gateway Server dari konsol saat ini)
dan
Bagus akan menunjukkan indikator online dengan menekan GS dan memeriksa statistik koneksi. Jika 200 <= status < 300 terhubung, jika 404 tidak terhubung, dan yang lainnya adalah kesalahan.
Kami harus menyetujui apa yang kami tunjukkan kepada pengguna.
membiarkan
gtw_gs_address menjadi alamat server gateway yang dikonfigurasi untuk gateway
console_gs_address menjadi alamat server gateway dari cluster saat ini yang diteruskan ke konsol
- Jika lebih besar atau sama dengan 200 dan kurang dari 300, maka
connected - jika 404
2.1 jikagtw_gs_addressatauconsole_gs_address == empty-> statusunknown. ini dapat terjadi jika alamat server gateway tidak ada di cluster saat ini atau alamat tidak ditambahkan saat membuat gateway, atau jika keduanya.
2.2 jikagtw_gs_address == console_gs_address-> statusdisconnected
2.3 jikagtw_gs_address != console_gs_address-> gatewayis not managed by this console - hal lain -> status gateway adalah
unknown, halaman Ikhtisar Gateway menampilkan kesalahan
UI:
connected (1)
unknown (2.1)
disconnected (2.2)
not this console (2.3)
@johanstokking @htdvisser @kschiffer
bafonins
pada 6 Mei 2019
Saya akan menggunakan logika yang berbeda untuk indikator konektivitas. Itu harus dimulai dengan alamat server gateway, dan bukan dengan permintaan ke GS (karena tidak masuk akal untuk memanggil GS yang sudah kita ketahui tidak melayani gateway):
- Jika
console.gateway_server_addresskosong, maka fitur tersebut dinonaktifkan sepenuhnya - Jika
gateway.gateway_server_addresskosong, maka:- asumsikan
console.gateway_server_addresstetapi juga tampilkan pesannya - fitur dinonaktifkan untuk gateway ini dan tampilkan pesannya
- asumsikan
- Jika
gateway.gateway_server_addresstidak sama denganconsole.gateway_server_address, maka fitur tersebut dinonaktifkan untuk gateway ini dan menampilkan pesan
Saya juga akan mengubah pesannya sedikit. Kami mencoba memberi tahu pengguna bahwa gateway yang dipilih tidak ditetapkan ke server gateway di kluster konsol saat ini. Masih mungkin untuk membaca/menulis hal-hal dari gateway yang ada di server identitas dan bukan di server gateway (pada dasarnya semuanya selain status konektivitas dan lalu lintas)
htdvisser
pada 6 Mei 2019
Saya juga akan mengubah pesannya sedikit.
Apa yang akan menjadi pesan?
bafonins
pada 6 Mei 2019
Saya setuju dengan @htdvisser pada pesanan.
Jadi kami memiliki lima negara bagian:
- Jika
console.gateway_server_addresssama dengangateway.gateway_server_address, tekan GS:- Terhubung jika 200 <= status < 300
- Tidak terhubung jika 404
- Kesalahan jika sebaliknya
- Jika tidak
- Tidak Diketahui Jika
gateway.gateway_server_addresskosong; gateway tidak disediakan
- Tidak Diketahui Jika
- Cluster lain sebaliknya (yaitu alamat berbeda)
johanstokking
pada 6 Mei 2019
Saya juga akan mengubah pesannya sedikit.
Apa yang akan menjadi pesan?
Bagaimanapun, saya tidak tahu apakah bagian atas adalah lokasi yang baik untuk menampilkan notifikasi. Untuk memiliki pesan yang bermakna, kita mungkin membutuhkan teks yang lebih panjang yang tidak akan terlihat bagus di sana. Saya akan mengatakan bahwa Unknown atau Other Cluster sebagai status sudah cukup dan kita harus melihat ke tempat lain untuk memberi tahu pengguna tentang hal-hal spesifik nanti.
kschiffer
pada 6 Mei 2019
Masalah terkait
bafonins
·
5Komentar
MatteMoveSRL
·
7Komentar
johanstokking
·
8Komentar
thinkOfaNumber
·
4Komentar
htdvisser
·
9Komentar
Komentar yang paling membantu
Saya akan tetap sederhana; ID, EUI, nama, deskripsi dan rencana frekuensi.
Bagus akan menunjukkan indikator online dengan menekan GS dan memeriksa statistik koneksi. Jika 200 <= status < 300 terhubung, jika 404 tidak terhubung, dan yang lainnya adalah kesalahan. Ini adalah panggilan per entri yang ditampilkan tetapi layak dan murah untuk dilayani dari GS karena berasal dari memori.