deploy: d705d53 #5 (synchronize)

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

Author: github-actions[bot]

pull/5/_sources/tools/pluto/devs/index.rst.txt

@@ -28,7 +28,7 @@ Content
    #. :dokuwiki:`Schematics <university/tools/m2k/hacking/hardware>`
    #. :dokuwiki:`Detailed Performance <university/tools/m2k/devs/performance>`
    #. :dokuwiki:`Accessing FPGA JTAG <university/tools/m2k/devs/fpga>` with the
-      :dokuwiki:`ADALM-JTAGUART </university/tools/uartjtag>` adapter
+      :ref:`ADALM-JTAGUART <uartjtag>` adapter
 
 #. C Applications or Shell scripts on the Pluto
 

pull/5/_sources/tools/pluto/hacking/power_amp.rst.txt

@@ -272,7 +272,7 @@ with pin control.
 Testing in IIO Oscilloscope
 ---------------------------
 
-The :dokuwiki:`Advanced Tab </resources/tools-software/linux-software/fmcomms2_advanced_plugin#axillary_io_adc_dac_control_io_temp_sensor>`
+The `Advanced Tab <https://analogdevicesinc.github.io/scopy/plugins/ad936x/index.html>`__
 indicates how to control these in the IIO oscilloscope.
 
 .. [1]

pull/5/_sources/tools/pluto/users/asee_papers.rst.txt

@@ -0,0 +1,60 @@
+.. _pluto users asee_papers:
+
+ASEE Papers using the Pluto SDR
+================================
+
+This page documents academic papers that utilize the ADALM-Pluto SDR platform
+in educational settings.
+
+Incorporating PlutoSDR in Communication Laboratory and Classroom
+-----------------------------------------------------------------
+
+**Authors:** John E. Post (Embry-Riddle Aeronautical University), Dennis A.
+Silage (Temple University)
+
+**Summary:** The paper explores integrating the $99 Pluto SDR—based on Analog
+Devices' AD9363 RF transceiver—into undergraduate communication courses. Key
+capabilities include "20 MHz of tunable channel bandwidth between 325 MHz to
+3.8 GHz" and full-duplex operation at 61.44 MSPS. The authors discuss software
+control via MATLAB, Simulink, GNU Radio, and HDL, plus practical laboratory
+demonstrations and student feedback.
+
+**Link:** https://strategy.asee.org/incorporating-plutosdr-in-the-communication-laboratory-and-classroom-potential-or-pitfall
+
+Experience of IoT Transceiver with Affordable SDR Platform
+-----------------------------------------------------------
+
+**Author:** Dr. Liang Hong (Tennessee State University)
+
+**Summary:** Project-based learning module combining IoT and SDR concepts using
+affordable hardware. The module emphasizes "hands-on experience in IoT domain"
+with assessment rubrics and measurable learning outcomes, including improved
+student engagement in wireless communications and broadened minority
+participation.
+
+**Link:** https://peer.asee.org/experience-of-iot-transceiver-with-affordable-software-defined-radio-platform.pdf
+
+Sample-Based Understanding of Wireless Transceivers
+----------------------------------------------------
+
+**Author:** Alexander M. Wyglinski (Worcester Polytechnic Institute)
+
+**Summary:** Educational framework viewing "communication system from the
+analog-to-digital converter (ADC) and digital-to-analog converter (DAC)"
+perspective. Curriculum progresses from fundamentals through modulation
+schemes, timing correction, and multicarrier modulation, utilizing Pluto SDR's
+compact form factor for classroom and field learning.
+
+**Link:** https://peer.asee.org/sample-based-understanding-of-wireless-transceivers-and-digital-transmission-via-software-defined-radio.pdf
+
+Software-Defined Radio Course in Computer Science
+--------------------------------------------------
+
+**Author:** Marc Lichtman (University of Maryland College Park)
+
+**Summary:** Addresses workforce gaps by offering SDR/DSP coursework within
+Computer Science rather than traditional ECE departments, recognizing that
+"software focused positions are more abundant" in industry and CS curricula
+emphasize coding skills aligned with professional demands.
+
+**Link:** https://peer.asee.org/design-and-outcome-of-a-course-on-software-defined-radio-within-the-computer-science-department.pdf

pull/5/_sources/tools/pluto/users/calibration.rst.txt

@@ -0,0 +1,12 @@
+.. _pluto users calibration:
+
+Calibrating the ADALM-PLUTO
+============================
+
+The Rakon oscillator found on the ADALM-PLUTO is ±25 ppm. We can help calibrate
+that out.
+
+.. note::
+
+   This page needs more detail later. If you have questions about calibration,
+   please ask on :ez:`EngineerZone </>`.

pull/5/_sources/tools/pluto/users/customizing.rst.txt

@@ -0,0 +1,294 @@
+.. _pluto users customizing:
+
+Customizing the ADALM-PLUTO
+============================
+
+Changing the Network
+--------------------
+
+The `RFC 1918 <https://en.wikipedia.org/wiki/Private_network#Private_IPv4_address_spaces>`__
+reserves the ``192.168.*.*`` range for private networks. Analog Devices uses
+``192.168.2.*`` for PlutoSDR devices, which may conflict with existing networks
+using the same subnet.
+
+The default network settings are:
+
+.. code-block:: ini
+
+   [NETWORK]
+   hostname = pluto
+   ipaddr = 192.168.2.1
+   ipaddr_host = 192.168.2.10
+   netmask = 255.255.255.0
+
+.. image:: images/customizing/win_config_file.png
+   :width: 500px
+
+You can modify these values to avoid conflicts. Both addresses must remain
+unique and on the same subnet.
+
+Multiple Devices
+~~~~~~~~~~~~~~~~~
+
+For multiple PlutoSDR units on a single host:
+
+* **USB mode**: Works without modifications
+* **Network mode**: Requires unique IP address assignments for each device
+
+Each device must have a distinct subnet to prevent address collisions.
+
+Zeroconf/mDNS
+~~~~~~~~~~~~~
+
+The Avahi daemon running on the PlutoSDR enables zero-configuration networking.
+The hostname can be customized in ``config.txt`` and allows connection via
+``hostname.local`` format.
+
+Linux
+^^^^^
+
+Install Avahi support:
+
+.. code-block:: bash
+
+   analog@analog:~$ sudo apt-get install avahi-daemon avahi-utils
+
+Discovery commands:
+
+.. code-block:: bash
+
+   analog@analog:~$ avahi-resolve --name pluto.local
+   analog@analog:~$ avahi-browse -d local _ssh._tcp --resolve -t
+   analog@analog:~$ avahi-browse -d local _sftp-ssh._tcp --resolve -t
+
+Windows
+^^^^^^^
+
+Windows implements LLMNR (Link-Local Multicast Name Resolution) by default,
+which Avahi doesn't support. You may need applications like Skype, iTunes, or
+Adobe Photoshop that bundle compatible protocols.
+
+Config File Actions
+-------------------
+
+The ``[ACTIONS]`` section in ``config.txt`` allows you to trigger specific
+operations:
+
+.. code-block:: ini
+
+   [ACTIONS]
+   diagnostic_report = 0
+   dfu = 0
+   reset = 0
+
+Available actions:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Action
+     - Function
+   * - ``diagnostic_report = 1``
+     - Generates status file for troubleshooting
+   * - ``dfu = 1``
+     - Enters Device Firmware Upgrade mode
+   * - ``reset = 1``
+     - Reboots the device
+
+**Process**: Edit ``config.txt`` → Save → Eject USB drive (not unplug) →
+Device processes changes after 2-3 seconds.
+
+Upgrading the RF Transceiver
+-----------------------------
+
+The ADALM-PLUTO can be configured to emulate different AD936x variants:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 30 20 30
+
+   * - Chip
+     - Tuning Range
+     - Bandwidth
+     - Channels
+   * - AD9363 (default)
+     - 325-3800 MHz
+     - 20 MHz
+     - 2 Rx, 2 Tx
+   * - AD9364
+     - 70-6000 MHz
+     - 56 MHz
+     - 1 Rx, 1 Tx
+   * - AD9361
+     - 70-6000 MHz
+     - 56 MHz
+     - 2 Rx, 2 Tx
+
+.. warning::
+
+   This only changes the software configuration. The hardware is still an
+   AD9363, but it will operate with the extended capabilities of the selected
+   variant.
+
+Configuration via U-Boot
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Access the device via serial connection or SSH (user: ``root``, password:
+``analog``) and use U-Boot ``fw_printenv`` and ``fw_setenv`` commands.
+
+**For AD9364 mode (70-6000 MHz, 1R1T):**
+
+.. code-block:: bash
+
+   root@pluto:~# fw_setenv attr_name compatible
+   root@pluto:~# fw_setenv attr_val ad9364
+   root@pluto:~# fw_setenv compatible ad9364
+   root@pluto:~# reboot
+
+**For AD9361 mode with 2R2T:**
+
+.. code-block:: bash
+
+   root@pluto:~# fw_setenv attr_name compatible
+   root@pluto:~# fw_setenv attr_val ad9361
+   root@pluto:~# fw_setenv compatible ad9361
+   root@pluto:~# fw_setenv mode 2r2t
+   root@pluto:~# reboot
+
+Changing the Root Password (v0.32+)
+------------------------------------
+
+Initial Setup
+~~~~~~~~~~~~~
+
+First-time users must format the mtd2 partition:
+
+.. code-block:: bash
+
+   root@pluto:~# device_format_jffs2
+
+This requires confirmation and erases the JFFS2 partition in 64KB increments.
+
+Setting a New Password
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   root@pluto:~# device_passwd
+
+The system prompts for a new password with validation (minimum length
+requirements apply).
+
+Password Reset
+~~~~~~~~~~~~~~
+
+If you forget the password, add ``revert_passwd = 1`` under ``[ACTIONS]`` in
+``config.txt`` to restore default credentials (root/analog).
+
+Persistent SSH Keys (v0.32+)
+-----------------------------
+
+Prerequisites
+~~~~~~~~~~~~~
+
+Format the mtd2 partition first using ``device_format_jffs2``.
+
+Setup
+~~~~~
+
+.. code-block:: bash
+
+   root@pluto:~# device_persistent_keys
+
+This generates 256-bit ECDSA keys stored on the mtd2 partition. The system
+validates the MD5 sum at boot and uses persistent keys instead of generating
+temporary ones.
+
+The output includes:
+
+* Key fingerprint (SHA1)
+* Public key portion (ECDSA format)
+
+USB Ethernet Compatibility Modes
+---------------------------------
+
+Supported Protocols
+~~~~~~~~~~~~~~~~~~~
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Mode
+     - Platform Support
+   * - RNDIS (default)
+     - Windows ✓, Linux ✓, macOS ✗
+   * - CDC-NCM
+     - Linux ✓, macOS ✓, iPad ✓
+   * - CDC-ECM
+     - Linux ✓, Android ✓
+
+.. note::
+
+   * Default RNDIS doesn't work on macOS.
+   * iPad requires high-power USB 2.0 support (500mA); iPhone doesn't qualify.
+
+Configuration Methods
+~~~~~~~~~~~~~~~~~~~~~
+
+**Method 1 - Config File:**
+
+.. code-block:: ini
+
+   [SYSTEM]
+   usb_ethernet_mode = ncm
+
+**Method 2 - U-Boot Environment:**
+
+.. code-block:: bash
+
+   root@pluto:~# fw_setenv usb_ethernet_mode ncm
+   root@pluto:~# reboot
+
+**Mode Values:**
+
+* ``rndis`` or blank = RNDIS (default)
+* ``ncm`` = CDC-NCM
+* ``ecm`` = CDC-ECM
+
+Access Methods
+--------------
+
+Serial Connection
+~~~~~~~~~~~~~~~~~
+
+Available through platform-specific drivers. See the
+:ref:`driver installation pages <pluto-m2k drivers windows>`.
+
+SSH/Ethernet
+~~~~~~~~~~~~
+
+Connect to ``192.168.2.1`` (default):
+
+* Username: ``root``
+* Password: ``analog``
+
+.. code-block:: bash
+
+   analog@analog:~$ ssh root@192.168.2.1
+
+Web Interface
+~~~~~~~~~~~~~
+
+The mass storage device is accessible when connected via USB. Open
+``config.txt`` in a text editor to modify settings.
+
+Important Notes
+---------------
+
+* File edits require proper ejection (not unplugging) to trigger processing
+* Hostname customization enables convenient network discovery
+* Multiple devices require subnet separation to prevent conflicts
+* Password and SSH key changes persist across reboots when stored on mtd2
+* Platform-specific USB mode selection prevents driver incompatibilities