nRF51822库函数速查
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,and4dBm). 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);