From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 82C3F3E0C66 for ; Mon, 4 May 2026 15:53:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=170.10.133.124 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777910038; cv=none; b=N/j3OPUOgHLJ6TZVsugn4sYWLdBxljIIZt2rjTr9Ops3LXGOYOImGx9IKLwgi0fGzOf4i+72qUlq2ScH26UjiKDgVzHp/2cFvM2z5zz/S8npC6jkiy27lvKR37c7FoFmgZG/Oqvc2cDObwLO5IFKtpW/KILRRDsrzr7NfLFL+3Y= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777910038; c=relaxed/simple; bh=7DoUuX0+RGh2JVfU5wVKKGYKwB5AQXrt1NRBgjRFfGQ=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=hP1JO9lvI3z45+q/wRAmlh8VJ6p8KZcSKu8lbGj7PxQlIiNRXiJ7AuzWBG5fKPp2kHCrXzvTldDdzfbopf7S6B/eH4Hvhs/nNzveNga5KpfViyOGmbK4OpTVgyRQ8c/ocpbsqHGiFh8B1+ZTLYsG0AI9hqzqQ56cLabZE/m4d0A= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com; spf=pass smtp.mailfrom=redhat.com; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b=HV8RQlnw; arc=none smtp.client-ip=170.10.133.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=redhat.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="HV8RQlnw" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1777910035; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=DaQO+lQ/WhzSgRpUYtckS0TDp3/BHCsX9FCd+/WxZyE=; b=HV8RQlnwSpmbYnsBdKyvaF4DNDTnJgxf4gGbwn23hrQzG8Yc/wrwztCcCEvOkIWMVg5KPn TbVkI5OqbWNcDPKV1FgIvNuswYv4jmvj+aOWe/bUm6hTN5Q1hQXyzLgcYgpvi8+kRb9mak Q/lANAuV/W+FBpMJyt13EuHXVR08h6k= Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-94-zg4FzEtmO5-QrekueoNmbg-1; Mon, 04 May 2026 11:53:51 -0400 X-MC-Unique: zg4FzEtmO5-QrekueoNmbg-1 X-Mimecast-MFC-AGG-ID: zg4FzEtmO5-QrekueoNmbg_1777910028 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 31864195608E; Mon, 4 May 2026 15:53:48 +0000 (UTC) Received: from p16v.luc.cera.cz (unknown [10.44.32.88]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id A3A4819560A6; Mon, 4 May 2026 15:53:41 +0000 (UTC) From: Ivan Vecera To: netdev@vger.kernel.org, Jiri Pirko Cc: Andrew Lunn , Arkadiusz Kubalewski , "David S. Miller" , Donald Hunter , Eric Dumazet , Jakub Kicinski , Jonathan Corbet , Leon Romanovsky , Mark Bloch , Michal Schmidt , Paolo Abeni , Pasi Vaananen , Petr Oros , Prathosh Satish , Saeed Mahameed , Shuah Khan , Simon Horman , Tariq Toukan , Vadim Fedorenko , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-rdma@vger.kernel.org Subject: [PATCH net-next v3 0/2] dpll: rework fractional frequency offset reporting Date: Mon, 4 May 2026 17:53:38 +0200 Message-ID: <20260504155340.411063-1-ivecera@redhat.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Rework how the fractional frequency offset (FFO) is reported in the DPLL subsystem. Both fractional-frequency-offset (PPM) and fractional-frequency-offset-ppt (PPT) attributes are now present at the top level of a pin and inside each pin-parent-device nest. They carry the same measurement at different precisions. The ffo_get callback distinguishes the two contexts: dpll=NULL for the top-level call (RX vs TX symbol rate offset) and a valid dpll pointer for the nested per-parent call (pin vs DPLL offset). This allows drivers to report a different value per parent DPLL if needed. Patch 1 adds both attributes to the pin-parent-device subset, updates the DPLL netlink handling to emit both at each level, updates the YAML spec and driver-api documentation, and adds NULL guards to mlx5 and zl3073x drivers. Patch 2 implements the nested FFO for zl3073x using the dpll_df_offset_x register with ref_ofst=1, providing 2^-48 resolution. The old per-reference frequency measurement is removed as it was redundant with measured-frequency. Changes v2 -> v3: - Keep both FFO attributes (PPM and PPT) at both levels instead of moving PPT under pin-parent-device only (Jiri Pirko) - Unify attribute documentation to describe semantics at each level Changes v1 -> v2: - Minor commit message fixes Ivan Vecera (2): dpll: add fractional frequency offset to pin-parent-device dpll: zl3073x: report FFO as DPLL vs input reference offset Documentation/driver-api/dpll.rst | 15 +++++++ Documentation/netlink/specs/dpll.yaml | 28 +++++++----- drivers/dpll/dpll_netlink.c | 23 +++++----- drivers/dpll/dpll_nl.c | 2 + drivers/dpll/zl3073x/chan.c | 31 ++++++++++++- drivers/dpll/zl3073x/chan.h | 14 ++++++ drivers/dpll/zl3073x/core.c | 45 ------------------- drivers/dpll/zl3073x/dpll.c | 34 +++++++------- drivers/dpll/zl3073x/ref.h | 14 ------ drivers/dpll/zl3073x/regs.h | 15 +++++++ .../net/ethernet/mellanox/mlx5/core/dpll.c | 4 ++ 11 files changed, 125 insertions(+), 100 deletions(-) -- 2.53.0