nRF51822库函数速查

nrf_soc.h

 

//初始化互斥锁

uint32_t sd_mutex_new(nrf_mutex_t * p_mutex);

 

//尝试获取互斥锁.

uint32_t sd_mutex_acquire(nrf_mutex_t * p_mutex);

 

//释放互斥锁.

uint32_t sd_mutex_release(nrf_mutex_t * p_mutex);

 

//使能外部中断.

uint32_t sd_nvic_EnableIRQ(IRQn_Type IRQn);

 

//禁止外部中断.

uint32_t sd_nvic_DisableIRQ(IRQn_Type IRQn);

 

// Get Pending Interrupt.

uint32_t sd_nvic_GetPendingIRQ(IRQn_Type IRQn, uint32_t * p_pending_irq);

 

// Set Pending Interrupt.

uint32_t sd_nvic_SetPendingIRQ(IRQn_Type IRQn);

 

// Clear Pending Interrupt.

uint32_t sd_nvic_ClearPendingIRQ(IRQn_Type IRQn);

 

//设置中断优先级.

uint32_t sd_nvic_SetPriority(IRQn_Type IRQn, nrf_app_irq_priority_t priority);

 

//取得中断优先级.

uint32_t sd_nvic_GetPriority(IRQn_Type IRQn, nrf_app_irq_priority_t * p_priority);

 

//系统复位.

uint32_t sd_nvic_SystemReset(void);

 

//进入临界区.

uint32_t sd_nvic_critical_region_enter(uint8_t * p_is_nested_critical_region);

 

//退出临界区.

uint32_t sd_nvic_critical_region_exit(uint8_t is_nested_critical_region);

 

// 查询应用的随机数池容量.

uint32_t sd_rand_application_pool_capacity_get(uint8_t * p_pool_capacity);

 

//取得应用中有效地随机数字节数.

uint32_t sd_rand_application_bytes_available_get(uint8_t * p_bytes_available);

 

//从池中获取随机数字节.

uint32_t sd_rand_application_vector_get(uint8_t * p_buff, uint8_t length);

 

//取得复位原因寄存器的值.

uint32_t sd_power_reset_reason_get(uint32_t * p_reset_reason);

 

//清除复位原因寄存器的若干bit.

uint32_t sd_power_reset_reason_clr(uint32_t reset_reason_clr_msk);

 

//设置CPU睡眠时的电源模式.

uint32_t sd_power_mode_set(nrf_power_mode_t power_mode);

 

//关闭系统.

uint32_t sd_power_system_off(void);

 

//开关电源失效比较器

uint32_t sd_power_pof_enable(uint8_t pof_enable);

 

//设置电源故障阈值.

uint32_t sd_power_pof_threshold_set(nrf_power_failure_threshold_t threshold);

 

//设置NRF_POWER->RAMON寄存器.

uint32_t sd_power_ramon_set(uint32_t ramon);

 

//清除NRF_POWER->RAMON寄存器.

uint32_t sd_power_ramon_clr(uint32_t ramon);

 

// Get contents of NRF_POWER->RAMON register, indicates power status of ram blocks.

uint32_t sd_power_ramon_get(uint32_t * p_ramon);

 

//Set bits in the NRF_POWER->GPREGRET register.

uint32_t sd_power_gpregret_set(uint32_t gpregret_msk);

 

//Clear bits in the NRF_POWER->GPREGRET register.

uint32_t sd_power_gpregret_clr(uint32_t gpregret_msk);

 

//Get contents of the NRF_POWER->GPREGRET register.

uint32_t sd_power_gpregret_get(uint32_t *p_gpregret);

 

//设置DCDC模式.

uint32_t sd_power_dcdc_mode_set(nrf_power_dcdc_mode_t dcdc_mode);

 

//请求使用高频晶体振荡器.

uint32_t sd_clock_hfclk_request(void);

 

//释放高频晶体振荡器.

uint32_t sd_clock_hfclk_release(void);

 

//检查高频晶体振荡器是否在运行.

SVCALL(SD_CLOCK_HFCLK_IS_RUNNING, uint32_t, sd_clock_hfclk_is_running(uint32_t * p_is_running));

 

//等待程序事件.

uint32_t sd_app_evt_wait(void);

 

// Get PPI channel enable register contents.

uint32_t sd_ppi_channel_enable_get(uint32_t * p_channel_enable);

 

//Set PPI channel enable register.

uint32_t sd_ppi_channel_enable_set(uint32_t channel_enable_set_msk);

 

//Clear PPI channel enable register.

uint32_t sd_ppi_channel_enable_clr(uint32_t channel_enable_clr_msk);

 

// Assign endpoints to a PPI channel.

uint32_t sd_ppi_channel_assign(uint8_t channel_num,const volatile void * evt_endpoint, const volatile void * task_endpoint);

 

//Task to enable a channel group.

uint32_t sd_ppi_group_task_enable(uint8_t group_num);

 

//Task to disable a channel group.

uint32_t sd_ppi_group_task_disable(uint8_t group_num);

 

//Assign PPI channels to a channel group.

uint32_t sd_ppi_group_assign(uint8_t group_num, uint32_t channel_msk);

 

//Gets the PPI channels of a channel group.

uint32_t sd_ppi_group_get(uint8_t group_num, uint32_t * p_channel_msk);

 

//配置无线通知信号.

uint32_t sd_radio_notification_cfg_set(nrf_radio_notification_type_t type, nrf_radio_notification_distance_t distance);

 

// AES-ECB加密.

uint32_t sd_ecb_block_encrypt(nrf_ecb_hal_data_t * p_ecb_data);

 

// Gets any pending events generated by the SoC API.

uint32_t, sd_evt_get(uint32_t * p_evt_id);

 

//取得芯片温度

uint32_t sd_temp_get(int32_t * p_temp);

 

//写数据到Flash

sd_flash_write(uint32_t *const p_dst, uint32_tconst *const p_src, uint32_t size);

 

//擦除Flash页

uint32_t sd_flash_page_erase(uint32_t page_number);

 

// Flash Protection set

uint32_t sd_flash_protect(uint32_t protenset0, uint32_t protenset1);

ble.h

 

//从队列中取得等待处理的事件

uint32_t, sd_ble_evt_get(uint8_t* p_dest, uint16_t *p_len);

 

//取得BLE协议栈中有效地传输缓冲区总数

uint32_t sd_ble_tx_buffer_count_get(uint8_t* p_count);

 

//添加一个厂商特定UUID.

uint32_t sd_ble_uuid_vs_add(ble_uuid128_tconst *const p_vs_uuid, uint8_t *const p_uuid_type);

 

//解码原始小端UUID字节(16bit或128bit)到24bit的ble_uuid_t结构

uint32_t sd_ble_uuid_decode(uint8_t uuid_le_len, uint8_tconst *const p_uuid_le, ble_uuid_t *const p_uuid);

 

//编码24bit的ble_uuid_t结构到原始小端UUID字节(16bit或128bit)

uint32_t sd_ble_uuid_encode(ble_uuid_tconst *const p_uuid, uint8_t *const  p_uuid_le_len, uint8_t *const p_uuid_le));

 

//取得版本信息

uint32_t sd_ble_version_get(ble_version_t * p_version);

 

//提供用户内存块

uint32_t sd_ble_user_mem_reply(uint16_t conn_handle, ble_user_mem_block_t *p_block);

ble_gap.h

 

//设置本地蓝牙MAC地址

uint32_t sd_ble_gap_address_set(ble_gap_addr_tconst *const p_addr);

 

//取得本地蓝牙MAC地址

uint32_t sd_ble_gap_address_get(ble_gap_addr_t *const p_addr);

 

//设置,清除,更新广播扫描响应数据

uint32_t sd_ble_gap_adv_data_set(uint8_tconst *const p_data, uint8_t dlen, uint8_tconst *const p_sr_data, uint8_t srdlen);

 

//开始广播(Start advertising (GAP Discoverable, Connectable modes, Broadcast Procedure)

uint32_t sd_ble_gap_adv_start(ble_gap_adv_params_tconst *const p_adv_params);

 

//停止广播(Start advertising (GAP Discoverable, Connectable modes, Broadcast Procedure)

uint32_t sd_ble_gap_adv_stop(void);

 

//更新连接参数

uint32_t sd_ble_gap_conn_param_update(uint16_t conn_handle, ble_gap_conn_params_tconst *const p_conn_params);

 

//断开连接(GAP Link Termination).

uint32_t, sd_ble_gap_disconnect(uint16_t conn_handle, uint8_t hci_status_code);

 

//设置无线发射功率dBm(accepted values are -40, -30, -20, -16, -12, -8, -4, 0, and 4 dBm).

SVCALL(SD_BLE_GAP_TX_POWER_SET, uint32_t, sd_ble_gap_tx_power_set(int8_t tx_power))

;

 

//Set GAP Appearance value.

uint32_t sd_ble_gap_appearance_set(uint16_t appearance);

 

//Get GAP Appearance value.

uint32_t, sd_ble_gap_appearance_get(uint16_t *const p_appearance);

 

//设置GAP外设优先连接参数

uint32_t sd_ble_gap_ppcp_set(ble_gap_conn_params_tconst *const p_conn_params);

 

//取得GAP外设优先连接参数

uint32_t sd_ble_gap_ppcp_get(ble_gap_conn_params_t *const p_conn_params);

 

//设置GAP设备名

uint32_t sd_ble_gap_device_name_set(ble_gap_conn_sec_mode_tconst *const p_write_perm, uint8_tconst *const p_dev_name, uint16_t len);

 

//取得GAP设备名

uint32_t, sd_ble_gap_device_name_get(uint8_t *const p_dev_name, uint16_t *const p_len);

 

//启动GAP认证流程

uint32_t, sd_ble_gap_authenticate(uint16_t conn_handle, ble_gap_sec_params_tconst *const p_sec_params);

 

//Reply with GAP security parameters.

uint32_t sd_ble_gap_sec_params_reply(uint16_t conn_handle, uint8_t sec_status, ble_gap_sec_params_tconst *const p_sec_params);

 

//Reply with an authentication key

SVCALL(SD_BLE_GAP_AUTH_KEY_REPLY, uint32_t, sd_ble_gap_auth_key_reply(uint16_t conn_handle, uint8_t key_type, uint8_tconst *const key);

 

//Reply with GAP security information.

uint32_t sd_ble_gap_sec_info_reply(uint16_t conn_handle, ble_gap_enc_info_tconst *const p_enc_info, ble_gap_sign_info_tconst *const p_sign_info);

 

//Get the current connection security.

uint32_t, sd_ble_gap_conn_sec_get(uint16_t conn_handle, ble_gap_conn_sec_t *const p_conn_sec);

 

//开始接受RSSI值的变化通知

uint32_t sd_ble_gap_rssi_start(uint16_t conn_handle);

 

//停止接收RSSI值变化通知

SVCALL(SD_BLE_GAP_RSSI_STOP, uint32_t, sd_ble_gap_rssi_stop(uint16_t conn_handle);

ble_gattc.h

 

//启动或继续GATT主要服务的发现过程

uint32_t sd_ble_gattc_primary_services_discover(uint16_t conn_handle, uint16_t start_handle, ble_uuid_tconst *const p_srvc_uuid);

 

//启动或继续GATT关系发现过程

uint32_t sd_ble_gattc_relationships_discover(uint16_t conn_handle, ble_gattc_handle_range_tconst *const p_handle_range);

 

//启动或继续GATT特性发现过程

uint32_t sd_ble_gattc_characteristics_discover(uint16_t conn_handle, ble_gattc_handle_range_tconst *const p_handle_range);

 

//启动或继续GATT特性描述发现过程

uint32_t sd_ble_gattc_descriptors_discover(uint16_t conn_handle, ble_gattc_handle_range_tconst *const p_handle_range);

 

//启动或继续通过GATT特性的UUID的读操作

uint32_t sd_ble_gattc_char_value_by_uuid_read(uint16_t conn_handle, ble_uuid_tconst *const p_uuid, ble_gattc_handle_range_tconst *const p_handle_range);

 

//启动或继续GATT读取长特性或描述的过程

uint32_t sd_ble_gattc_read(uint16_t conn_handle, uint16_t handle, uint16_t offset);

 

//启动GATT读取多个特性值的过程

uint32_t sd_ble_gattc_char_values_read(uint16_t conn_handle, uint16_tconst *const p_handles, uint16_t handle_count);

 

//执行一个无报告的写操作

uint32_t sd_ble_gattc_write(uint16_t conn_handle, ble_gattc_write_params_tconst *const p_write_params);

 

//发送配置到GATT服务器

uint32_t sd_ble_gattc_hv_confirm(uint16_t conn_handle, uint16_t handle);

ble_gatts.h

 

//添加一个服务声明到本地服务的ATT表

uint32_t sd_ble_gatts_service_add(uint8_t type, ble_uuid_tconst*const p_uuid, uint16_t *const p_handle);

 

//添加一个包含声明到本地服务的ATT表

uint32_t sd_ble_gatts_include_add(uint16_t service_handle, uint16_t inc_srvc_handle, uint16_t *const p_include_handle);

 

//添加特性声明,特性值声明,可选的特性描述声明到ATT表

uint32_t sd_ble_gatts_characteristic_add(uint16_t service_handle, ble_gatts_char_md_tconst*const p_char_md, ble_gatts_attr_tconst*const p_attr_char_value, ble_gatts_char_handles_t *const p_handles);

 

//添加描述到ATT表

uint32_t sd_ble_gatts_descriptor_add(uint16_t char_handle, ble_gatts_attr_tconst *const p_attr, uint16_t*const p_handle);

 

//设置值到特性

uint32_t sd_ble_gatts_value_set(uint16_t handle, uint16_t offset, uint16_t*const p_len, uint8_tconst *const p_value);

 

//取得属性值

uint32_t sd_ble_gatts_value_get(uint16_t handle, uint16_t offset, uint16_t *const p_len, uint8_t* const p_data);

 

//Notify或Indicate特性值.

uint32_t, sd_ble_gatts_hvx(uint16_t conn_handle, ble_gatts_hvx_params_tconst*const p_hvx_params);

 

//Indicate属性值改变

uint32_t sd_ble_gatts_service_changed(uint16_t conn_handle, uint16_t start_handle, uint16_t end_handle);

 

//报告读写授权请求

uint32_t sd_ble_gatts_rw_authorize_reply(uint16_t conn_handle, ble_gatts_rw_authorize_reply_params_tconst*const p_rw_authorize_reply_params);

 

//Update persistent system attribute information

uint32_t sd_ble_gatts_sys_attr_set(uint16_t conn_handle, uint8_tconst*const p_sys_attr_data, uint16_t len);

 

//Retrieve persistent system attribute information from the stack.

uint32_t sd_ble_gatts_sys_attr_get(uint16_t conn_handle, uint8_t *const p_sys_attr_data, uint16_t*const p_len);

ble_l2cap.h

 

//注册一个L2CAP的CID

uint32_t sd_ble_l2cap_cid_register(uint16_t cid);

 

//注销CID

uint32_t sd_ble_l2cap_cid_unregister(uint16_t cid);

 

//发送L2CAP包

uint32_t sd_ble_l2cap_tx(uint16_t conn_handle, ble_l2cap_header_tconst *const p_header, uint8_tconst *const p_data);

nrf_sdm.h

 

//使能SoftDevice

uint32_t sd_softdevice_enable(nrf_clock_lfclksrc_t clock_source, softdevice_assertion_handler_t assertion_handler);

 

//禁用SoftDevice

uint32_t sd_softdevice_disable(void);

 

//检查SoftDevice是否已使能

uint32_t sd_softdevice_is_enabled(uint8_t * p_softdevice_enabled);

 

//开始转发中断到应用程序

uint32_t sd_softdevice_forward_to_application(void);