deploy: a56d803 #4 (synchronize)

https://plescaevelyn.github.io/adi-documentation/pull/4

Author: github-actions[bot]

pull/4/_sources/learning/workshop_what_sw_for_sdr/advanced_sdr_exercises/index.rst.txt

@@ -21,6 +21,25 @@ techniques, multi-channel systems, and real-world communication protocols.
 
 Learning to **test your SDR and find mistakes on your own** is the critical step that differentiates a beginner from an advanced-level SDR user. While beginners focus on running predefined exercises and observing expected results, advanced users develop the skills to validate system performance, identify impairments, and troubleshoot issues independently. The following exercises build these advanced capabilities.
 
+Familiarize Yourself with the Tools
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Before starting these advanced exercises, ensure you're thoroughly familiar with the SDR hardware and tools you'll be using. Advanced SDR work requires deep understanding of hardware capabilities, limitations, and performance characteristics.
+
+**Explore the Hardware:**
+
+* :doc:`ADALM-Pluto (PlutoSDR) </tools/pluto/index>` - Learn about the Pluto SDR platform, including hardware specifications, software drivers, and getting started guides.
+
+These resources provide critical information for advanced work:
+
+* Detailed hardware specifications and RF performance characteristics
+* Understanding hardware impairments (I/Q imbalance, LO leakage, phase noise)
+* Software drivers and advanced API features (PyADI-IIO, GNU Radio, etc.)
+* Calibration procedures and performance optimization
+* System architecture and signal chain details
+
+Advanced SDR users must understand not just *how* to use the tools, but *why* they behave the way they do. This knowledge is essential for debugging complex issues and optimizing system performance.
+
 First Steps in SDR Testing
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

pull/4/_sources/learning/workshop_what_sw_for_sdr/beginner_sdr_exercises/index.rst.txt

@@ -17,6 +17,25 @@ complex signal processing algorithms without custom hardware design.
 ..
 ..    Download the ADI Kuiper 2.0 image: `Kuiper 2.0 SD Card Image <PLACEHOLDER_URL>`_
 
+Familiarize Yourself with the Tools
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Before diving into the exercises, we recommend familiarizing yourself with the SDR hardware and tools you'll be using. Understanding your hardware's capabilities, features, and interfaces will help you get the most out of these exercises.
+
+**Explore the Hardware:**
+
+* :doc:`ADALM-Pluto (PlutoSDR) </tools/pluto/index>` - Learn about the Pluto SDR platform, including hardware specifications, software drivers, and getting started guides.
+
+These resources provide important information about:
+
+* Hardware specifications and capabilities
+* Supported frequency ranges and bandwidth
+* Software drivers and libraries (PyADI-IIO, GNU Radio, etc.)
+* Connectivity options and interfaces
+* Calibration and performance characteristics
+
+Taking time to understand your hardware will make the exercises more meaningful and help you troubleshoot issues more effectively.
+
 .. _sinewave-loopback:
 
 Transmit and receive a complex sinusoid (Sinewave Loopback)

pull/4/learning/workshop_what_sw_for_sdr/advanced_sdr_exercises/index.html

@@ -96,6 +96,7 @@
         <nav>
           <ul>
 <li><a class="reference internal" href="#">Advanced SDR Exercises</a><ul>
+<li><a class="reference internal" href="#familiarize-yourself-with-the-tools">Familiarize Yourself with the Tools</a></li>
 <li><a class="reference internal" href="#first-steps-in-sdr-testing">First Steps in SDR Testing</a><ul>
 <li><a class="reference internal" href="#using-pyadi-iio-with-pluto">Using PyADI-IIO with Pluto</a></li>
 <li><a class="reference internal" href="#using-pyadi-iio-with-jupiter">Using PyADI-IIO with Jupiter</a></li>
@@ -595,6 +596,23 @@ <h1>Advanced SDR Exercises<a class="headerlink" href="#advanced-sdr-exercises" t
 </div>
 <p><strong>What Separates Beginners from Advanced SDR Users:</strong></p>
 <p>Learning to <strong>test your SDR and find mistakes on your own</strong> is the critical step that differentiates a beginner from an advanced-level SDR user. While beginners focus on running predefined exercises and observing expected results, advanced users develop the skills to validate system performance, identify impairments, and troubleshoot issues independently. The following exercises build these advanced capabilities.</p>
+<section id="familiarize-yourself-with-the-tools">
+<h2>Familiarize Yourself with the Tools<a class="headerlink" href="#familiarize-yourself-with-the-tools" title="Link to this heading"></a></h2>
+<p>Before starting these advanced exercises, ensure you’re thoroughly familiar with the SDR hardware and tools you’ll be using. Advanced SDR work requires deep understanding of hardware capabilities, limitations, and performance characteristics.</p>
+<p><strong>Explore the Hardware:</strong></p>
+<ul class="simple">
+<li><p><a class="reference internal" href="../../../tools/pluto/index.html"><span class="doc">ADALM-Pluto (PlutoSDR)</span></a> - Learn about the Pluto SDR platform, including hardware specifications, software drivers, and getting started guides.</p></li>
+</ul>
+<p>These resources provide critical information for advanced work:</p>
+<ul class="simple">
+<li><p>Detailed hardware specifications and RF performance characteristics</p></li>
+<li><p>Understanding hardware impairments (I/Q imbalance, LO leakage, phase noise)</p></li>
+<li><p>Software drivers and advanced API features (PyADI-IIO, GNU Radio, etc.)</p></li>
+<li><p>Calibration procedures and performance optimization</p></li>
+<li><p>System architecture and signal chain details</p></li>
+</ul>
+<p>Advanced SDR users must understand not just <em>how</em> to use the tools, but <em>why</em> they behave the way they do. This knowledge is essential for debugging complex issues and optimizing system performance.</p>
+</section>
 <section id="first-steps-in-sdr-testing">
 <h2>First Steps in SDR Testing<a class="headerlink" href="#first-steps-in-sdr-testing" title="Link to this heading"></a></h2>
 <p>This exercise teaches you how to validate SDR performance and identify common impairments by transmitting a complex sinusoid through a loopback connection and analyzing key metrics. Understanding how to test and characterize your SDR is fundamental to developing robust wireless systems.</p>

pull/4/learning/workshop_what_sw_for_sdr/beginner_sdr_exercises/index.html

@@ -96,6 +96,7 @@
         <nav>
           <ul>
 <li><a class="reference internal" href="#">Beginner SDR Exercises</a><ul>
+<li><a class="reference internal" href="#familiarize-yourself-with-the-tools">Familiarize Yourself with the Tools</a></li>
 <li><a class="reference internal" href="#transmit-and-receive-a-complex-sinusoid-sinewave-loopback">Transmit and receive a complex sinusoid (Sinewave Loopback)</a><ul>
 <li><a class="reference internal" href="#using-pyadi-iio-with-pluto">Using PyADI-IIO with Pluto</a></li>
 <li><a class="reference internal" href="#using-pyadi-iio-with-jupiter">Using PyADI-IIO with Jupiter</a></li>
@@ -581,6 +582,23 @@ <h1>Beginner SDR Exercises<a class="headerlink" href="#beginner-sdr-exercises" t
 The Kuiper image contains all necessary software pre-installed, including Python, GNU Radio, Thonny IDE, and all required libraries.
 Connect your SDR hardware (Pluto, Jupiter, or Talise) to the Raspberry Pi 5 before starting the exercises.</p>
 </div>
+<section id="familiarize-yourself-with-the-tools">
+<h2>Familiarize Yourself with the Tools<a class="headerlink" href="#familiarize-yourself-with-the-tools" title="Link to this heading"></a></h2>
+<p>Before diving into the exercises, we recommend familiarizing yourself with the SDR hardware and tools you’ll be using. Understanding your hardware’s capabilities, features, and interfaces will help you get the most out of these exercises.</p>
+<p><strong>Explore the Hardware:</strong></p>
+<ul class="simple">
+<li><p><a class="reference internal" href="../../../tools/pluto/index.html"><span class="doc">ADALM-Pluto (PlutoSDR)</span></a> - Learn about the Pluto SDR platform, including hardware specifications, software drivers, and getting started guides.</p></li>
+</ul>
+<p>These resources provide important information about:</p>
+<ul class="simple">
+<li><p>Hardware specifications and capabilities</p></li>
+<li><p>Supported frequency ranges and bandwidth</p></li>
+<li><p>Software drivers and libraries (PyADI-IIO, GNU Radio, etc.)</p></li>
+<li><p>Connectivity options and interfaces</p></li>
+<li><p>Calibration and performance characteristics</p></li>
+</ul>
+<p>Taking time to understand your hardware will make the exercises more meaningful and help you troubleshoot issues more effectively.</p>
+</section>
 <section id="transmit-and-receive-a-complex-sinusoid-sinewave-loopback">
 <span id="sinewave-loopback"></span><h2>Transmit and receive a complex sinusoid (Sinewave Loopback)<a class="headerlink" href="#transmit-and-receive-a-complex-sinusoid-sinewave-loopback" title="Link to this heading"></a></h2>
 <p>A complex sinusoid is a fundamental building block in software-defined radio. Unlike a real sinusoid