İndir

RTLS Sunucusu ve RTLS Simülatörü statik bağlı tek dosya olarak dağıtılır; ek bir kurulum gerektirmez. Her ikisi de Windows, macOS ve Linux için sağlanır ve her sürümde yeniden derlenir.

RTLS Sunucusu (rtlsd)

rtlsd, anchor'lardan gelen olayları toplayan, SQLite'a yazan ve uygulama sunucularına sunan servistir. Grafik arayüzü yoktur; terminalden çalıştırılır. SQLite gömülü derlendiği için harici bir bağımlılığı yoktur.

Windowsx86_64 · .exemacOSUniversal (Intel + Apple Silicon)Linuxx86_64 · statik (musl)

Çalıştırma

İndirdiğiniz dosya bir konfigürasyon dosyasıyla birlikte çalışır. Önce dosyayı çalıştırılabilir yapın, ardından rtlsd.json oluşturun:

Linux

chmod +x rtlsd-linux-x86_64
./rtlsd-linux-x86_64 --config rtlsd.json

macOS

chmod +x rtlsd-macos-universal
xattr -d com.apple.quarantine rtlsd-macos-universal
./rtlsd-macos-universal --config rtlsd.json

Windows

.\rtlsd-windows-x86_64.exe --config rtlsd.json

Konfigürasyon yolu sırasıyla --config, RTLSD_CONFIG ortam değişkeni ve çalışma dizinindeki rtlsd.json üzerinden çözümlenir.

Seçenek	Açıklama
-c, --config	Konfigürasyon dosyasının yolu
-h, --help	Yardım
-V, --version	Sürüm

Günlük seviyesi RUST_LOG ile ayarlanır:

RUST_LOG=debug ./rtlsd-linux-x86_64 --config rtlsd.json

Konfigürasyon

anchor.authTokens dışındaki tüm alanların varsayılanı vardır. Anchor anahtarının güvenli bir varsayılanı olamayacağı için dosya zorunludur.

{
  "http": { "host": "0.0.0.0", "port": 8080, "maxBodyBytes": 1048576 },
  "database": { "path": "rtlsd.db" },
  "anchor": { "authTokens": ["degistirin-bu-anahtari"] },
  "app": { "authToken": null, "defaultLimit": 1000, "maxLimit": 10000 },
  "sse": { "channelCapacity": 1024, "keepAliveSecs": 15 }
}

Alan	Varsayılan	Açıklama
http.host	0.0.0.0	Dinlenecek adres.
http.port	8080	Dinlenecek port.
http.maxBodyBytes	1048576	Kabul edilen en büyük istek gövdesi. Aşılırsa 413.
database.path	rtlsd.db	SQLite dosyası.
anchor.authTokens	—	Kabul edilen anchor anahtarları. Anahtar değişimi için birden fazla verilebilir.
app.authToken	null	Uygulama yüzü anahtarı. null ise kimlik doğrulaması yapılmaz.
app.defaultLimit	1000	limit verilmediğinde uygulanan kayıt sayısı.
app.maxLimit	10000	limit için tavan.
sse.channelCapacity	1024	Abone başına tampon. Dolarsa abone düşürülür.
sse.keepAliveSecs	15	Boşta kalan SSE bağlantılarına gönderilen canlı tutma periyodu.

Sunucu tek bir HTTP portu üzerinden iki yüz sunar: anchor'lar için POST /anchors/:anchorId/events, uygulama sunucuları için GET /events. Ayrıntılar HTTP API sayfasında; erişim günlüğü, depolama ve SSE devamlılığı gibi tasarım notları için rtlsd/README.md dosyasına bakınız.

RTLS Simülatörü

RTLS Simülatörü, sunucu davranışını yerel olarak test etmenizi sağlayan masaüstü bir uygulamadır. Olayları arayüzden tetikleyebilir, tag'leri harita üzerinde hareket ettirebilir ve HTTP API'yi gerçek bir istemciyle deneyebilirsiniz.

Windowsx86_64 · .exemacOSUniversal (Intel + Apple Silicon)Linuxx86_64 · statik (musl)

Kurulum ve Çalıştırma

Windows

İndirdiğiniz rtls-simulator-windows-x86_64.exe dosyasına çift tıklayarak çalıştırın.

macOS

chmod +x rtls-simulator-macos-universal
./rtls-simulator-macos-universal

İlk çalıştırmada Gatekeeper uyarı verebilir. Sistem Ayarları → Gizlilik ve Güvenlik bölümünden uygulamaya izin verin veya:

xattr -d com.apple.quarantine rtls-simulator-macos-universal

Linux

chmod +x rtls-simulator-linux-x86_64
./rtls-simulator-linux-x86_64

Başlangıç Adresi

Simülatör varsayılan olarak 0.0.0.0:8080 adresinde başlar. Bunu arayüzdeki adres çubuğundan değiştirebilir veya RTLS_ADDR ortam değişkeniyle ayarlayabilirsiniz:

RTLS_ADDR=127.0.0.1:9000 ./rtls-simulator-linux-x86_64