deploy: 43415d2 #5 (synchronize)

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

Author: github-actions[bot]

pull/5/_sources/solutions/reference-designs/adalm-pluto/index.rst.txt

@@ -0,0 +1,51 @@
+.. _pluto users far_fast:
+
+How far/fast?
+=============
+
+The first two questions asked by many novice users of wireless communications
+are always:
+
+1. *How fast does it go?*
+2. *How far does it cover?*
+
+The answers are not practical to answer for a device like the ADALM-PLUTO, or
+any other SDR since you can gain distance by giving up datarate, gain data rate
+by increasing bandwidth, gain data rate by changing modulation scheme. The
+performance (how far/fast) of the system will depend heavily on everything from
+the choice of carrier frequency, modulation type, bandwidth, antennas, local
+environment (topography, vegetation, weather), just to name a few.
+
+Data Links vs Radios
+---------------------
+
+One of the first things to understand from a novice standpoint is the difference
+between a data link and a radio.
+
+At the top level, a `data link <https://en.wikipedia.org/wiki/Data_link>`_
+connects one location to another for the purpose of transmitting and receiving
+digital information. In most instances, we have a transmitter and a receiver and
+the channel. These are governed by a link protocol enabling digital data to be
+transferred from a data source (transmitter) to a data sink (receiver). The data
+link specifies everything that both the transmitter and a receiver need to know
+to communicate effectively. This includes such things as:
+
+* `Simplex <https://en.wikipedia.org/wiki/Simplex_communication>`_,
+  `Half-duplex <https://en.wikipedia.org/wiki/Duplex_(telecommunications)#HALF-DUPLEX>`_
+  or `Duplex <https://en.wikipedia.org/wiki/Duplex_(telecommunications)>`_
+  communication links
+* occupied bandwidth
+* center frequency
+* modulation types supported
+* negotiation of modulation types (if supported)
+* MAC protocol (multi-master, master-slave, CSMA, etc)
+
+When asking questions about how far, how fast, bit error rate - these are
+characteristics of a data link, not a radio.
+
+Since the ADALM-PLUTO is a radio, not a datalink, it is difficult to answer
+those questions.
+
+For analyzing data links, there is a great article at
+`AFAR Communications <http://www.afar.net/tutorials/how-far/>`_ which reviews
+these sorts of things.

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

@@ -21,12 +21,12 @@ Contents
 ..
    Make sure all things are in ./users
 
-#. :dokuwiki:`Introduction to the Hardware <university/tools/pluto/users/intro>`
+#. :ref:`Introduction to the Hardware <pluto users intro>`
 
-   #. :dokuwiki:`What's with the name? <university/tools/pluto/users/name>` *PlutoSDR?*
-   #. :dokuwiki:`Understanding the Internals <university/tools/pluto/users/understanding>`
-   #. :dokuwiki:`How hot? <university/tools/pluto/users/temp>`
-   #. :dokuwiki:`How Far, How fast? <university/tools/pluto/users/far_fast>`
+   #. :ref:`What's with the name? <pluto users name>` *PlutoSDR?*
+   #. :ref:`Understanding the Internals <pluto users understanding>`
+   #. :ref:`How hot? <pluto users temp>`
+   #. :ref:`How Far, How fast? <pluto users far_fast>`
 
       #. :dokuwiki:`RF Output <university/tools/pluto/users/transmit>`
 
@@ -37,7 +37,7 @@ Contents
          #. :dokuwiki:`Receiver Sensitivity <university/tools/pluto/users/receiver_sensitivity>`
          #. :dokuwiki:`Dealing with Non-Quadrature signals <university/tools/pluto/users/non_quad>`
 
-   #. :dokuwiki:`Antennas <university/tools/pluto/users/antennas>`
+   #. :ref:`Antennas <pluto users antennas>`
    #. :dokuwiki:`Letter of Volatility <university/tools/pluto/users/letter_of_volatility_pluto.pdf>`
 
 #. :dokuwiki:`Quick Start <university/tools/pluto/users/quick_start>`
@@ -69,7 +69,7 @@ Contents
       `SoapyPlutoSDR <https://github.com/jocover/SoapyPlutoSDR>`__
    #. `Access and control of PlutoSDR hardware using python bindings to libiio <https://github.com/radiosd/PlutoSdr>`__
    #. :dokuwiki:`Python Interfaces </resources/tools-software/linux-software/pyadi-iio>`
-   #. :dokuwiki:`C Examples </university/tools/pluto/controlling_the_transceiver_and_transferring_data>`
+   #. :ref:`C Examples <pluto transceiver_transferring_data>`
 
 #. :dokuwiki:`/university/tools/pluto/Accessories </Accessories>`
 

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

@@ -0,0 +1,60 @@
+.. _pluto users intro:
+
+Introduction to the ADALM-PLUTO
+================================
+
+.. image:: pluto_on_desk.png
+   :width: 400px
+   :align: center
+
+To use the :adi:`ADALM-PLUTO` Active Learning Module, you have:
+
+RF Connectors
+-------------
+
+* 2 RF `SMA connectors <https://en.wikipedia.org/wiki/SMA_connector>`_ [1]_
+  to connect to instrumentation or antennas
+
+  * Transmit (labeled 'Tx')
+  * Receive (labeled 'Rx')
+  * 300 MHz - 3.8 GHz
+  * 200 kHz - 20 MHz channel bandwidth
+
+USB Connectivity
+----------------
+
+* USB for your host connectivity (used to stream data)
+
+  * USB 2 (480 Mbits/second)
+  * libiio USB device for communicating to the RF device
+  * Network device
+
+    * Remote Network Driver Interface Specification
+      (`RNDIS <https://en.wikipedia.org/wiki/RNDIS>`_)
+    * This will enumerate with the ``192.168.2.1`` IP address by default.
+
+  * USB serial device
+
+    * "provides access to the Linux console on the Pluto device via USB
+      Communication Device Class Abstract Control Model"
+      (`USB CDC ACM <https://en.wikipedia.org/wiki/USB_communications_device_class>`_)
+
+  * Mass storage device
+
+    * this will appear to the host as a disk, where you can find links for
+      software uploads, and the serial number of the device.
+
+External Power
+--------------
+
+* External power
+
+  * During Pluto design, potential consumption exceeded 5 unit loads for
+    `USB 2 <https://en.wikipedia.org/wiki/USB#Power>`_ (500mA), so a backup
+    power connector was added. Not necessary for nominal use.
+  * An external adapter
+    (like `this one from Adafruit <https://www.adafruit.com/products/1995>`_)
+  * "We know the 'Power' icon is the 'on/off' icon, if you think that is
+    confusing - please let us know."
+
+.. [1] SubMiniature version A