Difference between revisions of "FDCAN internal peripheral"

[quality revision] [quality revision]
m
 
m
 


Template:ArticleMainWriter Template:ArticleApprovedVersion


1 Article purpose[edit]

The purpose of this article is to:

  • briefly introduce the FDCAN peripheral and its main features
  • indicate the level of security supported by this hardware block
  • explain how each instance can be allocated to the two runtime contexts and linked to the corresponding software components
  • explain, when necessary, how to configure the FDCAN peripheral.

2 Peripheral overview[edit]

FDCAN peripheral handles data communication in a Controller Area Network (CAN) bus system using message-based protocol originally designed for in-vehicle communication. The CAN subsystem consists of two CAN modules (FDCAN1 and FDCAN2), a shared message RAM and an optional clock calibration unit.

2.1 Features[edit]

Both FDCAN instances are compliant with classic CAN protocol[1] and CAN FD[2] (CAN with Flexible Data-Rate) protocol. In addition, FDCAN1 supports time triggered CAN (TTCAN).

FDCAN1 and FDCAN2 share a dedicated 10 Kbyte CAN SRAM for message transfers.

Refer to STM32MP15 reference manuals for the complete list of features, and to the software components, introduced below, to see which features are implemented.

2.2 Security support[edit]

FDCAN is a non secure peripheral.

3 Peripheral usage and associated software[edit]

3.1 Boot time[edit]

The FDCAN is not used at boot time.

3.2 Runtime[edit]

3.2.1 Overview[edit]

FDCAN instances can be allocated to:

or

3.2.2 Software frameworks[edit]

Domain Peripheral Software frameworks Comment
Cortex-A7
secure
(OP-TEE)
Cortex-A7
non-secure
(Linux)
Cortex-M4

(STM32Cube)
Networking FDCAN Linux net/can framework STM32Cube FDCAN driver

3.2.3 Peripheral configuration[edit]

The configuration is applied by the firmware running in the context to which the peripheral is assigned. The configuration can be done alone via the STM32CubeMX tool for all internal peripherals, and then manually completed (particularly for external peripherals) according to the information given in the corresponding software framework article. When the FDCAN peripheral is assigned to the Linux® Template:Sup OS, it is configured through the device tree according to the information given in the FDCAN device tree configuration article.

3.2.4 Peripheral assignment[edit]

Internal peripherals

Check boxes illustrate the possible peripheral allocations supported by STM32 MPU Embedded Software:

  • means that the peripheral can be assigned () to the given runtime context.
  • is used for system peripherals that cannot be unchecked because they are statically connected in the device.

Refer to How to assign an internal peripheral to a runtime context for more information on how to assign peripherals manually or via STM32CubeMX.
The present chapter describes STMicroelectronics recommendations or choice of implementation. Additional possiblities might be described in STM32MP15 reference manuals.

Domain Peripheral Runtime allocation Comment
Instance Cortex-A7
secure
(OP-TEE)
Cortex-A7
non-secure
(Linux)
Cortex-M4

(STM32Cube)
Networking FDCAN FDCAN1 Assignment (single choice)
FDCAN2 Assignment (single choice)

4 How to go further[edit]

Info.png Use this paragraph to add more information and introduce other documentation such as Application Notes (AN)

5 References[edit]

  1. CAN protocol implementations, from the CAN in Automation group (CiA)
  2. CAN FD - The basic idea, from the CAN in Automation group (CiA)
<noinclude>

{{ArticleBasedOnModel | [[Internal peripheral article model]]}}
{{ArticleMainWriter | BichH}}
{{ ArticleApprovedVersion|BichH| AlexandreT(PASSED 27Nov'18) |No previous approved version| BrunoB- 04Dec'18 - 9882 | 04dec'18 }}  
[[Category:Networking peripherals]]</noinclude>

==Article purpose==
The purpose of this article is to:
* briefly introduce the FDCAN peripheral and its main features
* indicate the level of security supported by this hardware block
* explain how each instance can be allocated to the two runtime contexts and linked to the corresponding software components
* explain, when necessary, how to configure the FDCAN peripheral.

==Peripheral overview==
'''FDCAN''' peripheral handles data communication in a Controller Area Network (CAN) bus system using message-based protocol originally designed for in-vehicle communication.
The CAN subsystem consists of two CAN modules (FDCAN1 and FDCAN2), a shared message RAM and an optional clock calibration unit.<br />


===Features===
Both FDCAN instances are compliant with classic CAN protocol<ref>[https://www.can-cia.org/can-knowledge/can/can-implementations/ CAN protocol implementations], from the CAN in Automation group (CiA)</ref> and CAN FD<ref>[https://www.can-cia.org/can-knowledge/can/can-fd/ CAN FD - The basic idea], from the CAN in Automation group (CiA)</ref> (CAN with Flexible Data-Rate) protocol.
In addition, FDCAN1 supports time triggered CAN (TTCAN).<br />


FDCAN1 and FDCAN2 share a dedicated 10 Kbyte CAN SRAM for message transfers.<br />


Refer to [[STM32MP15 resources#Reference manuals|STM32MP15 reference manuals]] for the complete list of features, and to the software components, introduced below, to see which features are implemented.<br>


===Security support===
FDCAN is a '''non secure''' peripheral.

==Peripheral usage and associated software==
===Boot time===
The FDCAN is not used at boot time.

===Runtime===
====Overview====
FDCAN instances can be allocated to:
* the Arm{{sup|&reg;</sup>}} Cortex{{sup|&reg;</sup>}}-A7 non-secure core to be controlled in Linux{{sup|&reg;</sup>}} by the NetDev framework (See [[CAN overview]])
or
* the Arm{{sup|&reg;</sup>}} Cortex{{sup|&reg;</sup>}}-M4 to be controlled in STM32Cube MPU Package by [[STM32CubeMP1 architecture|STM32Cube FDCAN driver]]

====Software frameworks====
{{:Internal_peripherals_software_table_template}}
 | Networking
 | [[FDCAN internal peripheral|FDCAN]]
 | 
 | Linux net/can framework
 | [[STM32CubeMP1 architecture|STM32Cube FDCAN driver]]
 |
 |-
 |}

====Peripheral configuration====
The configuration is applied by the firmware running in the context to which the peripheral is assigned. The configuration can be done alone via the [[STM32CubeMX]] tool for all internal peripherals, and then manually completed (particularly for external peripherals) according to the information given in the corresponding software framework article.
When the FDCAN peripheral is assigned to the Linux{{sup|&reg;</sup>}} OS, it is configured through the device tree according to the information given in the [[FDCAN device tree configuration]] article.

====Peripheral assignment====
{{:Internal_peripherals_assignment_table_template}}<onlyinclude>

 | rowspan="2" | Networking
 | rowspan="2" | [[FDCAN internal peripheral|FDCAN]]
 | FDCAN1
 | 
 | <span title="assignable peripheral" style="font-size:21px"></span>

 | <span title="assignable peripheral" style="font-size:21px"></span>

 | Assignment (single choice)
 |-
 | FDCAN2
 | 
 | <span title="assignable peripheral" style="font-size:21px"></span>

 | <span title="assignable peripheral" style="font-size:21px"></span>

 | Assignment (single choice)
 |-</onlyinclude>

 |}

==How to go further==
{{Info| Use this paragraph to add more information and introduce other documentation such as Application Notes (AN)}}

==References==<references/>

<noinclude>

{{ArticleBasedOnModel | Internal peripheral article model}}
{{PublicationRequestId | 9882 | 2018-12-04 | BrunoB}}
[[Category:Networking peripherals]]</noinclude>
Line 1: Line 1:
<noinclude>
 
{{ArticleBasedOnModel | [[Internal peripheral article model]]}}
 
{{ArticleMainWriter | BichH}}
 
{{ ArticleApprovedVersion|BichH| AlexandreT(PASSED 27Nov'18) |No previous approved version| BrunoB- 04Dec'18 - 9882 | 04dec'18 }} 
 
[[Category:Networking peripherals]]
 
</noinclude>
 
 
 
==Article purpose==
 
==Article purpose==
 
The purpose of this article is to:
 
The purpose of this article is to:
Line 35: Line 28:
 
====Overview====
 
====Overview====
 
FDCAN instances can be allocated to:
 
FDCAN instances can be allocated to:
* the Arm{{sup|&reg;}} Cortex{{sup|&reg;}}-A7 non-secure core to be controlled in Linux{{sup|&reg;}} by the NetDev framework (See [[CAN overview]])
+
* the Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-A7 non-secure core to be controlled in Linux<sup>&reg;</sup> by the NetDev framework (See [[CAN overview]])
 
or
 
or
* the Arm{{sup|&reg;}} Cortex{{sup|&reg;}}-M4 to be controlled in STM32Cube MPU Package by [[STM32CubeMP1 architecture|STM32Cube FDCAN driver]]
+
* the Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-M4 to be controlled in STM32Cube MPU Package by [[STM32CubeMP1 architecture|STM32Cube FDCAN driver]]
   
 
====Software frameworks====
 
====Software frameworks====
Line 52: Line 45:
 
====Peripheral configuration====
 
====Peripheral configuration====
 
The configuration is applied by the firmware running in the context to which the peripheral is assigned. The configuration can be done alone via the [[STM32CubeMX]] tool for all internal peripherals, and then manually completed (particularly for external peripherals) according to the information given in the corresponding software framework article.
 
The configuration is applied by the firmware running in the context to which the peripheral is assigned. The configuration can be done alone via the [[STM32CubeMX]] tool for all internal peripherals, and then manually completed (particularly for external peripherals) according to the information given in the corresponding software framework article.
When the FDCAN peripheral is assigned to the Linux{{sup|&reg;}} OS, it is configured through the device tree according to the information given in the [[FDCAN device tree configuration]] article.
+
When the FDCAN peripheral is assigned to the Linux<sup>&reg;</sup> OS, it is configured through the device tree according to the information given in the [[FDCAN device tree configuration]] article.
   
 
====Peripheral assignment====
 
====Peripheral assignment====
Line 79: Line 72:
 
==References==
 
==References==
 
<references/>
 
<references/>
  +
  +
<noinclude>
  +
{{ArticleBasedOnModel | Internal peripheral article model}}
  +
{{PublicationRequestId | 9882 | 2018-12-04 | BrunoB}}
  +
[[Category:Networking peripherals]]
  +
</noinclude>