Skip to main content

山景G1-NVM

以下是将 PMU 模块驱动接口函数整理成的表格,包含函数名、参数、返回值、@brief 和 @note 信息:

函数名参数返回值@brief@note
PMU_WriteEnable使能 PMU 寄存器写访问调用后允许写 PMU 相关寄存器
PMU_WriteDisable关闭 PMU 寄存器写访问调用后禁止写 PMU 相关寄存器
PMU_SystemPowerDown触发系统进入掉电状态执行后系统进入低功耗掉电
PMU_AutoPowerOnEnable在电源就绪时,启用被动关机状态的自动上电适用于待机被动关机的自动唤醒
PMU_AutoPowerOnDisable在电源就绪时,关闭被动关机状态的自动上电禁止待机被动关机的自动唤醒
PMU_IsAutoPowerOnEnabledtrue:启用;false:禁用检查自动上电模式的设置状态返回当前自动上电配置
PMU_NVMInit首次上电时清理 NVM 存储区需在调用 PMU_NvmReadPMU_NvmWrite 之前执行
PMU_NvmReadNvmoffset:偏移范围 0~4
Buf:用于存放 NVM 数据的内存地址
Length:数据长度,需满足 Nvmoffset + Length <= 5
true:读取成功;false:读取失败(参数错误或未先调用 PMU_NVMInit读取 NVM 数据
PMU_NvmWriteNvmoffset:偏移范围 0~4
Buf:读取数据的内存地址
Length:数据长度,需满足 Nvmoffset + Length <= 5
true:写入成功;false:写入失败(参数错误或未先调用 PMU_NVMInit写入 NVM 数据
PMU_PowerupEventGetCHARGE_OUT_EVENT:充电拔出
CHARGE_IN_EVENT:充电插入
POWERKEY_EVENT:有效电源键事件
获取上电事件标志
PMU_PowerupEventClr清除上电事件标志复位事件标志位
PMU_PowerkeySarADCEn使能电源键到 SARADC 的通路,电源键可作为 ADC 键打开后可通过 ADC 采样电源键
PMU_PowerkeySarADCDis禁用电源键到 SARADC 的通路关闭后无法通过 ADC 采样电源键
PMU_PowerkeySarADCEnGettrue:已启用;false:未启用检查电源键到 SARADC 的通路是否已启用
PMU_PowerkeyPullup102K设置电源键通过 102K 电阻上拉
PMU_PowerkeyPullup22K设置电源键通过 22K 电阻上拉
PMU_PowerkeyPullupOhmGetSEL_102K:102K 上拉;SEL_22K:22K 上拉获取电源键上拉类型
PMU_PowerKeyStateClear清除电源键按下触发状态标志
PMU_PowerKeyShortPressStateClear清除电源键短按触发状态标志
PMU_PowerKeyLongPressStateClear清除电源键长按触发状态标志
PMU_PowerKeyModeSetPowerKeyModeHARD_MODE(硬开关)或 SOFT_MODE(软开关)设置电源键切换模式
PMU_PowerKeyModeGetHARD_MODESOFT_MODE获取电源键切换模式
PMU_PowerKeyHardModeSetHardTriggerMode:0 - LEVEL_TRIGGER(电平触发);1 - EDGE_TRIGGER(边沿触发)设置硬开关模式下的电源键触发类型
PMU_PowerKeyHardModeGetLEVEL_TRIGGEREDGE_TRIGGER获取硬开关模式下的电源键触发类型设置
PMU_PowerKeyActiveLevelSetPowerkeyActiveLevelLOW_INDICATE_POWERON(低电平表示开机)或 HIGH_INDICATE_POWERON(高电平表示开机)设置电源键有效电平
PMU_PowerKeyActiveLevelGetLOW_INDICATE_POWERONHIGH_INDICATE_POWERON获取电源键有效电平设置
PMU_PowerKeyLongOrShortPressSetmode_setPOWERKEY_LONG_PRESS_MODE(长按触发启动)或 POWERKEY_SHORT_PRESS_MODE(短按触发启动)设置掉电状态下电源键的启动触发类型
PMU_PowerKeyLongOrShortPressGetPOWERKEY_LONG_PRESS_MODEPOWERKEY_SHORT_PRESS_MODE获取电源键启动触发类型设置
PMU_PowerKeyTrigStateGettrue:触发标志已置位;false:触发标志未置位获取电源键触发状态标志表示电源键按下已持续达到短按时间
PMU_PowerKeyShortPressTrigStateGettrue:短按标志已置位;false:短按标志未置位获取电源键短按状态标志表示按下时间超过短按时间但小于长按时间
PMU_PowerKeyLongPressTrigStateGettrue:长按标志已置位;false:长按标志未置位获取电源键长按状态标志表示在软开关模式下按下时间已达到长按时间
PMU_PowerKeyPinStateGet1:高电平;0:低电平获取当前电源键引脚电平状态
PMU_PowerKeyEnable使能电源键模块
PMU_PowerKeyDisable禁用电源键模块
PMU_IsPowerKeyEnabledtrue:已使能;false:未使能获取电源键使能状态
PMU_PowerKeyShortPressTrigMaxCntSetcnt:1~63,单位:8ms设置电源键短按时间1) 短按时间 = cnt8ms + 噪声过滤4ms
2) cnt 不应为 0
PMU_PowerKeyShortPressTrigMaxCntGet设置的计数值获取电源键短按时间设置值
PMU_PowerKeyLongPressTrigMaxCntSetcnt:1~63,单位:64ms设置电源键长按时间长按时间 = cnt64ms + 噪声过滤4ms
PMU_PowerKeyLongPressTrigMaxCntGet设置的计数值获取电源键长按时间设置值应保证:长按时间 > 短按时间
PMU_PowerKeyResetTrigMaxCntSetcnt:0~15,单位:1.024s设置电源键长按复位时间长按复位时间 = cnt1.024s + 噪声过滤4ms
PMU_PowerKeyResetTrigMaxCntGet设置的计数值获取电源键长按复位时间设置值
PMU_PowerKeyNoiseFilterMaxCntSetcnt:0~63,单位:4ms设置电源键噪声过滤时间
PMU_PowerKeyNoiseFilterMaxCntGet设置的计数值获取电源键噪声过滤时间设置值
PMU_PowerLongResetModeSetPowerLongResetModeRST_MODE_TIMEOUT_KEYUP - 当按键时间超过设定时,复位在松开按键后释放;LONGR_RST_MODE_TIMEOUT - 当按键时间达到设定时立即释放复位,不考虑松开时间设置电源键长按复位模式
PMU_PowerLongResetModeGetRST_MODE_TIMEOUT_KEYUPLONGR_RST_MODE_TIMEOUT获取电源键长按复位模式设置
PMU_FristPowerOnFlagGettrue:首次上电;false:非首次上电获取布尔值以判断是否为 PMU 首次上电需在调用 PMU_PowerKeyEnable() 之前调用
PMU_ResRegOneBitSetBitMask:寄存器位掩码 [bit0 ~ bit7]将保留寄存器中指定位设置为 1bit0、bit1 由系统使用
PMU_ResRegOneBitClearBitMask:寄存器位掩码 [bit0 ~ bit7]将保留寄存器中指定位清零为 0bit0、bit1 由系统使用
PMU_ResRegGet寄存器值读取保留寄存器的当前值
PMU_PowerSleepInit初始化低功耗睡眠(PowerSleep)低功耗睡眠期间保持 RAM 与 PC 指针
PMU_PowerSleepKeyInit设置电源键唤醒
PMU_PowerSleepRTCSetTimer_Num:0 ~ 0xFFFFFF,RTC 唤醒时间 = Timer_Num * 32us(单位:us)设置 RTC 唤醒时间
PMU_PowerSleepGPIOA0A1SetGPIO_SET:A0 / A1设置 GPIOA0/A1 唤醒
PMU_PowerSleepGPIOA0A1ClearGPIO_SET:A0 / A1清除 GPIOA0/A1 的低功耗睡眠状态
PMU_PowerSleepTrigSetTrig_able:位定义——bit5: rw_osc_en;bit4: 保留;bit3: 低功耗定时器;bit2: 电源键;bit1~bit0: GPIO-A1、GPIO-A0设置唤醒触发源
PMU_PowerSleepStart启动低功耗睡眠
PMU_PowerSleepTrigFlagGet位定义——bit5: rw_osc_en;bit4: 保留;bit3: 低功耗定时器;bit2: 电源键;bit1~bit0: GPIO-A1、GPIO-A0获取低功耗睡眠触发状态标志
PMU_PowerSleepTrigClr清除低功耗睡眠触发状态标志
PMU_FristPowerSleepWakeupSet设置首次低功耗睡眠唤醒标志