> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/fr/system-administration/configuring-ptp.md).

# Configuration de PTP dans VergeOS

Configurez le protocole Precision Time Protocol (PTP) à la place de NTP pour la synchronisation de l’heure de VergeOS, y compris chaque paramètre PTP, sa valeur par défaut et la manière de revenir à NTP.

## Vue d'ensemble

{% hint style="info" %}
**Points clés**

* Le mode PTP remplace NTP pour la synchronisation de l'heure système. NTP ne s'exécute pas lorsque le mode PTP est activé.
* PTP nécessite un réseau physique connecté à des commutateurs compatibles PTP et à une horloge grandmaster PTP.
* Les horodatages matériels offrent la plus grande précision. Ils sont activés par défaut.
* Le **Paramètres de l'heure** La page affiche l'état de synchronisation de chaque nœud. VergeOS déclenche une alarme lorsqu'un nœud n'est pas synchronisé pendant plus de deux minutes.
* Pour annuler la modification, définissez **Mode** de nouveau sur **NTP**.
  {% endhint %}

Cet article explique comment passer la synchronisation de l'heure VergeOS de NTP à Precision Time Protocol (PTP) et comment configurer chaque option PTP. Utilisez PTP uniquement lorsque vos charges de travail nécessitent une heure plus précise que celle fournie par NTP, par exemple dans la diffusion, le trading financier, les télécommunications ou l'automatisation industrielle.

{% hint style="danger" %}
N'activez pas PTP sauf si vos cartes réseau, commutateurs et grandmaster prennent en charge PTP. Une configuration PTP incorrecte provoque une heure incorrecte sur chaque nœud du système.
{% endhint %}

## Prérequis

* VergeOS 26.2 ou version ultérieure.
* Un utilisateur disposant des droits d'administrateur pour le système.
* Un réseau physique connecté à des commutateurs ou à des dispositifs de synchronisation compatibles PTP.
* Une horloge grandmaster PTP que les nœuds peuvent atteindre, ainsi que son profil PTP : domaine, transport et mécanisme de délai.
* Des cartes réseau prenant en charge l'horodatage matériel, pour une précision maximale.

## Étapes

{% hint style="warning" %}
Lorsque vous définissez **Mode** sur **PTP**, NTP s'arrête. Si les nœuds ne peuvent pas atteindre un maître PTP, ils n'ont aucune source de temps.
{% endhint %}

1. Accédez à **Système > Paramètres de l'heure**.
2. Cliquez sur **Modifier les paramètres** dans le menu de gauche.
3. Dans le **Mode** liste, sélectionnez **PTP**. Les champs PTP s'affichent dans le **Paramètres de l'heure** panneau et dans le **Paramètres PTP avancés** panneau.
4. Définissez les paramètres de base pour qu'ils correspondent à votre réseau PTP. Voir [Paramètres de base](#basic-settings).
5. Si votre profil PTP nécessite des valeurs non par défaut, définissez-les dans le **Paramètres PTP avancés** panneau. Voir [Paramètres avancés](#advanced-settings).
6. Cliquez sur **Soumettre**.

Le **Paramètres de l'heure** la page s'ouvre et affiche le nouveau mode.

## Vérifier la configuration

1. Accédez à **Système > Paramètres de l'heure**.
2. Assurez-vous que le panneau d'état de synchronisation affiche chaque nœud comme synchronisé. Si un nœud reste désynchronisé pendant plus de deux minutes, VergeOS déclenche une alarme.
3. Sur votre grandmaster ou commutateur PTP, assurez-vous que chaque nœud apparaît comme client PTP sur le bon domaine.
4. Assurez-vous que les applications qui dépendent d'une heure précise fonctionnent correctement.

Si la synchronisation ne se stabilise pas, revenez à NTP. Examinez ensuite votre réseau PTP et vos paramètres.

## Revenir à NTP

1. Accédez à **Système > Paramètres de l'heure**.
2. Cliquez sur **Modifier les paramètres**.
3. Dans le **Mode** liste, sélectionnez **NTP**.
4. Cliquez sur **Soumettre**.

Le **Paramètres de l'heure** la page affiche **Mode : NTP**. Le **État de synchronisation NTP** panneau affiche chaque nœud comme **Synchronisé**.

## Heure de l'invité

VergeOS transmet le paramètre kvmclock aux invités. Les invités qui prennent en charge PTP peuvent se synchroniser précisément sur l'horloge de l'hôte.

## Référence des paramètres PTP

### Paramètres de base

Ces paramètres se trouvent dans le **Paramètres de l'heure** panneau.

| Champ                                  | Par défaut | Valeurs            | Description                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Réseau d'interface PTP**             | Aucun      | Un réseau physique | Le réseau physique qui transporte le trafic PTP. Requis en mode PTP. Sélectionnez un réseau connecté à des commutateurs ou à des dispositifs de synchronisation compatibles PTP.                                                                                                                                                                                                                                   |
| **Transport PTP**                      | UDPv4      | UDPv4, UDPv6, L2   | Le transport des messages PTP. Utilisez le transport de votre profil PTP. 802.1AS (gPTP) utilise L2.                                                                                                                                                                                                                                                                                                               |
| **Domaine PTP**                        | 0          | 0-127              | Le numéro de domaine PTP. Utilisez le domaine de votre grandmaster.                                                                                                                                                                                                                                                                                                                                                |
| **Mécanisme de délai PTP**             | E2E        | E2E, P2P, Auto     | Comment le délai de trajet est mesuré : de bout en bout (E2E) ou de pair à pair (P2P). Utilisez le mécanisme de votre réseau PTP.                                                                                                                                                                                                                                                                                  |
| **Utiliser les horodatages matériels** | Activé     | Activé, Désactivé  | Avec les horodatages matériels, ptp4l pilote l'horloge matérielle de la carte réseau et phc2sys copie cette heure vers l'horloge système. Avec les horodatages logiciels, ptp4l pilote directement l'horloge système, avec une précision moindre. Si vos cartes réseau ne prennent pas en charge l'horodatage matériel, désactivez cette option. VergeOS ne revient pas automatiquement aux horodatages logiciels. |

### Paramètres avancés

Ces paramètres se trouvent dans le **Paramètres PTP avancés** panneau. Les valeurs par défaut conviennent à la plupart des réseaux PTP. Ne modifiez une valeur que si votre profil PTP ou votre grandmaster en a besoin.

| Champ                                                          | Par défaut | Valeurs           | Description                                                                                                                                                                                                       |
| -------------------------------------------------------------- | ---------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Priorité d'horloge 1**                                       | 128        | 0-255             | Priorité dans la sélection d'horloge de l'algorithme Best Master Clock Algorithm (BMCA). Une valeur plus faible correspond à une priorité plus élevée.                                                            |
| **Priorité d'horloge 2**                                       | 128        | 0-255             | Critère de départage BMCA lorsque la Priorité d'horloge 1 est identique.                                                                                                                                          |
| **Horloge à deux étapes**                                      | Activé     | Activé, Désactivé | Activé : l'horodatage est envoyé dans un message Follow\_Up. Désactivé : l'horodatage se trouve dans le message Sync (une seule étape).                                                                           |
| **Intervalle de journalisation Sync**                          | 0          | -6 à 1            | Fréquence des messages Sync, en secondes logarithmiques base 2 : 0 = 1 s, -1 = 0,5 s, -3 = 0,125 s.                                                                                                               |
| **Intervalle de journalisation Announce**                      | 1          | -3 à 3            | Fréquence des messages Announce, en secondes logarithmiques base 2 : 0 = 1 s, 1 = 2 s, 2 = 4 s.                                                                                                                   |
| **Intervalle de journalisation de demande de délai minimal**   | 0          | -4 à 1            | Fréquence minimale de demande de délai, en secondes logarithmiques base 2. Utilisée avec le mécanisme de délai E2E.                                                                                               |
| **Intervalle de journalisation de demande de P-Delay minimal** | 0          | -4 à 1            | Fréquence minimale de demande de délai entre pairs, en secondes logarithmiques base 2. Utilisée avec le mécanisme de délai P2P.                                                                                   |
| **Transmission unicast**                                       | Désactivé  | Activé, Désactivé | Utilisez unicast au lieu de multicast. Activez cette option uniquement si vos pairs PTP prennent en charge unicast.                                                                                               |
| **Messages d'événements DSCP (port 319)**                      | 0          | 0-63              | Valeur DSCP pour les messages d'événements PTP, pour la QoS.                                                                                                                                                      |
| **Messages généraux DSCP (port 320)**                          | 0          | 0-63              | Valeur DSCP pour les messages généraux PTP, pour la QoS.                                                                                                                                                          |
| **Toujours maître (désactiver BMCA)**                          | Désactivé  | Activé, Désactivé | Le port agit toujours comme maître et n'utilise pas BMCA. Activez cette option uniquement lorsque VergeOS est la source de temps du réseau PTP. Ne l'activez pas si un autre grandmaster utilise le même domaine. |
| **Bloquer les messages Announce**                              | Désactivé  | Activé, Désactivé | Arrête l'envoi et la réception des messages Announce.                                                                                                                                                             |
| **Bloquer les messages de demande de délai**                   | Désactivé  | Activé, Désactivé | Arrête l'envoi des messages Delay Request.                                                                                                                                                                        |
| **Inclure les informations Follow-Up**                         | Désactivé  | Activé, Désactivé | Ajoute le TLV d'informations de suivi aux messages Follow\_Up. Certains profils, comme 802.1AS, en ont besoin.                                                                                                    |
| **Champ spécifique au transport**                              | 0          | 0-255             | Le champ transportSpecific de PTP. Pour 802.1AS (gPTP), cette valeur est généralement 1.                                                                                                                          |
| **Délai maximal de propagation vers le voisin (ns)**           | 20000000   | Nanosecondes      | Le délai de propagation maximal autorisé vers un voisin. Il s'agit d'une limite, pas d'un délai attendu.                                                                                                          |
| **Délai d'attente de réception Sync**                          | 0          | 0-255             | Nombre d'intervalles Sync avant expiration. 0 désactive le délai d'attente.                                                                                                                                       |
| **Délai d'attente de réception Announce**                      | 3          | 1-255             | Nombre d'intervalles Announce avant expiration.                                                                                                                                                                   |

## Ressources supplémentaires

* [Paramètres de l'heure](https://app.gitbook.com/s/pODKGSQETqL1gSqyxIq3/system-administration/time-settings)
* [Paramètres système](/run-the-platform/fr/administration-systeme/settings-overview.md)
* [Notes de version de VergeOS 26.2](/release-notes/fr/2026/26-2-release-notes.md)

{% hint style="info" %}
**Besoin d'aide ?**

Si vous avez des questions ou des problèmes avec cette procédure, contactez l'équipe d'assistance VergeOS.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/knowledge-base/fr/system-administration/configuring-ptp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
