docs/arm/sabrelite: Mention FlexCAN support
Also added example command line usage of the Sabrelite board with FlexCAN controllers. Signed-off-by: Matyáš Bobek <matyas.bobek@gmail.com> Signed-off-by: Pavel Pisa <pisa@fel.cvut.cz> Tested-by: Pavel Pisa <pisa@fel.cvut.cz> Reviewed-by: Bernhard Beschow <shentey@gmail.com> Reviewed-by: Pavel Pisa <pisa@fel.cvut.cz> Message-id: 19407fc30bdf6b264d1c093a82903609e9cfee48.1782140438.git.matyas.bobek@gmail.com Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Matyáš Bobek committed
Jun 22, 2026 at 18:08 UTC
e2929b3bc92025f32fa7e8c97b614b6262bc1420
2 files changed
+25
docs/system/arm/sabrelite.rst
+1
@@ -24,6 +24,7 @@ The SABRE Lite machine supports the following devices:
24
* 4 SDHC storage controllers
25
* 4 USB 2.0 host controllers
26
* 5 ECSPI controllers
27
+ * 2 FlexCAN CAN controllers
28
* 1 SST 25VF016B flash
29
30
Please note above list is a complete superset the QEMU SABRE Lite machine can
docs/system/devices/can.rst
+24
@@ -173,6 +173,30 @@ The test can also be run the other way around, generating messages in the
173
guest system and capturing them in the host system. Other combinations are
174
also possible.
175
176
+Examples on how to use CAN emulation for FlexCAN on SabreLite board
177
+-------------------------------------------------------------------
178
+FlexCANs are connected to QEMU CAN buses by passing the bus IDs as machine
179
+properties:
180
+
181
+* property ``canbus0`` for connecting ``flexcan1``
182
+* property ``canbus1`` for connecting ``flexcan2``
183
+
184
+Note that upstream Linux SabreLite DTs have only a single FlexCAN (``flexcan1``)
185
+enabled.
186
+
187
+An example command to run QEMU emulating a Sabrelite development board
188
+with both FlexCANs connected to a single QEMU CAN bus (called ``qcan0``),
189
+bridged to host system ``can0`` interface::
190
+
191
+ qemu-system-arm -M sabrelite -smp 4 -m 1G \
192
+ -object can-bus,id=qcan0 \
193
+ -machine canbus0=qcan0 -machine canbus1=qcan0 \
194
+ -object can-host-socketcan,if=can0,canbus=qcan0,id=qcan0-socketcan \
195
+ -kernel ... -dtb ... -initrd ...
196
+
197
+Note that in the Linux guest, bitrate for the FlexCAN device is ignored,
198
+but needs to be set via the ``ip`` command.
199
+
200
Links to other resources
201
------------------------
202