Commit 397b5cbc authored by Emil Gydesen's avatar Emil Gydesen Committed by Mahesh Mahadevan
Browse files

doc: Use correct RST headings in autopts-linux.rst 

The documentation guidelines have a specified order of
header underlines that this file did not follow.

Signed-off-by: default avatarEmil Gydesen <emil.gydesen@nordicsemi.no>
parent 38a70cc1

doc/connectivity/bluetooth/autopts/autopts-linux.rst

+19 −19
Changes for doc/connectivity/bluetooth/autopts/autopts-linux.rst: 19 added lines, 19 removed lines.
Original line number Diff line number Diff line
@@ -24,10 +24,10 @@ For running with QEMU or :ref:`native_sim <native_sim>`, see :ref:`bluetooth_qem 
    :depth: 2



Setup Linux

===========

***********



Install nrftools (only required in the actual hardware test mode)

=================================================================

*****************************************************************



Download latest nrftools (version >= 10.12.1) from site

https://www.nordicsemi.com/Software-and-tools/Development-Tools/nRF-Command-Line-Tools/Download.
@@ -47,7 +47,7 @@ and README.md. To install the tools, double click on each .deb file or follow 
instructions from README.md.



Setup Windows 10 virtual machine

==================================

********************************



Choose and install your hypervisor like VMWare Workstation(preferred) or

VirtualBox. On VirtualBox could be some issues, if your host has fewer than 6 CPU.
@@ -58,17 +58,17 @@ installed guest extensions. 
Setup tested with VirtualBox 6.1.18 and VMWare Workstation 16.1.1 Pro.



Update Windows

---------------

==============



Update Windows in:



Start -> Settings -> Update & Security -> Windows Update



Setup static IP

----------------

===============



WMWare Works

^^^^^^^^^^^^^

------------



On Linux, open Virtual Network Editor app and create network:
@@ -92,7 +92,7 @@ If you type 'ifconfig' in terminal, you should be able to find your host IP: 
   :align: center



VirtualBox

^^^^^^^^^^^^^

----------



Go to:
@@ -114,7 +114,7 @@ Add adapter 2: 
   :align: center



Windows

^^^^^^^^

-------

Setup static IP on Windows virtual machine. Go to



Settings -> Network & Internet -> Ethernet -> Unidentified network -> Edit
@@ -127,7 +127,7 @@ and set: 
   :align: center



Install Python 3

-----------------

================



Download and install latest `Python 3 <https://www.python.org/downloads/>`_ on Windows.

Let the installer add the Python installation directory to the PATH and
@@ -144,7 +144,7 @@ disable the path length limitation. 
   :align: center



Install Git

------------

===========



Download and install `Git <https://git-scm.com/downloads>`_.

During installation enable option: Enable experimental support for pseudo
@@ -156,7 +156,7 @@ consoles. We will use Git Bash as Windows terminal. 
   :align: center



Install PTS 8

--------------

=============



On Windows virtual machine, install latest PTS from https://www.bluetooth.org.

Remember to install drivers from installation directory
@@ -173,7 +173,7 @@ Remember to install drivers from installation directory 
    So to capture Bluetooth events, you have to download it separately.



Connect PTS dongle

--------------------

==================



With VirtualBox there should be no problem. Just find dongle in Devices -> USB and connect.
@@ -202,7 +202,7 @@ Write anywhere in the file following line: 
just replace 0x0a12 with Vendor number and 0x0001 with ProdID number you found earlier.



Connect devices (only required in the actual hardware test mode)

================================================================

****************************************************************



.. image:: devices_1.png

   :height: 400
@@ -215,7 +215,7 @@ Connect devices (only required in the actual hardware test mode) 
   :align: center



Flash board (only required in the actual hardware test mode)

============================================================

************************************************************



On Linux, go to ~/zephyrproject. There should be already ~/zephyrproject/build

directory. Flash board:
@@ -225,10 +225,10 @@ directory. Flash board: 
    west flash



Setup auto-pts project

=======================

**********************



AutoPTS client on Linux

------------------------

=======================



Clone auto-pts project:
@@ -252,7 +252,7 @@ Install required python modules: 
   pip3 install --user -r autoptsclient_requirements.txt



Autopts server on Windows virtual machine

------------------------------------------

=========================================

In Git Bash, clone auto-pts project repo:



.. code-block::
@@ -270,7 +270,7 @@ Install required python modules: 
Restart virtual machine.



Running AutoPTS

================

****************



Server and client by default will run on localhost address. Run server:
@@ -338,7 +338,7 @@ At the first run, when Windows asks, enable connection through firewall: 
   :align: center



Troubleshooting

================

****************



- "After running one test, I need to restart my Windows virtual machine to run another, because of fail verdict from APICOM in PTS logs."

CRA Git | Maintained and supported by SUSTech CRA and CCSE