summaryrefslogtreecommitdiffstats
path: root/Documentation/user/system-setup.rst
blob: 7e4a7669a8fec68104ac071858bb9638d6dcbee3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
Appendix: System Setup
======================

Serial Console Access
---------------------

As most current development machines don't have serial ports, the usual setup
is to use a USB-Serial-Converter. Some evaluation boards have such a converter
on board. After connecting, these usually show up on your host as
``/dev/ttyUSB#`` or ``/dev/ttyACM#`` (check ``dmesg`` to find out).

On Debian systems, the device node will be accessible to the ``dialout`` group,
so adding your user to that group (``adduser <user> dialout``) removes the need
for root privileges.

Using the "screen" program
^^^^^^^^^^^^^^^^^^^^^^^^^^

The terminal manager ``screen`` can also be used as a simple terminal emulator::

  screen /dev/ttyUSB0 115200

To exit from ``screen``, press ``<CTRL-A> <K> <y>``.

Using the "microcom" program
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A good alternative terminal program is microcom. On Debian it can be installed
with ``apt-get install microcom``, on other distributions it can be installed
from source:

http://git.pengutronix.de/?p=tools/microcom.git;a=summary

Usage is simple::

  microcom -p /dev/ttyUSB0

Network Access
--------------

Having network connectivity between your host and your target will save you a
lot of time otherwise spent on writing SD cards or using JTAG. The main
protocols used with barebox are DHCP, TFTP and NFS.

Configuration of dnsmasq for DHCP and TFTP
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The ``dnsmasq`` program can be configured as a DHCP and TFTP server in addition
to its original DNS functionality::

  sudo ip addr add 192.168.23.1/24 dev <interface>
  sudo ip link set <interface> up
  sudo /usr/sbin/dnsmasq --interface=<interface> --no-daemon --log-queries \
    --enable-tftp --tftp-root=<absolute-path-to-your-images>/ \
    --dhcp-range=192.168.23.240,192.168.23.250

Configuration of a TFTP Server
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Configuration of a BOOTP / DHCP Server
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Configuring a NFS Server
^^^^^^^^^^^^^^^^^^^^^^^^