3.3. POK Safety Example

3.3.1. Introduction

This example demonstrates the usage of the POK modules. The example shows how to listen for POK error events using the ESM, and also forcing an error in order to demonstrate application notification of overvoltage and undervoltage events.

The example demonstrates:

  • Undervoltage event detection

  • Overvoltage event detection

3.3.2. Use Cases

Use Case

Description

ESM

UC-1

An under-voltage POK instance is configured to a threshold value that will force the undervoltage event. Error event is triggered and application is notified of the event.

WKUP_ESM0

UC-2

An over-voltage POK instance is configured to a threshold value that will force the overvoltage event. Error event is triggered and application is notified of the event.

WKUP_ESM0

3.3.3. Example Details

The example should be loaded to the hardware using the Secondary Boot Loader (SBL) from the SDK.

Example Name

Location

Build Command

pok_app

[sdl_install_dir]/examples/pok/

make pok_app PROFILE=release

3.3.4. Expected Output

POK Test Application

sdlEsmSetupForPOK init: Init WKUP ESM complete


 Below are the POK ID values
  SDL_POK_VDDA_PMIC_IN_ID is:       0
  SDL_POK_VDD_CORE_UV_ID is:        1
  SDL_POK_VDDSHV_WKUP_GEN_UV_ID is: 2
  SDL_POK_VDD_CPU_UV_ID is:         3
  SDL_POK_VDDR_MCU_UV_ID is:        4
  SDL_POK_VMON_EXT_UV_ID is:        5
  SDL_POK_VDD_MCU_OV_ID is:         6
  SDL_POK_VDDR_CORE_UV_ID is:       7
  SDL_POK_VDDSHV_WKUP_GEN_OV_ID is: 8
  SDL_POK_VDD_CORE_OV_ID is:        9
  SDL_POK_VDDR_MCU_OV_ID is:        10
  SDL_POK_VDD_CPU_OV_ID is:         11
  SDL_POK_VDDR_CORE_OV_ID is:       12
  SDL_POK_VMON_EXT_OV_ID is:        13



 POK ID = 1 , monitoring set to UV
Waiting for ESM to report the error

  ESM Call back function called : instType 0x1, intType 0x1, grpChannel 0x2, index 0x13, intSrc 0x53
  Take action
 Got the ESM Error Interrupt
Action taken
Safety software Example UC-1 pok for instance 1 PASSED


 Below are the POK In POR ID values for the example
  SDL_POR_POKHV_UV_ID is:           14
  SDL_POR_POKLV_UV_ID is:           15
  SDL_POR_POKHV_OV_ID is:           16


 POK ID = 16 , monitoring set to OV

  ESM Call back function called : instType 0x1, intType 0x1, grpChannel 0x2, index 0x7, intSrc 0x47
  Take action
Waiting for ESM to report the error
 Got the ESM Error Interrupt
Action taken
Safety software Example UC-2 pok for instance  16 PASSED
Test Name: POK EXAMPLE UC-1  PASSED
Test Name: POR EXAMPLE UC-2  PASSED

 All tests have passed.

3.3.5. Reference

POK User Guide