asrCP_MMI_APIs_User_Manual_20181206_V9.5.pdf

【核心代码】

A Table of Contents
A Table of Contents ........................................................................................................................... 2
1 OS ................................................................................................................................................... 12
1.1 Introduction .................................................................................................................................................... 12
1.2 Header file ..................................................................................................................................................... 12
1.3 Structures ...................................................................................................................................................... 12
1.4 APIs ............................................................................................................................................................... 13
1.4.1 OSATaskCreate .............................................................................................................................. 13
1.4.2 OSATaskCreateEx .......................................................................................................................... 13
1.4.3 OSATaskDelete ............................................................................................................................... 14
1.4.4 OSATaskSuspend ........................................................................................................................... 14
1.4.5 OSATaskResume ............................................................................................................................ 14
1.4.6 OSATaskSleep ................................................................................................................................ 14
1.4.7 OSATaskGetCurrentRef .................................................................................................................. 15
1.4.8 OSATaskTerminate ......................................................................................................................... 15
1.4.9 OS_Create_HISR ............................................................................................................................ 15
1.4.10 OS_Activate_HISR .......................................................................................................................... 15
1.4.11 OS_Delete_HISR ............................................................................................................................ 16
1.4.12 OSAMsgQCreate ............................................................................................................................ 16
1.4.13 OSAMsgQDelete ............................................................................................................................. 17
1.4.14 OSAMsgQSend ............................................................................................................................... 17
1.4.15 OSAMsgQRecv ............................................................................................................................... 17
1.4.16 OSAMsgQPoll ................................................................................................................................. 18
1.4.17 OSAMailboxQCreate ....................................................................................................................... 18
1.4.18 OSAMailboxQDelete ....................................................................................................................... 18
1.4.19 OSAMailboxQSend ......................................................................................................................... 18
1.4.20 OSAMailboxQRecv ......................................................................................................................... 19
1.4.21 OSASemaphoreCreate.................................................................................................................... 19
1.4.22 OSASemaphoreDelete .................................................................................................................... 19
1.4.23 OSASemaphoreAcquire .................................................................................................................. 19
1.4.24 OSASemaphoreRelease ................................................................................................................. 20
1.4.25 OSASemaphorePoll ........................................................................................................................ 20
1.4.26 OSAMutexCreate ............................................................................................................................ 20
1.4.27 OSAMutexDelete ............................................................................................................................. 20
1.4.28 OSAMutexLock ............................................................................................................................... 21
1.4.29 OSAMutexUnlock ............................................................................................................................ 21
1.4.30 OSAFlagCreate ............................................................................................................................... 21
1.4.31 OSAFlagDelete ............................................................................................................................... 21
1.4.32 OSAFlagSet .................................................................................................................................... 22
1.4.33 OSAFlagWait ................................................................................................................................... 22
1.4.34 OSAListAllCreatedTasks ................................................................................................................. 22
1.4.35 OSAListAllCreatedTimers ................................................................................................................ 22
1.4.36 OSAListAllCreatedEventFlags ......................................................................................................... 23
1.4.37 OSAListAllCreatedMemBlockPools ................................................................................................. 23
1.4.38 OSAListAllCreatedMemBytesPoolsStatus....................................................................................... 23
1.4.39 OSAListAllCreatedMsgQs ............................................................................................................... 23
1.4.40 OSAListAllCreatedSemaphores ...................................................................................................... 24
1.4.41 OSAContextLock ............................................................................................................................. 24
1.4.42 OSAContextUnLock ........................................................................................................................ 24
1.4.43 OSAContextLockExt ........................................................................................................................ 24
1.4.44 OSAContextUnLockExt ................................................................................................................... 24
1.4.45 OSAGetCurrentThreadRef .............................................................................................................. 25
ASR Confidential
Microsoft Page 3
1.4.46 OSAGetTaskInfo ............................................................................................................................. 25
1.4.47 OSAGetCreatedThreadCount ......................................................................................................... 25
1.4.48 OSAGetMaxThreadCount ............................................................................................................... 25
1.4.49 OSAGetThreadListHead.................................................................................................................. 26
1.4.50 OSAThreadList ................................................................................................................................ 26
1.4.51 OSAGetVersion ............................................................................................................................... 26
2 FileSystem ..................................................................................................................................... 27
2.1 Introduction .................................................................................................................................................... 27
2.2 Header file ..................................................................................................................................................... 27
2.3 Structures ...................................................................................................................................................... 27
2.4 APIs ............................................................................................................................................................... 27
2.4.1 XXX_IsFormatted ............................................................................................................................ 27
2.4.2 FAT_Format .................................................................................................................................... 28
2.4.3 XXX_fopen ...................................................................................................................................... 28
2.4.4 XXX_fclose ...................................................................................................................................... 28
2.4.5 XXX_remove ................................................................................................................................... 29
2.4.6 XXX_fread ....................................................................................................................................... 29
2.4.7 XXX_fwrite ....................................................................................................................................... 29
2.4.8 XXX_fseek ....................................................................................................................................... 29
2.4.9 XXX_rename ................................................................................................................................... 30
2.4.10 XXX_findfirst .................................................................................................................................... 30
2.4.11 XXX_findnext ................................................................................................................................... 30
2.4.12 XXX_findfileclose ............................................................................................................................ 31
2.4.13 XXX_GetFileSize ............................................................................................................................. 31
2.4.14 XXX_eof .......................................................................................................................................... 31
2.4.15 Erase flash ...................................................................................................................................... 31
2.4.16 FDI_factory_reset ............................................................................................................................ 32
2.4.17 FAT_GetFsInfo/FDI_GetFreeSpaceSize/FDI_GetUsedSpaceSize ................................................. 32
2.4.18 FDI_ferror ........................................................................................................................................ 32
2.4.19 XXX_SetCurrentDir ......................................................................................................................... 33
2.4.20 XXX_GetCurrentDir ......................................................................................................................... 33
2.4.21 XXX_MakeDir .................................................................................................................................. 33
2.4.22 XXX_RemoveDir ............................................................................................................................. 33
2.4.23 Set File Attributes ............................................................................................................................ 34
2.4.24 Get File Attributes ............................................................................................................................ 34
2.4.25 Get Device Info ................................................................................................................................ 34
2.4.26 Mount Root ...................................................................................................................................... 34
2.4.27 Mount Device .................................................................................................................................. 34
2.4.28 Un-mount Device ............................................................................................................................. 34
2.4.29 Scan Device .................................................................................................................................... 34
2.4.30 Change File Size ............................................................................................................................. 34
2.4.31 Write Back ....................................................................................................................................... 34
2.4.32 Get Size of a Directory .................................................................................................................... 34
2.4.33 Get File Name ................................................................................................................................. 34
2.4.34 Turn On Power ................................................................................................................................ 35
2.4.35 Turn Off Power ................................................................................................................................ 35
3 Memory Management ................................................................................................................... 36
3.1 Introduction .................................................................................................................................................... 36
3.2 Header file ..................................................................................................................................................... 36
3.3 Structures ...................................................................................................................................................... 36
3.4 APIs ............................................................................................................................................................... 36
3.4.1 malloc .............................................................................................................................................. 36
3.4.2 free .................................................................................................................................................. 36
3.4.3 OSAMemPoolCreate ....................................................................................................................... 37
3.4.4 OSAMemPoolCreateExt .................................................................................................................. 37
ASR Confidential
Microsoft Page 4
3.4.5 OSAMemPoolAlloc .......................................................................................................................... 37
3.4.6 OSAMemPoolFree .......................................................................................................................... 38
3.4.7 OSAGetDefaultMemPoolFreeSize .................................................................................................. 38
3.4.8 OSAGetMemPoolFreeSize .............................................................................................................. 38
4 Cache ............................................................................................................................................. 39
4.1 Introduction .................................................................................................................................................... 39
4.2 Header file ..................................................................................................................................................... 39
4.3 Structures ...................................................................................................................................................... 39
4.4 APIs ............................................................................................................................................................... 39
4.4.1 CacheCleanMemory ........................................................................................................................ 39
4.4.2 CacheInvalidateMemory .................................................................................................................. 39
5 Timer .............................................................................................................................................. 40
5.1 Introduction .................................................................................................................................................... 40
5.2 Header file ..................................................................................................................................................... 40
5.3 Structures ...................................................................................................................................................... 40
5.4 APIs ............................................................................................................................................................... 40
5.4.1 OSATimerCreate ............................................................................................................................. 40
5.4.2 OSATimerStart ................................................................................................................................ 40
5.4.3 OSATimerStop ................................................................................................................................ 41
5.4.4 OSATimerDelete ............................................................................................................................. 41
5.4.5 timerCountRead .............................................................................................................................. 41
6 PMU ................................................................................................................................................ 42
6.1 Introduction .................................................................................................................................................... 42
6.2 Header file ..................................................................................................................................................... 42
6.3 Structures ...................................................................................................................................................... 42
6.4 APIs ............................................................................................................................................................... 42
6.4.1 uiC1CallbackRegister ...................................................................................................................... 42
6.4.2 uiC1CallbackunRegister .................................................................................................................. 43
6.4.3 uiD2CallbackRegister ...................................................................................................................... 43
6.4.4 uiD2CallbackunRegister .................................................................................................................. 43
6.4.5 uiSetSuspendFlag ........................................................................................................................... 43
6.5 FSM ............................................................................................................................................................... 44
7 UART .............................................................................................................................................. 46
7.1 Introduction .................................................................................................................................................... 46
7.2 Header file ..................................................................................................................................................... 46
7.3 Structures ...................................................................................................................................................... 46
7.4 APIs ............................................................................................................................................................... 46
7.4.1 uart_printf / fatal_printf..................................................................................................................... 46
8 DIAG ............................................................................................................................................... 48
8.1 Introduction .................................................................................................................................................... 48
8.2 Header file ..................................................................................................................................................... 48
8.3 Structures ...................................................................................................................................................... 48
8.4 APIs ............................................................................................................................................................... 48
8.4.1 diagTextPrintf .................................................................................................................................. 48
8.4.2 diagPrintf ......................................................................................................................................... 49
8.4.3 diagStructPrintf ................................................................................................................................ 50
8.4.4 ACAT Command ............................................................................................................................. 51
ASR Confidential
Microsoft Page 5
9 Silent Reset ................................................................................................................................... 53
9.1 Introduction .................................................................................................................................................... 53
9.2 Header file ..................................................................................................................................................... 53
9.3 Structures ...................................................................................................................................................... 53
9.4 APIs ............................................................................................................................................................... 53
9.4.1 Startupmode_get ............................................................................................................................. 53
9.4.2 Is_silentReset .................................................................................................................................. 54
9.5 How to Enable Silent Reset ........................................................................................................................... 54
10 GPIO ............................................................................................................................................... 57
10.1 Introduction .................................................................................................................................................... 57
10.2 Header file ..................................................................................................................................................... 57
10.3 Structures ...................................................................................................................................................... 57
10.4 APIs ............................................................................................................................................................... 57
10.4.1 GpioPhase1Init ................................................................................................................................ 57
10.4.2 GpioInitConfiguration ....................................................................................................................... 58
10.4.3 GpioSetDirection ............................................................................................................................. 58
10.4.4 GpioSetLevel ................................................................................................................................... 58
10.4.5 GpioGetLevel .................................................................................................................................. 58
11 PINMUX .......................................................................................................................................... 59
12 I2C .................................................................................................................................................. 60
13 PMIC812 Voltage ........................................................................................................................... 61
13.1 Introduction .................................................................................................................................................... 61
13.2 Header file ..................................................................................................................................................... 61
13.3 Structures ...................................................................................................................................................... 61
13.4 APIs ............................................................................................................................................................... 61
13.4.1 PM812_Ldo_5_set .......................................................................................................................... 61
13.4.2 PM812_Ldo_5_set_3_1 .................................................................................................................. 61
13.4.3 PM812_Ldo_6_set .......................................................................................................................... 62
13.4.4 PM812_Ldo_6_set_2_8 .................................................................................................................. 62
13.4.5 PM812_Ldo_8_set .......................................................................................................................... 62
13.4.6 PM812_Ldo_8_set_2_8 .................................................................................................................. 62
13.4.7 PM812_Ldo_9_set .......................................................................................................................... 63
13.4.8 PM812_Ldo_9_set_1_8 .................................................................................................................. 63
13.4.9 PM812_Ldo_11_set ........................................................................................................................ 63
13.4.10 PM812_Ldo_11_set_2_8 ................................................................................................................ 63
13.4.11 PM812_Ldo_12_set ........................................................................................................................ 64
13.4.12 PM812_Ldo_12_set_2_8 ................................................................................................................ 64
13.4.13 PM812_Ldo_13_set ........................................................................................................................ 64
13.4.14 PM812_Ldo_13_set_2_8 ................................................................................................................ 64
13.4.15 PM812_Ldo_15_set ........................................................................................................................ 65
13.4.16 PM812_Ldo_15_set_2_8 ................................................................................................................ 65
13.4.17 PM812_Ldo_16_set ........................................................................................................................ 65
13.4.18 PM812_Ldo_16_set_2_8 ................................................................................................................ 65
13.4.19 PM812_Ldo_17_set ........................................................................................................................ 66
13.4.20 PM812_Ldo_17_set_2_8 ................................................................................................................ 66
13.4.21 PM812_Ldo_18_set ........................................................................................................................ 66
13.4.22 PM812_Ldo_18_set_1_8 ................................................................................................................ 66
13.4.23 PM812_VBUCK1_CFG ................................................................................................................... 67
13.4.24 PM812_VBUCK2_CFG ................................................................................................................... 67
13.4.25 PM812_PwmSetLevel ..................................................................................................................... 67
13.4.26 PM812_GET_POWER_UP_REASON ............................................................................................ 67
ASR Confidential
Microsoft Page 6
13.4.27 PM812_GET_POWER_DOWN_REASON ...................................................................................... 68
13.4.28 PM812_SW_PDOWN...................................................................................................................... 69
13.4.29 PM812_SW_RESET ....................................................................................................................... 69
14 PMIC813 (NINGBO) ....................................................................................................................... 70
14.1 Introduction .................................................................................................................................................... 70
14.2 Header file ..................................................................................................................................................... 70
14.3 APIs ............................................................................................................................................................... 70
14.3.1 Ningbo_INT_DISABLE .................................................................................................................... 70
14.3.2 Ningbo_INT_ENABLE ..................................................................................................................... 70
14.3.3 Ningbo_INT_CALLBACK_REGISTER ............................................................................................ 70
14.3.4 Ningbo_ENABLE_BATID_MEAS .................................................................................................... 71
14.3.5 Ningbo_DISABLE_BATID_MEAS ................................................................................................... 71
14.3.6 Ningbo_ENABLE_BATTEMP_MEAS .............................................................................................. 71
14.3.7 Ningbo_DISABLE_BATTEMP_MEAS ............................................................................................. 71
14.3.8 NingboLcdBackLightEnable ............................................................................................................ 72
14.3.9 NingboLcdBackLightDisable ............................................................................................................ 72
14.3.10 NingboLcdBackLightCtrl .................................................................................................................. 72
14.3.11 NingboVibratorEnable ..................................................................................................................... 72
14.3.12 NingboVibratorDisable..................................................................................................................... 73
14.3.13 NingboVibratorCtrl ........................................................................................................................... 73
14.3.14 NingboTorchLightEnable ................................................................................................................. 73
14.3.15 NingboTorchLightDisable ................................................................................................................ 73
14.3.16 NingboTorchBackLightCtrl ............................................................................................................... 74
14.3.17 NingboKeypadBackLightEnable ...................................................................................................... 74
14.3.18 NingboKeypadBackLightDisable ..................................................................................................... 74
14.3.19 Ningbo_SoftwareNotProceedUntilReach3400 ................................................................................. 74
14.3.20 pm813_get_battemp_meas_vol_mv ............................................................................................... 75
14.3.21 pm813_get_batid_meas_vol_mv ..................................................................................................... 75
14.3.22 pm813_get_Vcharge_meas_vol_mv ............................................................................................... 75
14.3.23 pm813_get_bat_vol ......................................................................................................................... 75
14.3.24 pm813_get_bat_slp_vol .................................................................................................................. 76
14.3.25 pm813_get_battery_status .............................................................................................................. 76
14.3.26 pm813_get_charger_status ............................................................................................................. 76
14.3.27 pm813_charger_switch ................................................................................................................... 76
14.3.28 pm813_if_charge_full ...................................................................................................................... 77
14.3.29 pm813_precharge_current_set ....................................................................................................... 77
14.3.30 pm813_charge_termination_current_set ......................................................................................... 77
14.3.31 pm813_cc_current_set .................................................................................................................... 77
14.3.32 pm813_vbat_set .............................................................................................................................. 78
14.3.33 pm813_precharge_timer_set ........................................................................................................... 78
14.3.34 pm813_trickle_timer_set ................................................................................................................. 78
14.3.35 pm813_current_check_timer_set .................................................................................................... 79
14.3.36 pm813_voltage_check_timer_set .................................................................................................... 79
14.3.37 pm813_cccv_timer_set.................................................................................................................... 79
14.3.38 pm813_charger_is_usb ................................................................................................................... 79
14.3.39 pm813_charger_timer_switch ......................................................................................................... 80
14.3.40 pm813_fault_clear ........................................................................................................................... 80
14.3.41 pm813_get_charger_FSM_state ..................................................................................................... 80
14.3.42 pm813_get_battery_voltage_withoutCharger .................................................................................. 80
14.3.43 pm813_set_max_cc_current ........................................................................................................... 81
14.3.44 pmic_user_defined_flags_set .......................................................................................................... 81
14.3.45 pmic_user_defined_flags_get .......................................................................................................... 81
15 PMIC812 BATTERY ....................................................................................................................... 82
15.1 Introduction .................................................................................................................................................... 82
15.2 Header file ..................................................................................................................................................... 82
15.3 Structures ...................................................................................................................................................... 82
ASR Confidential
Microsoft Page 7
15.4 APIs ............................................................................................................................................................... 82
15.4.1 PM812_BATTERY_BIND_INTC ...................................................................................................... 82
15.4.2 PM812_BATTERY_INTC_ENABLE ................................................................................................ 82
15.4.3 PM812_BATTERY_GET_VBAT_MEAS_VOL_MV ......................................................................... 83
15.4.4 PM812_ENABLE_BAT_DET ........................................................................................................... 83
15.4.5 PM812_BATTERY_TID_MEAS_ENABLE....................................................................................... 83
15.4.6 PM812_BATTERY_TID_MEAS ....................................................................................................... 83
16 PMIC812 CHARGER ..................................................................................................................... 84
16.1 Introduction .................................................................................................................................................... 84
16.2 Header file ..................................................................................................................................................... 84
16.3 Structures ...................................................................................................................................................... 84
16.4 APIs ............................................................................................................................................................... 84
16.4.1 PM812_CHARGER_BIND_INTC .................................................................................................... 84
16.4.2 PM812_CHARGER_INTC_ENABLE ............................................................................................... 84
16.4.3 PM812_VBUS_IS_AVAILABLE ....................................................................................................... 85
16.4.4 PM812_CHARGER_IS_DETECTED .............................................................................................. 85
16.4.5 PM812_CHARGER_STATUS ......................................................................................................... 85
16.4.6 PM812_CHARGER_GET_VCHG_MEAS_VOL_MV ....................................................................... 85
16.4.7 PM812_SET_VCHG_LOW_TH_VOL_MV ...................................................................................... 86
16.4.8 PM812_GET_VCHG_LOW_TH_VOL_MV ...................................................................................... 86
16.4.9 PM812_SET_VCHG_UPP_TH_VOL_MV ....................................................................................... 86
16.4.10 PM812_GET_VCHG_UPP_TH_VOL_MV ....................................................................................... 86
16.4.11 USB_WAKEUP_CALLBACK_REGISTER ....................................................................................... 87
16.4.12 getUSBConnectStatus..................................................................................................................... 87
17 RTC ................................................................................................................................................ 88
17.1 Introduction .................................................................................................................................................... 88
17.2 Header file ..................................................................................................................................................... 88
17.3 Structures ...................................................................................................................................................... 88
17.4 APIs ............................................................................................................................................................... 88
17.4.1 PMIC_RTC_Init ............................................................................................................................... 88
17.4.2 PMIC_RTC_EnableAlarm................................................................................................................ 89
17.4.3 PMIC_RTC_IS_ALARM_POWERUP .............................................................................................. 89
17.4.4 PMIC_RTC_SetAlarm ..................................................................................................................... 89
17.4.5 PMIC_RTC_GetAlarm ..................................................................................................................... 89
17.4.6 PMIC_RTC_GetTime ...................................................................................................................... 89
17.4.7 PMIC_RTC_SetTime ....................................................................................................................... 90
17.4.8 PMIC_RTC_IS_PEER_SYNCED .................................................................................................... 90
17.4.9 FSM ................................................................................................................................................. 90
18 Watchdog ...................................................................................................................................... 92
18.1 Introduction .................................................................................................................................................... 92
18.2 Header file ..................................................................................................................................................... 92
18.3 Structures ...................................................................................................................................................... 92
18.4 Inner-chip Watchdog APIs ............................................................................................................................. 93
18.4.1 watchdogDeactivate ........................................................................................................................ 93
18.5 PMIC watchdog APIs ..................................................................................................................................... 93
18.5.1 PMIC_WD_TIMER_SET ................................................................................................................. 93
18.5.2 PMIC_WD_KICK ............................................................................................................................. 93
18.5.3 PMIC_WD_ENABLE ....................................................................................................................... 93
19 DMA ................................................................................................................................................ 95
19.1 Introduction .................................................................................................................................................... 95
ASR Confidential
Microsoft Page 8
19.2 Header file ..................................................................................................................................................... 95
19.3 Structures ...................................................................................................................................................... 95
19.4 APIs ............................................................................................................................................................... 95
19.4.1 dma_irq_callback_register ............................................................................................................... 95
19.4.2 dma_map_device_to_channel ......................................................................................................... 95
19.4.3 set_user_aligment ........................................................................................................................... 96
19.4.4 dma_set_mode ................................................................................................................................ 96
19.4.5 dma_set_reg_nf .............................................................................................................................. 96
19.4.6 dma_xfer_start ................................................................................................................................ 96
19.4.7 dma_xfer_stop ................................................................................................................................. 97
20 AT Command ................................................................................................................................ 98
20.1 Introduction .................................................................................................................................................... 98
20.2 Header file ..................................................................................................................................................... 98
20.3 Structures ...................................................................................................................................................... 98
20.4 APIs ............................................................................................................................................................... 98
20.4.1 ATRecv............................................................................................................................................ 98
20.4.2 ATRESP .......................................................................................................................................... 99
20.4.3 MATSetConfIndCB .......................................................................................................................... 99
20.4.4 MATHandleIndication ...................................................................................................................... 99
20.4.5 MATHandleResponse ................................................................................................................... 100
20.4.6 MATConfIndFree ........................................................................................................................... 100
20.5 AT Command Related Structure Introduction .............................................................................................. 100
20.5.1 User-defined AT Command Format .............................................................................................. 100
20.5.2 AT CommandType ........................................................................................................................ 100
20.5.3 AT Command Request type .......................................................................................................... 100
20.5.4 AT CommandOperation Type ........................................................................................................ 101
20.5.5 AT CommandStructure .................................................................................................................. 101
20.5.6 AT CommandParameters .............................................................................................................. 102
20.5.7 CI Group Service ........................................................................................................................... 102
20.6 AT Response Related Structure Introduction .............................................................................................. 103
20.6.1 MATReturnPara Structure ............................................................................................................. 103
20.6.2 MATParameter Structure............................................................................................................... 103
20.6.3 Sample .......................................................................................................................................... 103
20.7 Implement New AT Command ..................................................................................................................... 104
Step1 AT Command List for MMI ............................................................................................................. 104
Step2 Define AT Commands ................................................................................................................... 105
Step3 Implement AT Command Handler Function .................................................................................. 105
Step4 Implement CI Confirm Handler Function ....................................................................................... 105
Step5 How to Process AT Response ....................................................................................................... 105
Step6 Sample Code ................................................................................................................................. 105
21 Keypad ......................................................................................................................................... 106
21.1 Introduction .................................................................................................................................................. 106
21.2 Header file ................................................................................................................................................... 106
21.3 Structures .................................................................................................................................................... 106
21.4 APIs ............................................................................................................................................................. 106
21.4.1 ValKeypadInit ................................................................................................................................ 106
21.4.2 ValKeypadRegister ........................................................................................................................ 107
21.4.3 ValKeypadMultikeyEn ................................................................................................................... 107
22 PMIC812 ONKEY ......................................................................................................................... 108
22.1 Introductio .................................................................................................................................................... 108
22.2 Header file ................................................................................................................................................... 108
ASR Confidential
Microsoft Page 9
22.3 Structures .................................................................................................................................................... 108
22.4 APIs ............................................................................................................................................................. 108
22.4.1 PM812_ONKEY_BIND_INTC ........................................................................................................ 108
22.4.2 PM812_ONKEY_INTC_ENABLE .................................................................................................. 108
22.4.3 PM812_GET_ONKEY_STATUS ................................................................................................... 109
22.4.4 PM812_LONKEY_PRESS_TIME_SET ......................................................................................... 109
22.4.5 PM812_LONKEY_EN ................................................................................................................... 109
23 Production Mode ........................................................................................................................ 110
23.1 Introduction .................................................................................................................................................. 110
23.2 Header file ................................................................................................................................................... 110
23.3 APIs ............................................................................................................................................................. 110
23.3.1 isSysRestartByRdProduction ........................................................................................................ 110
23.3.2 InProduction_Mode ....................................................................................................................... 110
24 SDcard Driver .............................................................................................................................. 111
25 Bluetooth ..................................................................................................................................... 112
26 PWM ............................................................................................................................................. 113
27 SSP ............................................................................................................................................... 114
28 Clock ............................................................................................................................................ 115
29 CPU MIPS Measurement ............................................................................................................ 116
29.1 Introduction .................................................................................................................................................. 116
29.2 Procedure .................................................................................................................................................... 116
30 HTTP CLIENT .............................................................................................................................. 118
30.1 Introduction .................................................................................................................................................. 118
30.2 Header file ................................................................................................................................................... 118
30.3 Structures .................................................................................................................................................... 118
30.4 APIs ............................................................................................................................................................. 118
30.4.1 http_init ( ) ..................................................................................................................................... 118
30.4.2 http_client_setopt( ) ....................................................................................................................... 118
30.4.3 http_client_list_append( ) .............................................................................................................. 119
30.4.4 http_client_list_destroy()................................................................................................................ 120
30.4.5 http_client_perform() ..................................................................................................................... 120
30.4.6 http_client_get_info() ..................................................................................................................... 120
30.4.7 http_client_shutdown() .................................................................................................................. 120
30.4.8 Usage Example ............................................................................................................................. 120
31 LCD .............................................................................................................................................. 122
31.1 Introduction .................................................................................................................................................. 122
31.2 Header file ................................................................................................................................................... 122
31.3 Structures .................................................................................................................................................... 122
31.4 APIs ............................................................................................................................................................. 122
31.4.1 mci_LcdSetFBInfo ......................................................................................................................... 122
31.4.2 mci_LcdSetFBBitdepth .................................................................................................................. 122
31.4.3 mci_LcdInit .................................................................................................................................... 123
31.4.4 mci_LcdGetPanelInfo .................................................................................................................... 123
31.4.5 mci_LcdBlockWrite_sync............................................................................................................... 123
31.4.6 mci_LcdBlockWrite ........................................................................................................................ 123
ASR Confidential
Microsoft Page 10
31.4.7 mci_LcdScreenOn ......................................................................................................................... 124
31.4.8 mci_LcdSetBrightness ................................................................................................................... 124
31.4.9 mci_LcdGetDimension .................................................................................................................. 124
31.4.10 mci_Logo_LcdInit .......................................................................................................................... 124
31.4.11 mci_Logo_LcdBlockWrite_sync ..................................................................................................... 124
31.4.12 Usage ............................................................................................................................................ 125
32 MMI UI Boot-up ........................................................................................................................... 126
32.1 Introduction .................................................................................................................................................. 126
32.2 Header file ................................................................................................................................................... 126
32.3 Structures .................................................................................................................................................... 126
32.4 APIs ............................................................................................................................................................. 126
32.4.1 ui_init_phase1 ............................................................................................................................... 126
32.4.1 ui_init_phase2 ............................................................................................................................... 126
33 Multimedia ................................................................................................................................... 127
34 Security ........................................................................................................................................ 128
34.1 Introduction .................................................................................................................................................. 128
34.2 Header file ................................................................................................................................................... 129
34.3 Structures .................................................................................................................................................... 129
34.4 APIs ............................................................................................................................................................. 129
34.4.1 aes_encrypt/aes_decrypt .............................................................................................................. 129
34.4.2 geu_random_number .................................................................................................................... 131
34.4.3 pseudo_random_number .............................................................................................................. 131
35 Others .......................................................................................................................................... 132
35.1 Introduction .................................................................................................................................................. 132
35.2 Header file ................................................................................................................................................... 132
35.3 Structures .................................................................................................................................................... 132
35.4 APIs ............................................................................................................................................................. 132
35.4.1 ASSERT ........................................................................................................................................ 132
35.4.2 Disable/Restore Interrupt............................................................................................................... 132
35.4.3 INTCBind ....................................................................................................................................... 133
35.4.4 INTCGetIntVirtualNum................................................................................................................... 133
35.4.5 Delay without Preemption.............................................................................................................. 133
35.4.6 Read_Crane_CPU_UID ................................................................................................................ 133
35.4.7 Read_Crane_Flash_UID ............................................................................................................... 134
36 AnnexA -Multimedia ................................................................................................................... 135
36.1 Introduction .................................................................................................................................................. 135
36.2 Header file ................................................................................................................................................... 135
36.3 Structures .................................................................................................................................................... 135
36.4 APIs ............................................................................................................................................................. 135
36.4.1 AudioMediaPlayer ......................................................................................................................... 135
36.4.2 VideoMediaPlayer ......................................................................................................................... 137
36.4.3 AudioMediaRecorder ..................................................................................................................... 140
36.4.4 VideoMediaRecorder ..................................................................................................................... 141
36.4.5 Camera.......................................................................................................................................... 143