1# Common Events of the Power Management Subsystem 2This document lists the common system events provided by the power management subsystem to applications. Applications can use [APIs](../js-apis-commonEventManager.md) to subscribe to common system events. 3 4## COMMON_EVENT_BATTERY_CHANGED 5Indicates that the charging state, level, and other information about the battery have changed. 6 7- Value: usual.event.BATTERY_CHANGED 8- Required subscriber permissions: none 9 10When any of the following information changes, the event notification service is triggered to publish this event: battery level, battery voltage, battery temperature, battery health status, type of the charger connected to the device, maximum current of the charger, maximum voltage of the charger, battery charging status, number of charging times, total battery capacity, remaining battery capacity, battery model, current of the battery, and battery charging type. 11 12## COMMON_EVENT_BATTERY_LOW 13Indicates that the battery level is low. 14 15- Value: usual.event.BATTERY_LOW 16- Required subscriber permissions: none 17 18When the battery level drops to lower than the low battery level set for the device, the event notification service is triggered to publish this event. For details about how to set the low battery level, see [Battery Level Customization](../../../../device-dev/subsystems/subsys-power-battery-level-customization.md). 19 20## COMMON_EVENT_BATTERY_OKAY 21Indicates that the battery level is normal. 22 23- Value: usual.event.BATTERY_OKAY 24- Required subscriber permissions: none 25 26When the battery level changes from the low level to normal level, the event notification service is triggered to publish this event. 27 28## COMMON_EVENT_POWER_CONNECTED 29Indicates that the device is connected to an external power supply. 30 31- Value: usual.event.POWER_CONNECTED 32- Required subscriber permissions: none 33 34When the device connects to an external charger, the event notification service is triggered to publish this event. 35 36## COMMON_EVENT_POWER_DISCONNECTED 37Indicates that the device is disconnected from the external power supply. 38 39- Value: usual.event.POWER_DISCONNECTED 40- Required subscriber permissions: none 41 42When the device is disconnected from the external power supply, the event notification service is triggered to publish this event. 43 44## COMMON_EVENT_DISCHARGING 45Indicates that the system stops charging the battery. 46 47- Value: usual.event.DISCHARGING 48- Required subscriber permissions: none 49 50When the system stops charging the battery, the event notification service is triggered to publish this event. 51 52## COMMON_EVENT_CHARGING 53Indicates that the system starts charging the battery. 54 55- Value: usual.event.CHARGING 56- Required subscriber permissions: none 57 58When the system starts charging the battery, the event notification service is triggered to publish this event. 59 60## COMMON_EVENT_CHARGE_TYPE_CHANGED 61Indicates that the system charging type has changed. This event is available only for system applications. 62- Value: usual.event.CHARGE_TYPE_CHANGED 63 64- Required subscriber permissions: none 65 66When the system charging type changes, the event notification service is triggered to publish this event. 67 68## COMMON_EVENT_CHARGE_IDLE_MODE_CHANGED 69Indicates that the device enters the charging idle mode. 70 71- Value: usual.event.CHARGE_IDLE_MODE_CHANGED 72- Required subscriber permissions: none 73 74When the device starts charging in idle mode, and the temperature rise is acceptable, the event notification service is triggered to publish this event. 75 76## COMMON_EVENT_SHUTDOWN 77Indicates that the device is being and will be shut down. 78 79- Value: usual.event.SHUTDOWN 80- Required subscriber permissions: none 81 82When the device is being shut down until it is powered off, the event notification service is triggered to publish this event. 83 84## COMMON_EVENT_SCREEN_OFF 85Indicates that the device screen is off and the device is in sleep mode. 86 87- Value: usual.event.SCREEN_OFF 88- Required subscriber permissions: none 89 90When the device screen is turned off and the device is in sleep mode, the event notification service is triggered to publish this event. 91 92## COMMON_EVENT_SCREEN_ON 93Indicates that the device screen is on and the device is in the active state. 94 95- Value: usual.event.SCREEN_ON 96- Required subscriber permissions: none 97 98When the device screen is turned on and in the active state, the event notification service is triggered to publish this event. 99 100## COMMON_EVENT_POWER_SAVE_MODE_CHANGED 101Indicates that the system power saving mode has changed. 102 103- Value: usual.event.POWER_SAVE_MODE_CHANGED 104- Required subscriber permissions: none 105 106When the system power saving mode changes, the event notification service is triggered to publish this event. 107 108## COMMON_EVENT_THERMAL_LEVEL_CHANGED 109Indicates that the device's thermal level has changed. 110 111- Value: usual.event.THERMAL_LEVEL_CHANGED 112- Required subscriber permissions: none 113 114When the device's thermal level changes, the event notification service is triggered to publish this event. For details about how to configure the thermal level, see [Thermal Level Customization](../../../../device-dev/subsystems/subsys-thermal_level.md). 115