Quick Start
-----------

Please read also chapters :ref:`genericconfiguration` and :ref:`requirementslabhost`
and to get a rough overview for the lab setup check :ref:`labsetup`

To get fast a working setup you can use the script:

https://github.com/hsdenx/tbottest/tree/master/scripts/create_setup.sh

which will create you a complete base setup, as described in `configuration`_.

Here an example run:

.. code-block:: bash

    $ wget -q https://github.com/hsdenx/tbottest/raw/master/scripts/create_setup.sh
    $ chmod 777 create_setup.sh
    $ ./create_setup.sh --inter
    Name of the lab: foolabname
    Hostname of the lab: 192.168.1.113
    Username for login into lab: pi
    Name of the board in your lab: foobar
    Sispmctl MAC: 01:01:4f:09:5b
    Sispmctl Port: 1
    Klone nach 'tbot' ...
    [...]
    Klone nach 'tbottest' ...
    [...]
    add commandline completions with:
    echo source tbottest/completions.sh
    echo
    echo start tbot with:
    echo tbottest/newtbot_starter.py @tbotconfig/foobar/args/argsbase
    echo
    echo Now edit lab config in tbotconfig/foobar/tbot.ini
    echo
    echo check that 'ssh pi@192.168.1.113' works without typing password
    than interactive lab should work:
    tbottest/newtbot_starter.py @tbotconfig/foobar/args/argsfoobar-noeth tbotconfig.interactive.lab

    edit and adapt U-Boot settings in tbotconfig/foobar/foobar.ini and interactive U-Boot should work
    tbottest/newtbot_starter.py @tbotconfig/foobar/args/argsfoobar-noeth tbotconfig.interactive.uboot

    edit linux settings in tbotconfig/foobar/foobar.ini and interactive U-Boot should work
    tbottest/newtbot_starter.py @tbotconfig/foobar/args/argsfoobar-noeth tbotconfig.interactive.linux


Test your new config and setup with:

.. code-block:: bash

    $ tbottest/newtbot_starter.py @tbotconfig/foobar/args/argsfoobar-noeth tbotconfig.interactive.lab
    tbot starting ...
    ├─TBOT.FLAGS {'boardfile:tbotconfig/foobar/foobar.ini', 'noethinit', 'picocom', 'inifile:tbotconfig/foobar/tbot.ini', 'do_power', 'useifconfig'}
    ├─boardname now foobar
    ├─Using kas file kas-denx-withdldir.yml
    FILENAME  ~/temp/tbotconfig/foobar/tbot.ini-modified
    ├─Calling lab ...
    │   ├─[local] ssh -o BatchMode=yes -i /home/pi/.ssh/id_rsa -p 22 pi@192.168.1.113
    │   ├─Entering interactive shell ...
    │   ├─Press CTRL+] three times within 1 second to exit.

    foolabname: ~> exit
    │   ├─Exiting interactive shell ...
    │   └─Done. (3.496s)
    ├─────────────────────────────────────────
    └─SUCCESS (3.576s)
    $

To be independent of the installed tbot on the system, you can use the
tbot starter script:

https://github.com/hsdenx/tbottest/blob/master/newtbot_starter.py