|Index|SUSE Telco Cloud Documentação|Configuração de recursos de Telco|Precision Time Protocol
Aplica-se a SUSE Telco Cloud 3.6

46 Precision Time Protocol

O Precision Time Protocol (PTP) é um protocolo de rede desenvolvido pelo Institute of Electrical and Electronics Engineers (IEEE) para permitir a sincronização de tempo em sub-microssegundos em uma rede de computadores. Desde a sua criação e há algumas décadas, o PTP tem sido usado em muitas indústrias. Recentemente, ele tem visto uma adoção crescente nas redes de telecomunicações como um elemento vital para redes 5G. Embora seja um protocolo relativamente simples, sua configuração pode mudar significativamente dependendo da aplicação. Por esse motivo, vários perfis foram definidos e padronizados.

Nesta seção, apenas perfis específicos de telecomunicações serão abordados. Consequentemente, a capacidade de carimbo de data/hora e um relógio de hardware PTP (PHC) na NIC serão assumidos. Atualmente, todos os adaptadores de rede de nível de telecomunicações vêm com suporte a PTP em hardware, mas você pode verificar tais capacidades com o seguinte comando:

# ethtool -T p1p1
Time stamping parameters for p1p1:
Capabilities:
        hardware-transmit
        software-transmit
        hardware-receive
        software-receive
        software-system-clock
        hardware-raw-clock
PTP Hardware Clock: 0
Hardware Transmit Timestamp Modes:
        off
        on
Hardware Receive Filter Modes:
        none
        all

Substitua p1p1 pelo nome da interface a ser usada para PTP.

As seções a seguir fornecerão orientações sobre como instalar e configurar o PTP especificamente no SUSE Telco Cloud, mas espera-se familiaridade com conceitos básicos de PTP. Para uma breve visão geral do PTP e da implementação incluída no SUSE Telco Cloud, consulte a documentação do SLES Precision Time Protocol.

46.1 Instalar componentes de software PTP

No SUSE Telco Cloud, a implementação do PTP é fornecida pelo pacote linuxptp, que inclui dois componentes:

  • ptp4l: um daemon que controla o PHC na NIC e executa o protocolo PTP

  • phc2sys: um daemon que mantém o relógio do sistema sincronizado com o PHC sincronizado por PTP na NIC

Ambos os daemons são necessários para que a sincronização do sistema funcione plenamente e devem ser configurados corretamente de acordo com sua configuração. Isso é abordado em Seção 46.2, “Configure o PTP para implantações de telecomunicações”.

A maneira mais fácil e melhor de integrar o PTP em seu cluster downstream é adicionar o pacote linuxptp em packageList no arquivo de definição do Edge Image Builder (EIB). Dessa forma, o software do plano de controle PTP será instalado automaticamente durante o provisionamento do cluster. Veja a documentação do EIB (Seção 5.3.6, “Configurando pacotes RPM”) para obter mais informações sobre a instalação de pacotes.

Abaixo, encontre um exemplo de manifesto EIB com linuxptp:

apiVersion: 1.3
image:
  imageType: RAW
  arch: x86_64
  baseImage: SL-Micro.x86_64-6.2-Base-RT-GM.raw
  outputImageName: eibimage-slmicrort-telco.raw
operatingSystem:
  time:
    timezone: America/New_York
  kernelArgs:
    - ignition.platform.id=openstack
  systemd:
    disable:
      - rebootmgr
      - transactional-update.timer
      - transactional-update-cleanup.timer
      - fstrim
      - time-sync.target
    enable:
      - ptp4l
      - phc2sys
  users:
    - username: root
      encryptedPassword: $ROOT_PASSWORD
  packages:
    packageList:
      - jq            # Non Telco specific - category: testing/utils
      - dpdk          # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: runtime
      - dpdk-tools    # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: testing/utils
      - libdpdk-25    # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: runtime
      - pf-bb-config  # TelCo RAN (gNB: DU) - category: config.
      - open-iscsi    # Non Telco specific (required by SUSE Storage/Longhorn) - category: runtime
      - tuned         # Non Telco specific (linux tuning) - category: config.
      - cpupower      # Non Telco specific (linux tuning - CPU power related settings) - category: config.
      - rt-tests      # Non Telco specific (RT scheduler-latency testing) - category: testing/utils
      - linuxptp      # TelCo RAN; time sync (gNB: DU) - category: runtime
      - synce4l       # TelCo RAN; time sync (gNN: DU) - category: runtime
      - pciutils      # Non Telco specific (provides "lspci" command) - category: testing/utils
      - numactl       # Non Telco specific (provides "numatcl" command) - category: testing/utils
    sccRegistrationCode: $SCC_REGISTRATION_CODE
Nota
Nota

O pacote linuxptp incluído no SUSE Telco Cloud não habilita ptp4l e phc2sys por padrão. Se os arquivos de configuração específicos do sistema forem implantados no momento do provisionamento (veja Seção 46.3, “Integração com Cluster API”), eles deverão ser habilitados. Faça isso adicionando-os à seção systemd do manifesto, como no exemplo acima.

Siga o processo habitual para criar a imagem conforme descrito na Documentação do EIB (Seção 5.4, “Criando a imagem”) e use-a para implantar seu cluster. Se você é novo no EIB, comece pelo Capítulo 12, Edge Image Builder em vez disso.

46.2 Configure o PTP para implantações de telecomunicações

Muitas aplicações de telecomunicações exigem sincronização rigorosa de fase e tempo com pouco desvio, o que resultou na definição de dois perfis orientados a telecomunicações: o ITU-T G.8275.1 e o ITU-T G.8275.2. Ambos possuem uma alta taxa de mensagens de sincronização e outras características distintas, como o uso de um algoritmo Best Master Clock (BMCA) alternativo. Tal comportamento exige configurações específicas no arquivo de configuração consumido pelo ptp4l, fornecido nas seções a seguir como referência.

Nota
Nota
  • Ambas as seções cobrem apenas o caso de um relógio comum na configuração de Receptor de Tempo.

  • Qualquer perfil desse tipo deve ser usado em uma infraestrutura PTP bem planejada.

  • Sua rede PTP específica pode exigir ajustes adicionais de configuração; certifique-se de revisar e adaptar os exemplos fornecidos, se necessário.

46.2.1 Perfil PTP ITU-T G.8275.1

O perfil G.8275.1 apresenta as seguintes características:

  • Executa diretamente sobre Ethernet e requer suporte total da rede (nós/switches adjacentes devem suportar PTP).

  • A configuração de domínio padrão é 24.

  • A comparação de conjuntos de dados é baseada no algoritmo G.8275.x e seus valores localPriority após priority2.

Copie o seguinte conteúdo para um arquivo chamado /etc/ptp4l-G.8275.1.conf:

# Telecom G.8275.1 example configuration
[global]
domainNumber                    24
priority2            255
dataset_comparison              G.8275.x
G.8275.portDS.localPriority     128
G.8275.defaultDS.localPriority  128
maxStepsRemoved                 255
logAnnounceInterval             -3
logSyncInterval                 -4
logMinDelayReqInterval          -4
announceReceiptTimeout        3
serverOnly                      0
ptp_dst_mac                     01:80:C2:00:00:0E
network_transport               L2

Uma vez que o arquivo tenha sido criado, ele deve ser referenciado em /etc/sysconfig/ptp4l para que o daemon inicie corretamente. Isso pode ser feito alterando a linha OPTIONS= para:

OPTIONS="-f /etc/ptp4l-G.8275.1.conf -i $IFNAME --message_tag ptp-8275.1"

Mais precisamente:

  • -f requer o nome do arquivo de configuração a ser usado, sendo /etc/ptp4l-G.8275.1.conf o valor utilizado neste caso.

  • O -i requer o nome da interface a ser usada; substitua $IFNAME por um nome de interface real.

  • O --message_tag permite identificar melhor a saída do ptp4l nos logs do sistema e é opcional.

Uma vez que as etapas acima estejam concluídas, o daemon ptp4l deve ser (re)iniciado:

# systemctl restart ptp4l

Verifique o status da sincronização observando os logs com:

# journalctl -e -u ptp4l

46.2.2 Arquivo de controle PTP ITU-T G.8275.2

O arquivo de controle G.8275.2 tem as seguintes especificidades:

  • Executa sobre IP e não requer suporte total da rede (nós/switches adjacentes podem não suportar PTP).

  • A configuração de domínio padrão é 44.

  • A comparação de conjuntos de dados é baseada no algoritmo G.8275.x e seus valores localPriority após priority2.

Copie o seguinte conteúdo para um arquivo chamado /etc/ptp4l-G.8275.2.conf:

# Telecom G.8275.2 example configuration
[global]
domainNumber                    44
priority2            255
dataset_comparison              G.8275.x
G.8275.portDS.localPriority     128
G.8275.defaultDS.localPriority  128
maxStepsRemoved                 255
logAnnounceInterval             0
serverOnly                      0
hybrid_e2e                      1
inhibit_multicast_service       1
unicast_listen                  1
unicast_req_duration            60
logSyncInterval                 -5
logMinDelayReqInterval          -4
announceReceiptTimeout        2
#
# Customize the following for slave operation:
#
[unicast_master_table]
table_id                        1
logQueryInterval                2
UDPv4                           $PEER_IP_ADDRESS
[$IFNAME]
unicast_master_table            1

Certifique-se de substituir os seguintes espaços reservados:

  • $PEER_IP_ADDRESS - o endereço IP do próximo nó PTP com o qual se comunicar, como o master ou boundary clock que fornecerá a sincronização.

  • $IFNAME - informa a ptp4l qual interface usar para PTP.

Uma vez que o arquivo tenha sido criado, ele deve ser referenciado, juntamente com o nome da interface a ser usada para PTP, em /etc/sysconfig/ptp4l para que o daemon inicie corretamente. Isso pode ser feito alterando a linha OPTIONS= para:

OPTIONS="-f /etc/ptp4l-G.8275.2.conf --message_tag ptp-8275.2"

Mais precisamente:

  • O -f requer o nome do arquivo de configuração a ser usado. Neste caso, é /etc/ptp4l-G.8275.2.conf.

  • O --message_tag permite identificar melhor a saída do ptp4l nos logs do sistema e é opcional.

Uma vez que as etapas acima estejam concluídas, o daemon ptp4l deve ser (re)iniciado:

# systemctl restart ptp4l

Verifique o status da sincronização observando os logs com:

# journalctl -e -u ptp4l

46.2.3 Configuração PTP de um Boundary Clock

As seções anteriores abordaram a configuração de um relógio comum, mas implantações de Telco podem exigir que o nó atue como um Boundary Clock. Em tal cenário, o tempo de referência deve ser propagado de um Grand Master para um ou mais Time Receivers downstream, o que requer uma NIC com duas ou mais portas. Neste caso, uma porta assumirá a função de Time Receiver, que está conduzindo as atualizações do PTP Hardware Clock (PHC) na NIC, enquanto as restantes funcionarão como Time Transmitters. Uma única instância de ptp4l é suficiente para uma única NIC multiporta, mas cada interface de kernel envolvida na distribuição de tempo deve ser fornecida, como parte de sua configuração. Por exemplo, atualize o arquivo /etc/sysconfig/ptp4l para incluir quatro portas, apenas substitua as variáveis pelos nomes reais das interfaces ou ajuste conforme necessário:

OPTIONS="-f /etc/ptp4l-G.8275.1.conf --message_tag ptp-8275.1 -i $IFNAME1 -i $IFNAME2 -i $IFNAME3 -i $IFNAME4"
Nota
Nota

Não há necessidade de definir clock_type como BC, pois isso será automaticamente implícito se mais de uma porta for fornecida.

Uma vez feito, o daemon ptp4l pode ser (re)iniciado com:

# systemctl restart ptp4l

Sem qualquer configuração de porta específica, o ptp4l executará o BMCA para determinar através de qual porta o GM pode ser alcançado. Se uma configuração estática for preferida, anexe uma seção para cada porta com a função prescrita no arquivo de configuração. Por exemplo:

# Telecom G.8275.1 example configuration
[global]
domainNumber                    24
priority2                       255
dataset_comparison              G.8275.x
G.8275.portDS.localPriority     128
G.8275.defaultDS.localPriority  128
maxStepsRemoved                 255
logAnnounceInterval             -3
logSyncInterval                 -4
logMinDelayReqInterval          -4
announceReceiptTimeout          3
ptp_dst_mac                     01:80:C2:00:00:0E
network_transport               L2

[$IFNAME1]
# Time Receiver by default

[$IFNAME2]
serverOnly                      1

[$IFNAME3]
serverOnly                      1

[$IFNAME4]
serverOnly                      1

No entanto, certifique-se de determinar a conexão correta com o GM antes de iniciar o daemon.

46.2.4 Sincronização do relógio do sistema a partir do PTP

É importante ter em mente que o PTP funciona sincronizando os relógios de hardware locais da NIC. Isso não alinha automaticamente o relógio do sistema com o GM, já que o relógio do sistema é derivado de um relógio de hardware diferente. Para manter o relógio do sistema sincronizado com o PTP, o phc2sys deve ser executado. Recomenda-se que você conclua totalmente a configuração de ptp4l antes de passar para phc2sys. phc2sys não requer um arquivo de configuração por padrão e seus parâmetros de execução podem ser controlados exclusivamente através da variável OPTIONS= presente em /etc/sysconfig/ptp4l, de maneira semelhante a ptp4l:

OPTIONS="-s $IFNAME -w"

Onde $IFNAME é o nome da interface já configurada no ptp4l que será usada como fonte para o relógio do sistema. Isso é usado para identificar o PHC de origem.

No entanto, se um perfil PTP específico ou número de domínio for usado, pode ser necessário fornecer ao phc2sys um arquivo de configuração de acordo com aquele fornecido ao ptp4l. Na maioria dos casos, ele também pode ser reutilizado diretamente com o phc2sys:

OPTIONS="-f /etc/ptp4l-G.8275.1.conf -s $IFNAME -w"

46.3 Integração com Cluster API

Sempre que um cluster é implantado por meio de um cluster de gerenciamento e provisionamento de rede direcionado, tanto o arquivo de configuração quanto as duas variáveis de configuração em /etc/sysconfig podem ser implantados no host no momento do provisionamento. Abaixo está um trecho de uma definição de cluster, com foco em um objeto RKE2ControlPlane modificado que implanta o mesmo arquivo de configuração G.8275.1 em todos os hosts:

apiVersion: controlplane.cluster.x-k8s.io/v1beta2
kind: RKE2ControlPlane
metadata:
  name: single-node-cluster
  namespace: default
spec:
  infrastructureRef:
    apiGroup: infrastructure.cluster.x-k8s.io
    kind: Metal3MachineTemplate
    name: single-node-cluster-controlplane
  replicas: 1
  version: ${RKE2_VERSION}
  rolloutStrategy:
    type: "RollingUpdate"
    rollingUpdate:
      maxSurge: 0
  registrationMethod: "control-plane-endpoint"
  serverConfig:
    cni: canal
  agentConfig:
    format: ignition
    cisProfile: cis
    additionalUserData:
      config: |
        variant: fcos
        version: 1.4.0
        systemd:
          units:
            - name: rke2-preinstall.service
              enabled: true
              contents: |
                [Unit]
                Description=rke2-preinstall
                Wants=network-online.target
                Before=rke2-install.service
                ConditionPathExists=!/run/cluster-api/bootstrap-success.complete
                [Service]
                Type=oneshot
                User=root
                ExecStartPre=/bin/sh -c "mount -L config-2 /mnt"
                ExecStart=/bin/sh -c "sed -i \"s/BAREMETALHOST_UUID/$(jq -r .uuid /mnt/openstack/latest/meta_data.json)/\" /etc/rancher/rke2/config.yaml"
                ExecStart=/bin/sh -c "echo \"node-name: $(jq -r .name /mnt/openstack/latest/meta_data.json)\" >> /etc/rancher/rke2/config.yaml"
                ExecStart=/bin/sh -c "echo \"node-label:\" >> /etc/rancher/rke2/config.yaml"
                ExecStart=/bin/sh -c "echo \"  - metal3.io/uuid=$(jq -r .uuid /mnt/openstack/latest/meta_data.json)\" >> /etc/rancher/rke2/config.yaml"
                ExecStartPost=/bin/sh -c "umount /mnt"
                [Install]
                WantedBy=multi-user.target
        storage:
          files:
            - path: /etc/ptp4l-G.8275.1.conf
              overwrite: true
              contents:
                inline: |
                  # Telecom G.8275.1 example configuration
                  [global]
                  domainNumber                    24
                  priority2                       255
                  dataset_comparison              G.8275.x
                  G.8275.portDS.localPriority     128
                  G.8275.defaultDS.localPriority  128
                  maxStepsRemoved                 255
                  logAnnounceInterval             -3
                  logSyncInterval                 -4
                  logMinDelayReqInterval          -4
                  announceReceiptTimeout          3
                  serverOnly                      0
                  ptp_dst_mac                     01:80:C2:00:00:0E
                  network_transport               L2
              mode: 0644
              user:
                name: root
              group:
                name: root
            - path: /etc/sysconfig/ptp4l
              overwrite: true
              contents:
                inline: |
                  ## Path:           Network/LinuxPTP
                  ## Description:    Precision Time Protocol (PTP): ptp4l settings
                  ## Type:           string
                  ## Default:        "-i eth0 -f /etc/ptp4l.conf"
                  ## ServiceRestart: ptp4l
                  #
                  # Arguments when starting ptp4l(8).
                  #
                  OPTIONS="-f /etc/ptp4l-G.8275.1.conf -i $IFNAME --message_tag ptp-8275.1"
              mode: 0644
              user:
                name: root
              group:
                name: root
            - path: /etc/sysconfig/phc2sys
              overwrite: true
              contents:
                inline: |
                  ## Path:           Network/LinuxPTP
                  ## Description:    Precision Time Protocol (PTP): phc2sys settings
                  ## Type:           string
                  ## Default:        "-s eth0 -w"
                  ## ServiceRestart: phc2sys
                  #
                  # Arguments when starting phc2sys(8).
                  #
                  OPTIONS="-s $IFNAME -w"
              mode: 0644
              user:
                name: root
              group:
                name: root
    kubelet:
      extraArgs:
        - provider-id=metal3://BAREMETALHOST_UUID
    nodeName: "localhost.localdomain"

Além de outras variáveis, a definição acima deve ser completada com o nome da interface e com os outros objetos do Cluster API, conforme descrito em Parte VII, “Provisionamento de rede direcionado totalmente automatizado”.

Nota
Nota
  • Essa abordagem é conveniente apenas se o hardware no cluster for uniforme e a mesma configuração for necessária em todos os hosts, incluindo o nome da interface.

  • Abordagens alternativas são possíveis e serão abordadas em versões futuras.

Neste ponto, seus hosts devem ter uma pilha PTP funcionando e em execução e começarão a negociar sua função PTP.

46.4 PTP em plataformas Intel Granite Rapids-D

O SUSE Telco Cloud suporta temporização precisa em uma variedade de plataformas diferentes, incluindo os projetos mais recentes baseados em Intel Granite Rapids-D (GNR-D). Esses novos servidores normalmente incluem um controlador Ethernet de alta velocidade integrado e uma ou mais placas adicionais com um controlador Ethernet para portas extras. Ao contrário das gerações de plataforma anteriores, eles também são equipados com um DPLL dedicado que permite o roteamento dos sinais de temporização através do sistema e das diferentes NIC, e não requer mais cabeamento externo. A implantação geral é, portanto, simplificada, mas etapas e componentes de software específicos são necessários, como o DPLL no momento da inicialização e a configuração do sinal interno.

Antes de seguir as etapas de configuração, baixe e instale o driver de kernel mais recente para os Intel 800 Series Network Devices a partir do site da Intel. Selecione o arquivo zip contendo os \"ice_RPM_Files\" e descompacte o arquivo, então instale o RPM ice-kmp-default-*sles16sp0.x86_64.rpm contido nele, por exemplo, o arquivo ice-kmp-default-2.4.5_k6.12.0_160000.5-1.sles16sp0.x86_64.rpm:

# transactional-update pkg install ice-kmp-default-2.4.5_k6.12.0_160000.5-1.sles16sp0.x86_64.rpm

Reinicie o servidor para tornar a alteração persistente e efetiva.

Nota
Nota
  • Um sistema Dell PowerEdge XR8720t será usado como sistema de referência nos exemplos; as interfaces de kernel e a configuração de porta podem ser diferentes em um servidor GNR-D diferente.

  • Assume-se uma implantação de Telco e o perfil Telco G.8275.1 é usado nas seções a seguir para PTP.

46.4.1 PTP Boundary Clock

Esta seção descreve o processo de configuração de um Boundary Clock (BC) em um sistema GNR-D, onde uma porta na NIC integrada recebe os timestamps PTP de um GM e todas as portas restantes no sistema atuam como Transmissores de Tempo para outros nós da rede.

Nota
Nota

A configuração descrita aqui é completamente estática. Se o GM ficar indisponível, a sincronização downstream dependerá exclusivamente das capacidades de holdover do host; nenhuma alternância automática para uma fonte diferente de referência de tempo será realizada.

Para habilitar o comportamento de BC, execute as seguintes etapas na mesma ordem toda vez que o sistema for inicializado:

  1. Verifique se os dispositivos PTP esperados que controlam os PHCs estão presentes:

    # ls -l /sys/class/ptp/
    total 0
    lrwxrwxrwx. 1 root root 0 Apr 27 20:21 ptp1 -> ../../devices/pci0000:12/0000:12:04.0/0000:13:00.0/ptp/ptp1
    lrwxrwxrwx. 1 root root 0 Apr 27 20:21 ptp2 -> ../../devices/pci0000:6b/0000:6b:02.0/0000:6c:00.0/ptp/ptp2
    lrwxrwxrwx. 1 root root 0 Apr 27 20:21 ptp3 -> ../../devices/pci0000:6b/0000:6b:06.0/0000:6e:00.0/ptp/ptp3
    Nota
    Nota

    Ajuste os comandos subsequentes de acordo com os nomes reais encontrados no sistema que está sendo configurado.

  2. Identifique o controlador integrado, pois ele exigirá uma configuração específica:

    A saída anterior deve indicar o dispositivo ao qual eles estão vinculados por meio do endereço PCI e você pode usar lspci para consultar o tipo de dispositivo:

    # lspci -s 0000:13:00.0
    13:00.0 Ethernet controller: Intel Corporation Ethernet Connection E825-C for SFP (rev 04)
    # lspci -s 0000:6c:00.0
    6c:00.0 Ethernet controller: Intel Corporation Ethernet Controller E830-CC for SFP
    # lspci -s 0000:6e:00.0
    6e:00.0 Ethernet controller: Intel Corporation Ethernet Controller E830-CC for SFP

    Este servidor específico está equipado com um controlador integrado Intel E825-C e duas placas adicionais E830-CC.

    Alternativamente, você pode encontrar mais informações sobre o controlador consultando a primeira porta de rede do controlador que expõe esse PHC:

    # ls -l /sys/class/ptp/ptp0/device/net/
    total 0
    drwxr-xr-x. 5 root root 0 Apr 30 15:16 em5
    # ethtool -i em5
    driver: ice
    version: 2.4.5
    firmware-version: 4.03 0x80007f91 1.3881.0
    expansion-rom-version:
    bus-info: 0000:13:00.0
    [...]

    Observe que em5 é a primeira porta do controlador Ethernet integrado neste sistema.

  3. Configure os sinais entre o PHC no controlador Ethernet integrado e o DPLL de temporização do sistema:

    1. Deixe o DPLL controlar o clock Ethernet no controlador integrado:

      # echo 4 1 > /sys/class/net/em5/device/tspll_cfg
    2. Habilite um pulso a cada início de segundo (Pulse Per Second, PPS) do PHC para o DPLL através do pino SDP2 (sinal de 1kHz):

      # echo 2 1 > /sys/class/ptp/ptp1/pins/SDP2
      # echo 1 0 0 0 1000000 > /sys/class/ptp/ptp1/period
    3. Opcionalmente, o pino SPD0 (sinal de 1Hz) também pode ser habilitado:

      # echo 2 2 > /sys/class/ptp/ptp1/pins/SDP0
      # echo 2 0 0 1 0 > /sys/class/ptp/ptp1/period
    4. Habilite o sinal de 1 PPS para ser propagado do DPLL do sistema de temporização para as placas adicionais:

      # echo 1 1 > /sys/class/ptp/ptp2/pins/SDP1
      # echo 1 1 > /sys/class/ptp/ptp3/pins/SDP1
  4. Execute ts2phc para manter os PHCs das placas adicionais sincronizados com o mesmo timestamp do PHC /dev/ptp1:

    # ts2phc -f ts2phc-aic-all.cfg -s /dev/ptp1

    Consulte Seção 46.4.2.3, “Arquivo de configuração do ts2phc para placas adicionais” para o conteúdo de ts2phc-aic-all.cfg.

  5. Execute uma instância do ptp4l para o controlador integrado (/dev/ptp1):

    # ptp4l -f ptp4l-G.8275.1-nac.conf

    Consulte Seção 46.4.2.1, “Arquivo de configuração do ptp4l para o controlador integrado (/dev/ptp1)” para o conteúdo de ptp4l-G.8275.1-nac.conf.

  6. Execute uma instância do ptp4l para cada placa adicional (/dev/ptp3 e/ou /dev/ptp2):

    # ptp4l -f ptp4l-G.8275.1-aic1.conf
    # ptp4l -f ptp4l-G.8275.1-aic2.conf

    Consulte Seção 46.4.2.2, “Arquivo de configuração do ptp4l para placas adicionais (/dev/ptp2 ou /dev/ptp3)” para o conteúdo dos arquivos de configuração.

    Nota
    Nota

    Para evitar conflitos e permitir a próxima etapa, cada uma dessas instâncias deve usar soquetes de controle e de somente leitura diferentes.

  7. Sincronize os parâmetros de runtime PTP e os valores das instâncias do ptp4l das AICs com o pmc:

    Espera-se que um BC encaminhe não apenas o horário de um GM ao qual está conectado, mas também parâmetros auxiliares, como sua classe de relógio e nível de precisão. Isso acontece automaticamente dentro de um grupo de interfaces gerenciadas pela mesma instância do ptp4l, mas não entre instâncias diferentes do ptp4l, lidando com PHCs e portas diferentes.

    Uma vez que o sistema esteja sincronizado com um GM, consulte a instância do ptp4l no controlador integrado e defina os valores nas instâncias restantes do ptp4l via comandos pmc. Por exemplo:

    # pmc -f /etc/ptp4l-G.8275.1-nac-bmca.conf -u -b 0 'GET PARENT_DATA_SET' | grep gm
                    gm.ClockClass                         8
                    gm.ClockAccuracy                      0xfe
                    gm.OffsetScaledLogVariance            0xffff
    # pmc -f /etc/ptp4l-G.8275.1-nac-bmca.conf -u -b 0 'GET TIME_PROPERTIES_DATA_SET' | grep -v PROPERTIES
                    currentUtcOffset      37
                    leap61                0
                    leap59                0
                    currentUtcOffsetValid 0
                    ptpTimescale          1
                    timeTraceable         0
                    frequencyTraceable    0
                    timeSource            0xa0
    pmc -f /etc/ptp4l-G.8275.1-aic1-static.conf -u -b 0 'SET GRANDMASTER_SETTINGS_NP
                    clockClass              8
                    clockAccuracy           0xfe
                    offsetScaledLogVariance 0xffff
                    currentUtcOffset        37
                    leap61                  0
                    leap59                  0
                    currentUtcOffsetValid   0
                    ptpTimescale            1
                    timeTraceable           0
                    frequencyTraceable      0
                    timeSource              0xa0

    Consulte Seção 46.4.2.4, “Script de encaminhamento de parâmetros GM” para automatizar este processo e evitar etapas manuais.

  8. Opcionalmente, execute o phc2sys para derivar o horário do sistema a partir da sincronização PTP:

    # phc2sys -f /etc/ptp4l-G.8275.1-nac.conf -s /dev/ptp1 -c CLOCK_REALTIME -w

    O arquivo de entrada é o mesmo arquivo de configuração usado para o ptp4l e o controlador integrado. Consulte Seção 46.2.4, “Sincronização do relógio do sistema a partir do PTP” para permitir que o systemd gerencie sua execução.

46.4.2 Arquivos de configuração

Esta seção fornece exemplos de arquivos de configuração e scripts que podem ser usados em conjunto com as etapas acima para configurar rapidamente um BC funcional no GNR-D. Os arquivos de configuração do ptp4l contêm todas as definições necessárias, sem a necessidade de sinalizadores de execução externos adicionais, e são todos baseados no perfil Telco G.8275.1. Mais detalhes são fornecidos para cada arquivo em suas respectivas seções.

46.4.2.1 Arquivo de configuração do ptp4l para o controlador integrado (/dev/ptp1)

[global]
domainNumber                    24
priority2                       255
dataset_comparison              G.8275.x
G.8275.portDS.localPriority     128
G.8275.defaultDS.localPriority  128
maxStepsRemoved                 255
logAnnounceInterval             -3
logSyncInterval                 -4
logMinDelayReqInterval          -4
announceReceiptTimeout          3
ptp_dst_mac                     01:1b:19:00:00:00
network_transport               L2
summary_interval                3
message_tag                     "ptp4l-nac"
uds_address                     /var/run/ptp4l-nac
uds_ro_address                  /var/run/ptp4lro-nac

[em1]

[em2]

[em3]

[em4]

A configuração acima aproveita o BMCA para determinar a função da porta, assumindo que um GM esteja disponível através de uma delas. Se um controle mais rigoroso for necessário, adicione o sinalizador serverOnly sob cada definição de interface. Para mais detalhes, consulte Seção 46.2.3, “Configuração PTP de um Boundary Clock” ou a configuração das placas adicionais abaixo como exemplo. Por uma questão de brevidade, apenas quatro interfaces estão listadas; você precisa ajustar de acordo com seus requisitos.

46.4.2.2 Arquivo de configuração do ptp4l para placas adicionais (/dev/ptp2 ou /dev/ptp3)

# Telecom G.8275.1 example configuration
[global]
domainNumber                    24
priority2                       255
dataset_comparison              G.8275.x
G.8275.portDS.localPriority     250
G.8275.defaultDS.localPriority  250
maxStepsRemoved                 255
logAnnounceInterval             -3
logSyncInterval                 -4
logMinDelayReqInterval          -4
announceReceiptTimeout          3
ptp_dst_mac                     01:1b:19:00:00:00
network_transport               L2
summary_interval                3
message_tag                     "ptp4l-iac1"
uds_address                     /var/run/ptp4l-aic1
uds_ro_address                  /var/run/ptp4lro-aic1

[p1p1]
serverOnly                      1

[p1p2]
serverOnly                      1

[p1p3]
serverOnly                      1

[p1p4]
serverOnly                      1

Por uma questão de brevidade, apenas quatro interfaces estão listadas. Você precisa ajustar de acordo com seus requisitos. Todas as interfaces foram definidas estaticamente para a função TimeTransmitter.

46.4.2.3 Arquivo de configuração do ts2phc para placas adicionais

[global]
use_syslog              0
verbose                 1
logging_level           7
ts2phc.pulsewidth       100000000

[p1p1]
ts2phc.channel          1
ts2phc.extts_polarity   rising
ts2phc.pin_index        1

[p2p1]
ts2phc.channel          1
ts2phc.extts_polarity   rising
ts2phc.pin_index        1

Esta configuração cobre a sincronização de duas placas adicionais (referenciadas por sua primeira porta, p1p1 e p2p1) via o SDP1 em cada controlador.

46.4.2.4 Script de encaminhamento de parâmetros GM

O script abaixo pode ser aproveitado para encaminhar os valores e parâmetros do GM para Time Receivers em portas gerenciadas por instâncias ptp4l diferentes daquela onde o GM reside. Não se esqueça de editar a seção Input variables para ajustar os nomes dos arquivos e executá-lo assim que o sistema estiver sincronizado com um GM.

#!/bin/bash

set -euo pipefail

################## Variáveis de entrada ##################
VERBOSE=1

CONFIG_FILE_NAC=/etc/ptp4l-G.8275.1-nac-bmca.conf
CONFIG_FILES_AICS=(/etc/ptp4l-G.8275.1-aic1-static.conf /etc/ptp4l-G.8275.1-aic2-static.conf)

#####################################################


# Verifique se o sistema está sincronizado com um GM
GM_PRESENT=$(pmc -f ${CONFIG_FILE_NAC} -u -b 0 'GET TIME_STATUS_NP' | awk '/gmPresent/ {print $2}')

if [ \"${GM_PRESENT}\" != \"true\" ]; then
    echo \"Nenhum GM presente, saindo...\"
    exit 1
fi

# Obtenha os valores do Grand Master \"upstream\"

PDS_GM_VALUES=$(pmc -f ${CONFIG_FILE_NAC} -u -b 0 'GET PARENT_DATA_SET' | awk 'BEGIN {ORS=" "} /gm./ {print $2}')
TPDS_GM_VALUES=$(pmc -f ${CONFIG_FILE_NAC} -u -b 0 'GET TIME_PROPERTIES_DATA_SET' | awk 'BEGIN {ORS=" "} NR>2 {print $2}')

if [ -z \"$PDS_GM_VALUES\" ]; then
    echo \"Nenhum valor de PARENT_DATA_SET recuperado\"
    exit 2
elif [ -z \"$TPDS_GM_VALUES\" ]; then
    echo \"Nenhum valor de TIME_PROPERTIES_DATA_SET recuperado\"
    exit 2
fi

# Descompactar de PARENT_DATA_SET
read CLOCK_CLASS CLOCK_ACCURACY VARIANCE <<< $PDS_GM_VALUES

# Descompactar de TIME_PROPERTIES_DATA_SET
read UTC_OFFSET LEAP_61 LEAP_59 UTC_OFFSET_VALID PTP_TIMESCALE T_TRACEABLE F_TRACEABLE T_SOURCE <<< $TPDS_GM_VALUES

if [ \"$VERBOSE\" -eq 1 ]; then +
    echo \"Lido de PARENT_DATA_SET: clockClass=${CLOCK_CLASS} clockAccuracy=${CLOCK_ACCURACY} offsetScaledLogVariance=${VARIANCE}\" +
    echo \"Lido de TIME_PROPERTIES_DATA_SET: currentUtcOffset=${UTC_OFFSET} leap61=${LEAP_61} leap59=${LEAP_59}\" \\ +
         \"currentUtcOffsetValid=${UTC_OFFSET_VALID} ptpTimescale=${PTP_TIMESCALE} timeTraceable=${T_TRACEABLE}\" \\ +
         \"frequencyTraceable=${F_TRACEABLE} timeSource=${T_SOURCE}\" +
fi


# Encaminhe esses valores para os receptores de tempo "downstream" atualizando as instâncias ptp4l

for FILE in \"${CONFIG_FILES_AICS[@]}\"; do +
    if [ \"$VERBOSE\" -eq 1 ]; then +
        echo \"Atualizando GRANDMASTER_SETTINGS_NP (${FILE})\" +
    fi

    pmc -f ${FILE} -u -b 0 'SET GRANDMASTER_SETTINGS_NP
       clockClass              '${CLOCK_CLASS}'
       clockAccuracy           '${CLOCK_ACCURACY}'
       offsetScaledLogVariance '${VARIANCE}'
       currentUtcOffset        '${UTC_OFFSET}'
       leap61                  '${LEAP_61}'
       leap59                  '${LEAP_59}'
       currentUtcOffsetValid   '${UTC_OFFSET_VALID}'
       ptpTimescale            '${PTP_TIMESCALE}'
       timeTraceable           '${T_TRACEABLE}'
       frequencyTraceable      '${F_TRACEABLE}'
       timeSource              '${T_SOURCE}'' &> /dev/null

    if [ $? -ne 0 ]; then +
        echo \"Falha ao atualizar ${FILE}\" +
    fi +
done
Nota
Nota

O script deve ser executado toda vez que o GM mudar.