zephyr

History

Martí Bolívar 5992afae4f samples: can: devicetree cleanups Replace DT_CHOSEN_ZEPHYR_CAN_PRIMARY_LABEL with DEVICE_DT_GET on the chosen node itself. This is causing a build error in CI for the waveshare_open103z board because it disables CAN by default in favor of USB. Throw in an overlay reversing that decision for the sake of this sample to keep things building. (Though the build previously succeeded, the device_get_binding() call would simply have failed.) Replace the LED access with GPIO_DT_SPEC_GET_OR. This changes the semantics slightly so that the simulated LED implemented via printk() is run if either the node is missing or the pin cannot be configured, instead of just running when the node is missing. An unready LED port when the node is defined still returns early from main. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>		2021-05-05 20:46:43 +02:00
..
boards	samples: can: devicetree cleanups	2021-05-05 20:46:43 +02:00
src	samples: can: devicetree cleanups	2021-05-05 20:46:43 +02:00
CMakeLists.txt	samples: make find_package(Zephyr...) REQUIRED	2020-05-29 10:47:25 +02:00
Kconfig
prj.conf	samples: can: shell send fix	2021-03-17 11:25:50 +01:00
README.rst
sample.yaml

README.rst

.. _can-sample:

Controller Area Network
#######################

Overview
********

This sample demonstrates how to use the Controller Area Network (CAN) API.
Messages with standard and extended identifiers are sent over the bus.
Messages are received using message-queues and work-queues.
Reception is indicated by blinking the LED (if present) and output to the console.

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

In loopback mode, the board receives its own messages. This could be used for
standalone testing.

The LED output pin is defined in the board's devicetree.

The sample can be built and executed for boards with a SoC that have an
integrated CAN controller or for boards with a SoC that has been augmented
with a stand alone CAN controller.

Integrated CAN controller
=========================

For the NXP TWR-KE18F board:

.. zephyr-app-commands::
   :zephyr-app: samples/drivers/CAN
   :board: twr_ke18f
   :goals: build flash

Stand alone CAN controller
==========================

For the nrf52dk_nrf52832 board combined with the DFRobot CAN bus V2.0 shield that
provides the MCP2515 CAN controller:

.. zephyr-app-commands::
   :zephyr-app: samples/drivers/CAN
   :board: nrf52dk_nrf52832
   :shield: dfrobot_can_bus_v2_0
   :conf: prj.mcp2515.conf
   :goals: build flash

Sample output
=============

.. code-block:: console

   Change LED filter ID: 0
   Finished init.
   Counter filter id: 4

   uart:~$ Counter received: 0
   Counter received: 1
   Counter received: 2
   Counter received: 3

.. note:: The values shown above might differ.