Difference between revisions of "CEC internal peripheral"

[quality revision] [quality revision]
m (Software frameworks)
 

1 Article purpose[edit]

The purpose of this article is to:

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

2 Peripheral overview[edit]

The CEC (consumer electronics control) or HDMI-CEC is an STM32 internal peripheral that allows to receive/send messages from/to devices, such as TV or tuner, through a HDMI cable.

2.1 Features[edit]

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

Refer to the STM32 CEC presentation [1] for an overview of the CEC hardware block capabilities.

2.2 Security support[edit]

The CEC is a non-secure peripheral.

3 Peripheral usage and associated software[edit]

3.1 Boot time[edit]

The CEC is not used at boot time.

3.2 Runtime[edit]

3.2.1 Overview[edit]

The CEC internal peripheral can be allocated to:

  • the Arm® Cortex®-A7 non-secure core to be controlled in Linux® by the CEC framework

or

Chapter Peripheral assignment describes which peripheral instance can be assigned to which context.

3.2.2 Software frameworks[edit]

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

(STM32Cube)
Low-speed interface CEC
CEC framework CEC HAL 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 or for Linux® in the CEC 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)
Visual CEC CEC Assignment (single choice)

4 How to go further[edit]

Refer to the STM32 CEC application note (AN4066) [2] for a detailed description of the CEC peripheral and applicable use-cases.

Even if this application note is related to STM32 microcontrollers, it also applies to STM32 MPUs.

5 References[edit]



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

==Peripheral overview==
The CEC (consumer electronics control) or HDMI-CEC is an STM32 internal peripheral that allows to receive/send messages from/to devices, such as TV or tuner, through a HDMI cable.

===Features===
Refer to the [[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.

Refer to the STM32 CEC presentation <ref>[http://www.st.com/content/ccc/resource/training/technical/product_training/group0/d7/44/1d/13/6d/78/42/17/STM32F7_Peripheral_HDMI_CEC/files/STM32F7_Peripheral_HDMI_CEC.pdf/jcr:content/translations/en.STM32F7_Peripheral_HDMI_CEC.pdf STM32 CEC presentation]</ref> for an overview of the CEC hardware block capabilities.

===Security support===
The CEC is a '''non-secure''' peripheral.

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

===Runtime===
====Overview====
The CEC internal peripheral 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 [[CEC_overview|CEC framework]]
or
* the Arm<sup>&reg;</sup> Cortex<sup>&reg;</sup>-M4 to be controlled in STM32Cube MPU Package by [[STM32CubeMP1 architecture|STM32Cube CEC driver]]

Chapter [[#Peripheral assignment|Peripheral assignment]] describes which peripheral instance can be assigned to which context.

====Software frameworks====
{{:Internal_peripherals_software_table_template}}
 | rowspan="9" | Low-speed interface
 | rowspan="9" | [[CEC_internal_peripheral|CEC]] |-|
 | [[CEC_overview|CEC framework]]
 | [[STM32CubeMP1 architecture|CEC HAL 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 or for Linux<sup>&reg;</sup> in the [[CEC device tree configuration]] article.

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

 | rowspan="1" | Visual
 | rowspan="1" | [[CEC internal peripheral|CEC]]
 | CEC
 | 
 | <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==
Refer to the STM32 CEC application note (AN4066) <ref>[https://www.st.com/resource/en/application_note/dm00050136.pdf STM32 CEC Application Note (AN4066)]</ref> for a detailed description of the CEC peripheral and applicable use-cases.

Even if this application note is related to STM32 microcontrollers, it also applies to STM32 MPUs.

==References==<references/>

<noinclude>

{{ArticleBasedOnModel | Internal peripheral article model}}
{{PublicationRequestId | 9173 | 2018-10-10 | AnneJ}}
[[Category:Visual peripherals]]</noinclude>
Line 32: Line 32:
 
====Software frameworks====
 
====Software frameworks====
 
{{:Internal_peripherals_software_table_template}}
 
{{:Internal_peripherals_software_table_template}}
  | rowspan="9" | Low-speed interface
+
  | Low-speed interface
  | rowspan="9" | [[CEC_internal_peripheral|CEC]]
+
  | [[CEC_internal_peripheral|CEC]]
|-
+
  |
|
 
 
  | [[CEC_overview|CEC framework]]
 
  | [[CEC_overview|CEC framework]]
 
  | [[STM32CubeMP1 architecture|CEC HAL driver]]
 
  | [[STM32CubeMP1 architecture|CEC HAL driver]]

Attachments

Discussions