Skip to content

iio: logic: Add ADSY1100 Apollo SOM Nyx RFFE controller #3331

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mhennerich wants to merge 5 commits into
base: main
Choose a base branch
from
Open

iio: logic: Add ADSY1100 Apollo SOM Nyx RFFE controller #3331

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
869b4c2
dt-bindings: iio: logic: Add ADSY1100 Nyx RFFE controller
mhennerich May 20, 2026
e871d3e
iio: logic: Add ADSY1100 Nyx RF front-end driver
mhennerich May 6, 2026
e78167b
arm64: dts: xilinx: Add ADSY1100 Nyx RFFE overlay for vu11p-ad9084-vpx
mhennerich May 6, 2026
b622ef0
firmware: Add 204C M4 L4 NP16 8p0 4x4 device profile
mhennerich May 20, 2026
5ec39d0
arm64: defconfig: adi_zynqmp_adsy1100: Enable ADSY1100 Nyx RFFE driver
mhennerich May 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
262 changes: 262 additions & 0 deletions Documentation/devicetree/bindings/iio/logic/adi,adsy1100-nyx.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,262 @@
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iio/logic/adi,adsy1100-nyx.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Analog Devices ADSY1100 Apollo SOM "Nyx" RF front-end controller

maintainers:
- Michael Hennerich <michael.hennerich@analog.com>

description: |
GPIO-driven controller for the four RX and four TX RF channels of the
ADSY1100 Apollo SOM "Nyx" daughter board. The driver consumes the 76
control GPIOs that drive the per-channel digital step attenuators (DSA),
filter band-selection multiplexers, channel powerdown and the RX LNA
bypass switches, and exposes high-level IIO controls.

Per-channel power-on defaults can optionally be supplied through the
output-channels (TX) and input-channels (RX) container nodes. Defaults
supplied this way are applied at probe time, before the IIO device is
registered, so the hardware comes up in the requested state.

Built-in defaults applied to every channel before any DT subnode is
parsed are:
- attenuation = 0 mdB (hardwaregain 0 dB)
- filter mode = THRU
- powerdown = disabled (channel enabled)
- RX LNA = disabled (bypass=1)

properties:
compatible:
const: adi,adsy1100-nyx

out-gpios:
description: |
Array of 76 control GPIOs. Layout, in the order listed:
[ 0.. 7] TX3..TX0 filter_ctrl_{0,1} (TX descending)
[ 8..15] RX3..RX0 filter_ctrl_{0,1} (RX descending)
[16..21] TX0 dsa[0..5]
[22..27] TX1 dsa[0..5]
[28..33] TX2 dsa[0..5]
[34..39] TX3 dsa[0..5]
[40..45] RX0 dsa[0..5]
[46..51] RX1 dsa[0..5]
[52..57] RX2 dsa[0..5]
[58..63] RX3 dsa[0..5]
[64..67] TX0..TX3 enable
[68..71] RX0..RX3 enable
[72..75] RX0..RX3 amp_bypass
minItems: 76
maxItems: 76

label:
description: Human-readable label for this RFFE instance.

output-channels:
type: object
description: |
Container for per-TX-channel (output) power-on default
configuration. Each child node configures one of the four TX paths.
properties:
'#address-cells':
const: 1
'#size-cells':
const: 0
patternProperties:
"^channel@[0-3]$":
type: object
description: Per-TX-channel default configuration. Index 0..3.
properties:
reg:
minimum: 0
maximum: 3
description: TX channel index (0..3).

adi,attenuation-millidb:
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 0
maximum: 31500
multipleOf: 500
default: 0
description: |
Initial digital step attenuator (DSA) setting in
milli-dB. The DSA has 0.5 dB resolution, so the value
must be a multiple of 500. Maps to a negative IIO
hardwaregain in sysfs (e.g. 6000 mdB attenuation -> -6 dB
hardwaregain).

adi,filter-mode:
$ref: /schemas/types.yaml#/definitions/uint32
enum: [0, 1, 2, 3]
default: 1
description: |
Initial filter band. Use one of the ADSY1100_NYX_FILTER_*
macros from <dt-bindings/iio/adi,adsy1100-nyx.h>:
0 = LOW_BAND
1 = THRU
2 = X_BAND
3 = KU_BAND

adi,powerdown:
type: boolean
description: |
If present, the channel is powered down at probe time
instead of being brought up enabled.

required:
- reg
additionalProperties: false
additionalProperties: false

input-channels:
type: object
description: |
Container for per-RX-channel (input) power-on default
configuration. Each child node configures one of the four RX paths.
properties:
'#address-cells':
const: 1
'#size-cells':
const: 0
patternProperties:
"^channel@[0-3]$":
type: object
description: Per-RX-channel default configuration. Index 0..3.
properties:
reg:
minimum: 0
maximum: 3
description: RX channel index (0..3).

adi,attenuation-millidb:
$ref: /schemas/types.yaml#/definitions/uint32
minimum: 0
maximum: 31500
multipleOf: 500
default: 0
description: |
Initial digital step attenuator (DSA) setting in
milli-dB. The DSA has 0.5 dB resolution, so the value
must be a multiple of 500. Maps to a negative IIO
hardwaregain in sysfs.

adi,filter-mode:
$ref: /schemas/types.yaml#/definitions/uint32
enum: [0, 1, 2, 3]
default: 1
description: |
Initial filter band. Use one of the ADSY1100_NYX_FILTER_*
macros from <dt-bindings/iio/adi,adsy1100-nyx.h>.

adi,powerdown:
type: boolean
description: |
If present, the channel is powered down at probe time
instead of being brought up enabled.

adi,amplifier-enable:
type: boolean
description: |
If present, the RX LNA is brought into the signal path at
probe time (bypass_amplifier_en=0). When absent the LNA is
bypassed (default).

required:
- reg
additionalProperties: false
additionalProperties: false

required:
- compatible
- out-gpios

additionalProperties: false

examples:
- |
#include <dt-bindings/iio/logic/adi,adsy1100-nyx.h>

rffe {
compatible = "adi,adsy1100-nyx";
label = "nyx_controls";

out-gpios = <&gpio_a 0 0>, <&gpio_a 1 0>, <&gpio_a 2 0>,
<&gpio_a 3 0>, <&gpio_a 4 0>, <&gpio_a 5 0>,
<&gpio_a 6 0>, <&gpio_a 7 0>, <&gpio_a 8 0>,
<&gpio_a 9 0>, <&gpio_a 10 0>, <&gpio_a 11 0>,
<&gpio_a 12 0>, <&gpio_a 13 0>, <&gpio_a 14 0>,
<&gpio_a 15 0>, <&gpio_a 16 0>, <&gpio_a 17 0>,
<&gpio_a 18 0>, <&gpio_a 19 0>, <&gpio_a 20 0>,
<&gpio_a 21 0>, <&gpio_a 22 0>, <&gpio_a 23 0>,
<&gpio_a 24 0>, <&gpio_a 25 0>, <&gpio_a 26 0>,
<&gpio_a 27 0>, <&gpio_a 28 0>, <&gpio_a 29 0>,
<&gpio_a 30 0>, <&gpio_a 31 0>, <&gpio_b 0 0>,
<&gpio_b 1 0>, <&gpio_b 2 0>, <&gpio_b 3 0>,
<&gpio_b 4 0>, <&gpio_b 5 0>, <&gpio_b 6 0>,
<&gpio_b 7 0>, <&gpio_b 8 0>, <&gpio_b 9 0>,
<&gpio_b 10 0>, <&gpio_b 11 0>, <&gpio_b 12 0>,
<&gpio_b 13 0>, <&gpio_b 14 0>, <&gpio_b 15 0>,
<&gpio_b 16 0>, <&gpio_b 17 0>, <&gpio_b 18 0>,
<&gpio_b 19 0>, <&gpio_b 20 0>, <&gpio_b 21 0>,
<&gpio_b 22 0>, <&gpio_b 23 0>, <&gpio_b 24 0>,
<&gpio_b 25 0>, <&gpio_b 26 0>, <&gpio_b 27 0>,
<&gpio_b 28 0>, <&gpio_b 29 0>, <&gpio_b 30 0>,
<&gpio_b 31 0>, <&gpio_c 0 0>, <&gpio_c 1 0>,
<&gpio_c 2 0>, <&gpio_c 3 0>, <&gpio_c 4 0>,
<&gpio_c 5 0>, <&gpio_c 6 0>, <&gpio_c 7 0>,
<&gpio_c 8 0>, <&gpio_c 9 0>, <&gpio_c 10 0>,
<&gpio_c 11 0>;

output-channels {
#address-cells = <1>;
#size-cells = <0>;

channel@0 {
reg = <0>;
adi,attenuation-millidb = <6000>; /* -6.0 dB */
adi,filter-mode = <ADSY1100_NYX_FILTER_X_BAND>;
};
channel@1 {
reg = <1>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
channel@2 {
reg = <2>;
adi,filter-mode = <ADSY1100_NYX_FILTER_KU_BAND>;
adi,powerdown;
};
channel@3 {
reg = <3>;
adi,filter-mode = <ADSY1100_NYX_FILTER_LOW_BAND>;
};
};

input-channels {
#address-cells = <1>;
#size-cells = <0>;

channel@0 {
reg = <0>;
adi,attenuation-millidb = <3500>; /* -3.5 dB */
adi,filter-mode = <ADSY1100_NYX_FILTER_X_BAND>;
};
channel@1 {
reg = <1>;
adi,filter-mode = <ADSY1100_NYX_FILTER_LOW_BAND>;
adi,amplifier-enable; /* bring LNA into the path */
};
channel@2 {
reg = <2>;
adi,filter-mode = <ADSY1100_NYX_FILTER_KU_BAND>;
};
channel@3 {
reg = <3>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
adi,powerdown;
};
};
};
...
120 changes: 120 additions & 0 deletions arch/arm64/boot/dts/xilinx/vu11p-ad9084-vpx-adsy1100-nyx.dtso
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
// SPDX-License-Identifier: GPL-2.0
/*
* Device-tree overlay that instantiates the ADSY1100 Apollo SOM "Nyx"
* RF front-end controller (drivers/iio/logic/adsy1100_nyx.c) on top of
* the vu11p-ad9084-vpx-revb base overlay.
*
* Adds a dedicated adsy1100-nyx node so the board binds against the
* high-level RFFE driver. The dormant rfpc_one_bit_adc_dac stub
* provided by the base overlay is left disabled.
*/
/dts-v1/;
/plugin/;

#define DEVICE_PROFILE_NAME "204C_M4_L4_NP16_8p0_4x4.bin"

#include "vu11p-ad9084-vpx-reva.dtso"
#include <dt-bindings/iio/logic/adi,adsy1100-nyx.h>

&adsy1100_nyx {
label = "nyx_controls";
status = "okay";

out-gpios = <&axi_gpio_1 33 0>, <&axi_gpio_1 34 0>,
<&axi_gpio_1 35 0>, <&axi_gpio_1 36 0>,
<&axi_gpio_1 37 0>, <&axi_gpio_1 38 0>,
<&axi_gpio_1 39 0>, <&axi_gpio_1 40 0>,
<&axi_gpio_1 41 0>, <&axi_gpio_1 42 0>,
<&axi_gpio_1 43 0>, <&axi_gpio_1 44 0>,
<&axi_gpio_1 45 0>, <&axi_gpio_1 46 0>,
<&axi_gpio_1 47 0>, <&axi_gpio_1 48 0>,
<&axi_gpio_1 49 0>, <&axi_gpio_1 50 0>,
<&axi_gpio_1 51 0>, <&axi_gpio_1 52 0>,
<&axi_gpio_1 53 0>, <&axi_gpio_1 54 0>,
<&axi_gpio_1 55 0>, <&axi_gpio_1 56 0>,
<&axi_gpio_1 57 0>, <&axi_gpio_1 58 0>,
<&axi_gpio_1 59 0>, <&axi_gpio_1 60 0>,
<&axi_gpio_1 61 0>, <&axi_gpio_1 62 0>,
<&axi_gpio_1 63 0>, <&axi_gpio_2 0 0>,
<&axi_gpio_2 1 0>, <&axi_gpio_2 2 0>,
<&axi_gpio_2 3 0>, <&axi_gpio_2 4 0>,
<&axi_gpio_2 5 0>, <&axi_gpio_2 6 0>,
<&axi_gpio_2 7 0>, <&axi_gpio_2 8 0>,
<&axi_gpio_2 9 0>, <&axi_gpio_2 10 0>,
<&axi_gpio_2 11 0>, <&axi_gpio_2 12 0>,
<&axi_gpio_2 13 0>, <&axi_gpio_2 14 0>,
<&axi_gpio_2 15 0>, <&axi_gpio_2 16 0>,
<&axi_gpio_2 17 0>, <&axi_gpio_2 18 0>,
<&axi_gpio_2 19 0>, <&axi_gpio_2 20 0>,
<&axi_gpio_2 21 0>, <&axi_gpio_2 22 0>,
<&axi_gpio_2 23 0>, <&axi_gpio_2 24 0>,
<&axi_gpio_2 25 0>, <&axi_gpio_2 26 0>,
<&axi_gpio_2 27 0>, <&axi_gpio_2 28 0>,
<&axi_gpio_2 29 0>, <&axi_gpio_2 30 0>,
<&axi_gpio_2 31 0>, <&axi_gpio_2 32 0>,
<&axi_gpio_2 33 0>, <&axi_gpio_2 34 0>,
<&axi_gpio_2 35 0>, <&axi_gpio_2 36 0>,
<&axi_gpio_2 37 0>, <&axi_gpio_2 38 0>,
<&axi_gpio_2 39 0>, <&axi_gpio_2 40 0>,
<&axi_gpio_2 41 0>, <&axi_gpio_2 42 0>,
<&axi_gpio_2 43 0>, <&axi_gpio_2 44 0>;

/*
* Per-channel power-on defaults. The values below match the
* driver's built-in defaults (0 dB attenuation, THRU filter,
* channel enabled, RX LNA bypassed) and are included here as
* a template -- edit per channel to override.
*/
output-channels {
#address-cells = <1>;
#size-cells = <0>;

channel@0 {
reg = <0>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
channel@1 {
reg = <1>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
channel@2 {
reg = <2>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
channel@3 {
reg = <3>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
};

input-channels {
#address-cells = <1>;
#size-cells = <0>;

channel@0 {
reg = <0>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
/* adi,amplifier-enable; -- uncomment to bring the LNA into path */
};
channel@1 {
reg = <1>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
channel@2 {
reg = <2>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
channel@3 {
reg = <3>;
adi,attenuation-millidb = <0>;
adi,filter-mode = <ADSY1100_NYX_FILTER_THRU>;
};
};
};
7 changes: 7 additions & 0 deletions arch/arm64/boot/dts/xilinx/vu11p-ad9084-vpx-reva.dtso
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -682,4 +682,11 @@
#size-cells = <0>;
status = "disabled";
};

adsy1100_nyx: adsy1100-nyx@0 {
compatible = "adi,adsy1100-nyx";
#address-cells = <1>;
#size-cells = <0>;
status = "disabled";
};
};
Loading
Loading