mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-01 23:46:45 +00:00

Microchip Azurite ZL3073x represents chip family providing DPLL and optionally PHC (PTP) functionality. The chips can be connected be connected over I2C or SPI bus. They have the following characteristics: * up to 5 separate DPLL units (channels) * 5 synthesizers * 10 input pins (references) * 10 outputs * 20 output pins (output pin pair shares one output) * Each reference and output can operate in either differential or single-ended mode (differential mode uses 2 pins) * Each output is connected to one of the synthesizers * Each synthesizer is driven by one of the DPLL unit The device uses 7-bit addresses and 8-bits values. It exposes 8-, 16-, 32- and 48-bits registers in address range <0x000,0x77F>. Due to 7bit addressing, the range is organized into pages of 128 bytes, with each page containing a page selector register at address 0x7F. For reading/writing multi-byte registers, the device supports bulk transfers. Add basic functionality to access device registers, probe functionality both I2C and SPI cases and add devlink support to provide info and to set clock ID parameter. Signed-off-by: Ivan Vecera <ivecera@redhat.com> Reviewed-by: Jiri Pirko <jiri@nvidia.com> Link: https://patch.msgid.link/20250704182202.1641943-6-ivecera@redhat.com Signed-off-by: Jakub Kicinski <kuba@kernel.org>
52 lines
1.0 KiB
ReStructuredText
52 lines
1.0 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
=======================
|
|
zl3073x devlink support
|
|
=======================
|
|
|
|
This document describes the devlink features implemented by the ``zl3073x``
|
|
device driver.
|
|
|
|
Parameters
|
|
==========
|
|
|
|
.. list-table:: Generic parameters implemented
|
|
:widths: 5 5 90
|
|
|
|
* - Name
|
|
- Mode
|
|
- Notes
|
|
* - ``clock_id``
|
|
- driverinit
|
|
- Set the clock ID that is used by the driver for registering DPLL devices
|
|
and pins.
|
|
|
|
Info versions
|
|
=============
|
|
|
|
The ``zl3073x`` driver reports the following versions
|
|
|
|
.. list-table:: devlink info versions implemented
|
|
:widths: 5 5 5 90
|
|
|
|
* - Name
|
|
- Type
|
|
- Example
|
|
- Description
|
|
* - ``asic.id``
|
|
- fixed
|
|
- 1E94
|
|
- Chip identification number
|
|
* - ``asic.rev``
|
|
- fixed
|
|
- 300
|
|
- Chip revision number
|
|
* - ``fw``
|
|
- running
|
|
- 7006
|
|
- Firmware version number
|
|
* - ``custom_cfg``
|
|
- running
|
|
- 1.3.0.1
|
|
- Device configuration version customized by OEM
|