NXP Semiconductors i.MX8M Series User manual

i.MX8M Safety Example
NXP Semiconductors Document identifier: IEC60730BIMX8MXEUG
User's Guide Rev. 3, 07/2021

Contents
Chapter 1 IEC60730B Safety library example user's guide...................................3
Chapter 2 Hardware settings................................................................................. 4
Chapter 3 File structure......................................................................................... 7
Chapter 4 Example application.............................................................................. 9
Chapter 5 Running example................................................................................ 14
Chapter 6 IEC60730B tests................................................................................. 22
Chapter 7 Revision history...................................................................................25
NXP Semiconductors
i.MX8M Safety Example , Rev. 3, 07/2021
User's Guide 2 / 26

Chapter 1
IEC60730B Safety library example user's guide
For easier development of the IEC60730B application, the library also provides the example code. This example is distributed
through the MCUXpresso SDK website. This example user's guide describes how to set the hardware correctly and how to use
the example code with the IEC60730B Safety library.
The library user's guide is the main documentation for IEC60730B. It is also part of this package and you can download it at
www.nxp.com/IEC60730.
NXP Semiconductors
i.MX8M Safety Example , Rev. 3, 07/2021
User's Guide 3 / 26

Chapter 2
Hardware settings
This chapter describes how to set up the hardware of the evaulation board. The MCU peripherals' setup is described later on.
The IEC60730B library example for the I.MX8mx family supports the following development boards:
• EVKmimx8mm
• EVKmimx8mn
To run the IEC60730B example application, it is neccessary to make some hardware settings. For the default configuration of your
development board, see the corresponding board's user manual at www.nxp.com.
2.1 EVK-MIMX8MM (Mini)
The hardware requirements are as follows:
• i.MX8M Mini development board (EVK-MIMX8MM)
• J-Link debug probe
• USB-C cable (12-V power supply)
• USB-C cable (download to ROM memory)
• Micro USB cable (debug print)
Debugger:
The default debugger in the example project is set to J-Link.
FreeMASTER
FreeMASTER communication is used via an external J-Link plugin.
The hardware settings are as follows:
1. Connect the 12-V power supply (J302 USB port) and the J-Link debug probe to the board and switch the SW101 switch to
power on the board.
2. Connect a USB-C cable between the host PC and the J301 USB port (this port allows downloading to the ROM memory).
3. If a debug print is needed, connect a micro USB cable between the host PC and the J901 USB port on the target board.
Then open the serial terminal with the following settings:
• 115200 baud rate
• 8 data bits
• No parity
• One stop bit
• No flow control
4. Set the SW1101 switch to value "01110010" and SW1102 to value "00101010" to boot from the eMMC.
See www.nxp.com/imx8mminievk for more information.
NXP Semiconductors
i.MX8M Safety Example , Rev. 3, 07/2021
User's Guide 4 / 26

Figure 1. Hardware connection of EVK-MIMX8MM
2.2 EVK-MIMX8MN (Nano)
The hardware requirements are as follows:
• i.MX8M Nano development board (EVK-MIMX8MN)
• J-Link debug probe
• USB-C cable (12-V power supply)
• USB-C cable (download to ROM memory)
• Micro USB cable (debug print)
Debugger:
The default debugger in the example project is set to J-Link.
FreeMASTER
FreeMASTER communication is used via an external J-Link plugin.
The hardware settings are as follows:
1. Connect the 12-V power supply (J302 USB port) and the J-Link debug probe to the board and switch the SW101 switch to
power on the board.
2. Connect a USB-C cable between the host PC and the J301 USB port (this port allows downloading to the ROM memory).
3. If a debug print is needed, connect a micro USB cable between the host PC and the J901 USB port on the target board.
Then open a serial terminal with the following settings:
• 115200 baud rate
• 8 data bits
• No parity
• One stop bit
• No flow control
4. Set switch SW1101 to "0100" to boot from the eMMC.
See www.nxp.com/ imx8mnanoevk for more information.
EVK-MIMX8MN (Nano)
i.MX8M Safety Example , Rev. 3, 07/2021
NXP Semiconductors 5

Figure 2. Hardware connection of EVK-MIMX8MN
EVK-MIMX8MN (Nano)
i.MX8M Safety Example , Rev. 3, 07/2021
NXP Semiconductors 6

Chapter 3
File structure
Safety is only a small part of the whole SDK package for your device. The IEC60730 library and examples are located in the
middleware and in the board folders. The IEC60730 library is independent of the SDK and can be used stand-alone.
3.1 Library source files location
The library source files are in the middleware/safety_iec60730b/safety/v4_2 folder in the SDK package.
The folder has the following structure:
Figure 3. Folder structure
Where:
• The
common_test folder contains the source files for the peripheral test – this is a common cross core. These tests are
compiled to library libIEC60730B_<core>_COM_<compiler>_<version>.a .
• The compiler folder contains compiler support files.
• The
core_test folder contains the source files for the core-dependent test. These tests are compiled to library
libIEC60730B_<core>_<compiler>_<version>.a .
• iec60730b.h is the main library header file.
•
iec60730b_types.h is the header file with the necessary defines for the library.
The folder also contains binary *.lib files, which are compiled for the IAR, Keil, and MCUXpresso IDEs (see the release notes
for details).
NXP Semiconductors
i.MX8M Safety Example , Rev. 3, 07/2021
User's Guide 7 / 26

3.2 Example of library handling code
The library-handling code and the example aplication are separate from the library file. The example source files and other SDK
examples are at this path:
boards/<your board>/demo_apps/safety_iec60730b/
The safety example code is shown in Figure 4.
Figure 4. Example of project structure in example folder
This folder contains the example source file and three folders for the IDE project file:
•
iar
• mcux
• mdk
The following files are generated by the MCUXpresso configuration tool:
• clock_config.h
• clock_config.c
• pin_mux.c
• pin_mux.h
Other files are used only for safety examples and their contents are described in the next chapter.
Example of library handling code
i.MX8M Safety Example , Rev. 3, 07/2021
NXP Semiconductors 8

Chapter 4
Example application
The structure of the example is common in all supported IDEs (IAR, Keil, MCUXpresso).
Figure 5. IAR example application structure
The project contains the CMSIS, SDK, library, and safety example-related folders.
The safety-related folders are the following:
•
Board – this folder contains the files related to the board used ( clock_config.h , pin_config.h , board.h , and so on).
• CPU – this folder contains the startup code and vectors table.
•
IEC60730_Class_B – files for the IEC60730B Safety library.
NXP Semiconductors
i.MX8M Safety Example , Rev. 3, 07/2021
User's Guide 9 / 26

• Source – source file for the safety example (see the next explanation).
The example of project hiearchy is shown in Figure 6.
Figure 6. Example of project hiearchy
Figure 6 shows that the functions in the project_setup.c file are called from the main.c file. The library-handling functions are
located in the file and also called from the main.c file.
The main example application header file safety_config.h contains all definitions for running the safety test in examples. The
safety_test_items.c file declares the structures for the DIO (or TSI) safety test. The project_setup_<your_board>.c file contains
the setup functions (clock, port, UART, and so on). The file contains the handling function for safety routines from the IEC60730B
library and also the test-initialization function for safety.
4.1 How to open the project
IAR IDE
Open the project file located at
boards/<your_board>/demo_apps/safety_iec60730b/iar/safety_iec60730b.eww .
Arm Keil IDE
Open the project file located at boards/<your_board>/demo_apps/safety_iec60730b/mdk/safety_iec60730b.uvprojx .
MCUXpresso IDE
Firstly, drag and drop the <name_of_the_package>.zip package into the MCUXpresso IDE (into the "Installed SDKs" tab).
Secondly, import the SDK example (safety_iec60730b).
How to open the project
i.MX8M Safety Example , Rev. 3, 07/2021
NXP Semiconductors 10