Specyfikacja: Dynamiczny wybór źródła czasu w mechanizmie timestamp_mw
维护者通常 1 天内回复
@WiktorM8 已经在做这个了。
开始于 2026年4月25日。
评估
这个 Issue 还没有评估数据。
描述
Specyfikacja: Dynamiczny wybór źródła czasu w mechanizmie timestamp_mw
1. Cel zadania
Przejście z modelu statycznego (sztywny adres masterIP) na model dynamiczny, w którym urządzenia automatycznie wybierają najlepsze źródło synchronizacji czasu na podstawie klasy urządzenia przesyłanej w ramce tinyNTP.
2. Architektura danych (ntpStruct)
Należy wykorzystać pole settings w strukturze ntpStruct do przesyłania metadanych o statusie urządzenia.
| Bity | Nazwa | Opis |
|---|---|---|
| 0 - 2 | deviceClass |
Klasa urządzenia (0–7). Im niższa wartość, tym wyższy priorytet. |
| 3 | holdover |
1 = brak aktualnej referencji (czas niepewny); 0 = zsynchronizowany. |
| 4 - 5 | version |
Wersja protokołu (aktualnie 0b00). |
| 6 | msg_type |
0 = Synchronizacja czasu (Unicast); 1 = Rozgłoszenie (Multicast Announce). |
| 7 | Reserved | Zarezerwowane do przyszłego użytku. |
3. Wymagania Funkcjonalne
3.1. Konfiguracja i start
- Plik konfiguracyjny: Aplikacja musi wczytywać parametry z
/opt/srp/cpu_simba/ntp_config.json.- Wymagane pola:
ip,ntp_class(0-7),T_hb_ms(interwał ogłoszeń).
- Wymagane pola:
- Inicjalizacja: Podczas startu
TimestampServicemusi zainicjalizowaćNtpControllerz uwzględnieniem klasy wczytanej z pliku. W przypadku błędnych danych w JSON należy zastosować fallback (np. klasa 7) i zalogować błąd.
3.2. Mechanizm Discovery (Multicast)
- Rozgłaszanie: Każde urządzenie musi co interwał
T_hb_mswysyłać ramkęAnnouncena adres/port UDP Multicast. - Baza sąsiadów: Urządzenie utrzymuje listę aktywnych węzłów (IP, klasa, czas ostatniej aktywności).
- Zarządzanie listą:
- Wpisy starsze niż 15 sekund muszą być automatycznie usuwane.
- Urządzenie nie dodaje własnego adresu IP do listy kandydatów.
3.3. Algorytm wyboru źródła (Best Master Clock)
Przed każdą sesją synchronizacji urządzenie analizuje listę dostępnych węzłów i wybiera źródło według priorytetów:
- Najniższa klasa (
deviceClass): Im mniejsza wartość, tym lepsze źródło. - Status Holdover: Preferowane są urządzenia z bitem
holdover = 0. - Tie-breaker: W przypadku identycznej klasy i statusu, wybierane jest urządzenie o niższym adresie IP.
Logika Ról:
- Jeśli lokalne urządzenie posiada najwyższy priorytet na liście -> pracuje jako Serwer.
- W przeciwnym wypadku -> pracuje jako Klient i synchronizuje się do wybranego lidera.
3.4. Integracja z tinyNTP
- Utrzymanie obecnej logiki obliczania przesunięcia czasu (
offset) i RTT na podstawie znacznikówt0..t3. - Dynamiczne uzupełnianie pola
settingswe wszystkich wychodzących ramkach (zarówno Unicast, jak i Multicast).
4. Kryteria Akceptacji (AC)
- Brak statycznego IP: Usunięcie zależności od zmiennej
masterIPw kodzie. - Prawidłowe mapowanie: Potwierdzenie bitowego zapisu/odczytu klasy i flagi holdover w
settings. - Obsługa błędów: System poprawnie reaguje na brak pliku konfiguracyjnego lub błędy w JSON.
- Dynamiczna zmiana: Po wyłączeniu urządzenia o najwyższym priorytecie (klasa 0), pozostałe urządzenia w sieci w ciągu max 15s wybierają nowe źródło (np. klasa 1).
- Stabilność: Proces synchronizacji nie ulega przerwaniu przy zmianie roli z Serwera na Klienta.
- 主要语言
- C++
- 星标
- 1
- 派生
- 3
- 平均合并
- 14 小时 51 分钟
- 30 天内合并 PR
- 7
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
Simba-Avionic/srp 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 72/100
Simba-Avionic/srp#510 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 25/100
Simba-Avionic/srp#509 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 15/100
Simba-Avionic/srp#508 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 20/100
Simba-Avionic/srp#507 ·
维护者通常 1 天内回复
-
[SW] Prepeare Cross-compilation for rpi可能已有人在做 @Mateusz-Krajewski 今天认领。 未关闭
Simba-Avionic/srp#506 · 1 条评论 · 已指派 1 人 ·
维护者通常 1 天内回复
查看 Simba-Avionic/srp 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 72/100
ROCm/FastFlowLM#1057 ·
维护者通常 1 天内回复
-
documentation GPU low priority
难度 1/5 1-3 小时 新手友好度 87/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 86/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 74/100