Specyfikacja: Dynamiczny wybór źródła czasu w mechanizmie timestamp_mw

未关闭
#213 0 条评论 0 个 reaction 已指派 1 人 在 GitHub 查看

维护者通常 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ń).
  • Inicjalizacja: Podczas startu TimestampService musi zainicjalizować NtpController z 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_ms wysyłać ramkę Announce na 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:

  1. Najniższa klasa (deviceClass): Im mniejsza wartość, tym lepsze źródło.
  2. Status Holdover: Preferowane są urządzenia z bitem holdover = 0.
  3. 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ów t0..t3.
  • Dynamiczne uzupełnianie pola settings we wszystkich wychodzących ramkach (zarówno Unicast, jak i Multicast).

4. Kryteria Akceptacji (AC)

  • Brak statycznego IP: Usunięcie zależności od zmiennej masterIP w 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

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

Simba-Avionic/srp 的其他 Issue

查看 Simba-Avionic/srp 的全部 Issue

相似的 Issue

更多 C++ Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。