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

オープン
#213 コメント 0 件 リアクション 0 件 担当者 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分
マージ済み PR(30日)
7

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Simba-Avionic/srp のほかの issue

Simba-Avionic/srp の issue をすべて見る

似ている issue

C++ の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。