solutions/reference-designs/ad-swiot1l-sl/sample_application: Add Tem… by plescaevelyn · Pull Request #433 · analogdevicesinc/documentation

plescaevelyn · 2026-04-20T13:49:36Z

…perature Controller sample application

This sample application demonstrates a closed-loop temperature control system using the AD-SWIOT1L-SL platform with 10BASE-T1L connectivity.

The demo showcases:

Real-time temperature monitoring via TMP01 sensor connected to AD-SWIOT1L-SL voltage input channel
Automatic fan control with configurable ON/OFF thresholds and hysteresis to prevent rapid cycling
Dual AD-SWIOT1L-SL setup: one for sensing, one for actuation
Communication over Single Pair Ethernet through AD-RPI-T1LPSE-SL
Live matplotlib visualization of temperature trends and fan state

Hardware setup instructions cover wiring the TMP01 sensor, fan actuator, and power resistor (simulating heat source). Software setup includes pyadi-iio installation, firmware flashing with static IPs, device tree overlays, and NetworkManager configuration for the T1L interfaces.

Ideal for prototyping thermal management systems, process monitoring, or learning closed-loop control concepts with industrial Ethernet.

The application is deployed here: https://plescaevelyn.github.io/adi-documentation/pull/20/solutions/reference-designs/ad-swiot1l-sl/sample_application/index.html

Type

Documentation
Bug fix
New feature
Continuous integration

Checklist

I have performed a self-review of changes
I have followed the guidelines:
I have used the appropriate roles and directives:
- https://analogdevicesinc.github.io/doctools/docs_guidelines/roles.html
- https://analogdevicesinc.github.io/doctools/docs_guidelines/directives.html
I ensured that binary data was committed to git lfs:
- https://analogdevicesinc.github.io/documentation/contributing/creating_new_pages.html#adding-images-and-other-binary-files
I have built the pages I edited or created, using either make html or adoc serve:
- https://analogdevicesinc.github.io/doctools/cli.html#serve
I have signed-off my commits and believe my contribution improves the repository.

plescaevelyn · 2026-04-21T14:39:18Z

Hey @thorenscientific, could you please review this PR?

thorenscientific

@plescaevelyn just a few suggestions, looks good!

thorenscientific · 2026-05-04T15:10:50Z

+Prerequisites
+-------------
+
+- Python 3.8 or newer (3.8–3.11 tested with pyadi-iio). Ensure that a


This is a tricky one - the versions pyadi-iio is tested against is updated periodically, see pyadi-iio/.github/workflows/test.yml
The current testing range is 3.10 to 3.14. I'd suggest saying:
"Python 3.10 or newer. (Refer to pyadi-iio documentation for currently supported versions.)"
...even though the documentation doesn't list this, I'll suggest this to @tfcollins . https://analogdevicesinc.github.io/pyadi-iio/guides/quick.html would be a good place.

I added this, adding the supported versions to the doc is a great idea. Thanks for the review!

thorenscientific · 2026-05-04T19:29:23Z

+
+- Git command-line tools installed.
+
+- Raspberry Pi with :adi:`Kuiper 2` image installed. Follow the instructions in


change to :adi:kuiper-linux
(kuiper 2 doesn't return anything)

thorenscientific · 2026-05-04T19:33:17Z

+- Git command-line tools installed.
+
+- Raspberry Pi with :adi:`Kuiper 2` image installed. Follow the instructions in
+  the :doc:`/linux/kuiper/index` documentation to prepare the Raspberry Pi.


I think it's better to use the kuiper tag, :ref:kuiper

thorenscientific · 2026-05-04T19:35:15Z

+- 1x :adi:`TMP01` Temperature Sensor
+- 1x MC002103 DC Axial Fan
+- 1x Raspberry Pi USB Type-C Power Supply (5V, 3A)
+- 1x Power Resistor (6.2Ω, 10W was used by us)


1x 6.2Ω, 10W Power Resistor

(don't hint at other options, don't want anyone burning themselves :) )

thorenscientific · 2026-05-04T19:36:09Z

+- 1x MC002103 DC Axial Fan
+- 1x Raspberry Pi USB Type-C Power Supply (5V, 3A)
+- 1x Power Resistor (6.2Ω, 10W was used by us)
+- 1x Power Supply for the Power Resistor (5V, 1A was used by us)


1x 5V, 1A Power Supply for the Power Resistor (a 5V USB charger is a convenient option)

thorenscientific · 2026-05-04T19:38:17Z

+   - **Channel 4 (CH4)** is configured as a **Voltage Input** to measure the
+     TMP01 analog output. Connect:
+
+     - ``CH4 SWIO`` → ``TMP01 VOUT``


change VOUT to VPTAT, that's the name of the pin.

thorenscientific · 2026-05-04T19:42:00Z

+
+   .. note::
+
+      CH3 provides a regulated 5 V supply to power the TMP01, while CH4 is


Let's start this note with:
"VPTAT is a voltage output that is proportional to absolute temperature. The temperature in degrees Celsius is then calculated in software."

Added, thanks!

thorenscientific · 2026-05-04T19:48:05Z

+      :show-user:
+
+      $ git clone https://github.com/analogdevicesinc/pyadi-iio.git
+      $ cd pyadi-iio


Ideally analogdevicesinc/pyadi-iio#734 should be merged first or concurrent with this example.

thorenscientific · 2026-05-04T19:49:58Z

@@ -0,0 +1,372 @@
+Sample Application
+==================


let's make this a bit more descriptive:
Temperature Controller Sample Application

And give the page a tag like:
.. _swiot1l_temp_ctrl_sample_app:

…perature Controller sample application This sample application demonstrates a closed-loop temperature control system using the AD-SWIOT1L-SL platform with 10BASE-T1L connectivity. The demo showcases: - Real-time temperature monitoring via TMP01 sensor connected to AD-SWIOT1L-SL voltage input channel - Automatic fan control with configurable ON/OFF thresholds and hysteresis to prevent rapid cycling - Dual AD-SWIOT1L-SL setup: one for sensing, one for actuation - Communication over Single Pair Ethernet through AD-RPI-T1LPSE-SL - Live matplotlib visualization of temperature trends and fan state Hardware setup instructions cover wiring the TMP01 sensor, fan actuator, and power resistor (simulating heat source). Software setup includes pyadi-iio installation, firmware flashing with static IPs, device tree overlays, and NetworkManager configuration for the T1L interfaces. Ideal for prototyping thermal management systems, process monitoring, or learning closed-loop control concepts with industrial Ethernet. Signed-off-by: Evelyn Plesca <evelyn-iulia.plesca@analog.com>

thorenscientific reviewed May 4, 2026

View reviewed changes

plescaevelyn force-pushed the swiot1l-sample-app-clean branch from 5b67d25 to 24afd6d Compare May 11, 2026 18:21

gastmaier force-pushed the main branch from 5d55409 to 1885490 Compare May 27, 2026 08:43

gastmaier closed this May 27, 2026

gastmaier force-pushed the main branch from 1885490 to 6915555 Compare May 27, 2026 09:08


		- Git command-line tools installed.

		- Raspberry Pi with :adi:`Kuiper 2` image installed. Follow the instructions in


		.. note::

		CH3 provides a regulated 5 V supply to power the TMP01, while CH4 is

Uh oh!

Conversation

plescaevelyn commented Apr 20, 2026

Type

Checklist

Uh oh!

plescaevelyn commented Apr 21, 2026

Uh oh!

thorenscientific left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants