02-quick-start.rst

.. _beagleconnect-freedom-quick-start:

Quick Start Guide
####################

What's included in the box?
****************************

1. BeagleConnect Freedom board in enclosure
2. Antenna
3. USB cable
4. Quick-start card

.. todo::

   Image with what's inside the box and a better description.

.. only:: latex
    
   .. image:: https://img.youtube.com/vi/bJYZ6PTiV9g/maxresdefault.jpg
      :alt: BeagleConnect unboxing YouTube video
      :width: 1280
      :target: https://www.youtube.com/watch?v=bJYZ6PTiV9g

.. only:: html

    .. raw:: html

        <iframe style="display: block; margin: auto;" width="1280" height="720" style="align:center" 
        src="https://www.youtube.com/embed/bJYZ6PTiV9g" 
        title="YouTube video player" 
        frameborder="0" 
        allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" 
        allowfullscreen>
        </iframe>


Attaching antenna
******************

To connect the SubGHz antenna with SMA connector to the BeagleConnect Freedom 
you just have to align, place and rotate the antenna clockwise as shown in the 
image below. To detach the antenna just twist it anti-clockwise.

.. figure:: media/BeagleConnect-Freedom-antenna-connection.*
   :align: center
   :width: 1247

   Aattaching antenna to BeagleConnect Freedom


Tethering to PC
****************

.. todo::

   Describe how to get a serial connection.

Wireless Connection
********************

.. todo::

   Describe how to get an IEEE802.15.4g connection from BeaglePlay.


Access Micropython
*******************

Boards come pre-flashed with Micropython. Read :ref:`beagleconnect-freedom-using-micropython` for
more details.

.. todo::

   Describe how to get to a local console and websockets console.


Demos and Tutorials
*******************

* :ref:`beagleconnect-freedom-using-greybus`
* :ref:`beagleconnect-freedom-using-micropython`
* :ref:`beagleconnect-freedom-using-zephyr`