docs: Migrate network documentation of sim to Documentations

Move the docs in boards of sim to common place.

Signed-off-by: Huang Qi <huangqi3@xiaomi.com>
This commit is contained in:
Huang Qi 2024-09-12 22:56:03 +08:00 committed by Xiang Xiao
parent 74df0974b2
commit 55e4a98df7
3 changed files with 36 additions and 9 deletions

View File

@ -12,3 +12,5 @@ The following Simulator/Emulators are supported:
:glob:
*/*
network_linux
network_vpnkit

View File

@ -25,7 +25,8 @@ you assign an IP that is already in use on your network, your host won't be
able to see it until the simulation is stopped. The host route will force all
traffic destined for that IP to be sent to the tap interface.
NOTE: If you configure an IP address that is not on the same subnet as your
.. note::
If you configure an IP address that is not on the same subnet as your
host, additional manual setup will be required. A helper script,
`tools/simhostroute.sh` is provided that can do this setup on Linux.
On Windows or macOS using host route mode is not recommended.
@ -41,6 +42,8 @@ configuration.
To compile:
.. code-block:: bash
$ cp boards/sim/sim/sim/configs/tcpblaster/defconfig .config
$ make menuconfig # optional, to adjust configuration
$ make clean; make
@ -49,6 +52,8 @@ You can do the following after compiling the NuttX simulator:
On Linux:
.. code-block:: bash
$ # necessary on recent Linux distributions
$ sudo setcap cap_net_admin+ep ./nuttx
$ # set up the host route and IP tables rules
@ -59,6 +64,8 @@ On Linux:
On the NuttX Simulator:
.. code-block:: bash
nsh> # replace or omit dns if needed, IPv6 line is optional
nsh> ifconfig eth0 inet6 fc00::2/112 dns 2001:4860:4860::8888
nsh> ifconfig eth0 10.0.1.2 dns 8.8.8.8
@ -66,6 +73,8 @@ On the NuttX Simulator:
On Linux:
.. code-block:: bash
$ # is nuttx up?
$ ping 10.0.1.2
@ -84,6 +93,8 @@ To create the bridge, first install the bridge utilities package for your
platform (the net-tools RPM in RedHat, for example). Then execute a
command like the following:
.. code-block:: bash
# ip link add nuttx0 type bridge
This will create the nuttx0 bridge. Once created, the bridge may be used by
@ -100,6 +111,8 @@ that the subnet chosen should not already be in use. For example, if
you want to use the 172.26.23.0/24 subnet for your simluations, you
would do something like the following:
.. code-block:: bash
# ip link add nuttx0 type bridge
# ifconfig nuttx0 172.26.23.1/24
@ -119,6 +132,8 @@ with NuttX. For example, if you have a secondary eth1 interface on your host,
you can simply connect it to the network you want your simulations to access,
and run the following command:
.. code-block:: bash
# ip link set eth1 master nuttx0
From that point on, your simulations will be directly connected to the same
@ -129,6 +144,8 @@ If you only have a single interface, you can configure your system so that eth0
(or other primary interface) is on the bridge. To do this, you would execute
commands like the following from the system console:
.. code-block:: bash
# ip link add nuttx0 type bridge
# ip link set eth0 master nuttx0
# ifconfig nuttx0 <host-ip-address/netmask>

View File

@ -8,37 +8,45 @@ as well.
Configuration
-------------
.. code-block:: bash
CONFIG_SIM_NETDEV=y
CONFIG_SIM_NETDEV_TAP is not set
CONFIG_SIM_NETDEV_VPNKIT=y
CONFIG_SIM_NETDEV_VPNKIT_PATH="/tmp/vpnkit-nuttx"
You can use the sim:vpnkit configuration, which includes the above
You can use the ``sim:vpnkit`` configuration, which includes the above
settings.
.. code-block:: bash
./tools/configure.sh sim:vpnkit
VPNKit setup
------------
See https://github.com/moby/vpnkit for build instructions.
See `https://github.com/moby/vpnkit` for build instructions.
If you have Docker Desktop for Mac installed on your machine,
you can find a vpnkit binary at:
.. code-block:: bash
/Applications/Docker.app/Contents/Resources/bin/com.docker.vpnkit
A docker image containing a static Linux binary is also available:
https://hub.docker.com/r/djs55/vpnkit
`https://hub.docker.com/r/djs55/vpnkit`
How to run
----------
You can use it as the following:
.. code-block:: bash
% vpnkit --ethernet /tmp/vpnkit-nuttx &
% ./nuttx
NuttX's CONFIG_SIM_NETDEV_VPNKIT_PATH should match vpnkit's
--ethernet option.
NuttX's ``CONFIG_SIM_NETDEV_VPNKIT_PATH`` should match vpnkit's
``--ethernet`` option.