zephyr

History

Jędrzej Ciupis 741972cf56 samples: net: wpan(usb\|serial): exclude thingy53_nrf5340_cpuapp_ns This commit excludes thingy53_nrf5340_cpuapp_ns platform from building wpanusb and wpan_serial samples. The platform doesn't support TF-M yet and therefore the build is bound to fail. Due to limitations of the filter functionality, a more generic approach where _ns platforms without TF-M support would be excluded from the build, for example: filter: dt_chosen_enabled("zephyr,ieee802154") and CONFIG_NRF_SOC_SECURE_SUPPORTED doesn't properly filter out the needed platforms. As a result, platform_exclude syntax is used to specifically exclude the platform. Signed-off-by: Jędrzej Ciupis <jedrzej.ciupis@nordicsemi.no>		2022-11-15 12:13:46 +00:00
..
src	samples: net: wpanusb: document endianness	2022-10-12 18:40:59 +02:00
CMakeLists.txt	…
README.rst	kconfig: remove redundant IEEE 802.15.4 defaults or selections	2022-08-05 12:56:47 +02:00
app.overlay	…
prj.conf	…
sample.yaml	samples: net: wpan(usb\|serial): exclude thingy53_nrf5340_cpuapp_ns	2022-11-15 12:13:46 +00:00

README.rst

.. _wpan_serial-sample:

802.15.4 "serial-radio" sample
##############################

Overview
********

The wpan_serial sample shows how to use hardware with 802.15.4 radio and USB
controller as a "serial-radio" device for Contiki-based border routers.

Requirements
************

The sample assumes that 802.15.4 radio and USB controller are supported on
a board. You can pick, for example, a transceiver such as a CC2520 or RF2xx
using overlays, or by using an SoC with a built-in radio, such as a kw41z,
nrf5, or samr21.

Building and Running
********************

#. Before building and running this sample, be sure your Linux system's
   ModemManager is disabled, otherwise, it can interfere with serial
   port communication:

   .. code-block:: console

     $ sudo systemctl disable ModemManager.service

#. Build the sample Zephyr application to a board with a 802.15.4 radio
   and USB controller. There are configuration files for various setups
   in the ``samples/net/wpan_serial`` directory:

   - :file:`prj.conf`
     This is the standard default config. This can be used by itself for
     hardware which has native 802.15.4 support.

   To build the wpan_serial sample:

   .. zephyr-app-commands::
     :zephyr-app: samples/net/wpan_serial
     :board: <board name>
     :conf: "prj.conf [overlay-<RADIO>.conf]"
     :goals: build
     :compact:

   Here's how to build and flash the sample for the Atmel SAM R21
   Xplained Pro Development Kit.

   .. zephyr-app-commands::
     :zephyr-app: samples/net/wpan_serial
     :board: atsamr21_xpro
     :goals: build flash
     :compact:

#. Connect board to Linux PC, /dev/ttyACM[number] should appear.
#. Run Contiki-based native border router (6lbr, native-router, etc)
   Example for Contiki:

   .. code-block:: console

     $ cd examples/ipv6/native-border-router
     $ make
     $ sudo ./border-router.native -v5 -s ttyACM0 fd01::1/64

Now you have a Contiki native board router.  You can access its web-based
interface with your browser using the server address printed in the
border-router output.

.. code-block:: console

  ...
  Server IPv6 addresses:
   0x62c5c0: =>fd01::212:4b00:531f:113a
  ...

Use your browser to access ``http://[fd01::212:4b00:531f:113a]/`` and you'll
see available neighbors and routes.