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_t const * 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_t const * 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_t const * 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_t const * 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_t const * 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_t const * const p_data, uint8_t dlen, uint8_t const * 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_t const * 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_t const * 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_t const * 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_t const * const p_write_perm, uint8_t const * 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_t const * 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_t const * 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_t const * const key);

//Reply with GAP security information.
uint32_t sd_ble_gap_sec_info_reply(uint16_t conn_handle, ble_gap_enc_info_t const * const p_enc_info, ble_gap_sign_info_t const * 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_t const * const p_srvc_uuid);

//启动或继续GATT关系发现过程
uint32_t sd_ble_gattc_relationships_discover(uint16_t conn_handle, ble_gattc_handle_range_t const * const p_handle_range);

//启动或继续GATT特性发现过程
uint32_t sd_ble_gattc_characteristics_discover(uint16_t conn_handle, ble_gattc_handle_range_t const * const p_handle_range);

//启动或继续GATT特性描述发现过程
uint32_t sd_ble_gattc_descriptors_discover(uint16_t conn_handle, ble_gattc_handle_range_t const * const p_handle_range);

//启动或继续通过GATT特性的UUID的读操作
uint32_t sd_ble_gattc_char_value_by_uuid_read(uint16_t conn_handle, ble_uuid_t const * const p_uuid, ble_gattc_handle_range_t const * 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_t const * const p_handles, uint16_t handle_count);

//执行一个无报告的写操作
uint32_t sd_ble_gattc_write(uint16_t conn_handle, ble_gattc_write_params_t const * 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_t const*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_t const*const p_char_md, ble_gatts_attr_t const*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_t const * 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_t const * 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_t const*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_t const*const p_rw_authorize_reply_params);

//Update persistent system attribute information
uint32_t sd_ble_gatts_sys_attr_set(uint16_t conn_handle, uint8_t const*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_t const * const p_header, uint8_t const * 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);