Specyfikacja: Dynamiczny wybór źródła czasu w mechanizmie timestamp_mw
Maintainer thường phản hồi trong vòng 1 ngày
@WiktorM8 đang làm issue này rồi.
Từ ngày 25/4/2026.
Đánh giá
Issue này chưa được đánh giá.
Mô tả
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.
- Ngôn ngữ chính
- C++
- Star
- 1
- Fork
- 3
- Merge trung bình
- 14 giờ 51 phút
- Pull request đã merge (30 ngày)
- 7
Chuẩn bị môi trường
Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Không có hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của Simba-Avionic/srp
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Simba-Avionic/srp#510 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
Simba-Avionic/srp#509 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[SW] OptymalizacjaĐang mở
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 15/100
Simba-Avionic/srp#508 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 20/100
Simba-Avionic/srp#507 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[SW] Prepeare Cross-compilation for rpiCó thể đã có người làm @Mateusz-Krajewski đã nhận hôm nay. Đang mở
Simba-Avionic/srp#506 · 1 bình luận · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của Simba-Avionic/srp
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
ROCm/FastFlowLM#1057 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
documentation GPU low priority
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 87/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
useless statementĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 86/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100