slp.h

浏览该文件的文档.

/*
 * Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2024-2024. All rights reserved.
 * Description: slp api
 * ROM      : NO
 * STRATEGY : NO
 */
 
#ifndef SLP_H
#define SLP_H
 
#include <stdint.h>
#include <stdbool.h>
#include "slp_errcode.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define SLP_MAX_DEVICE_NUM 16
 
#define SLP_ADDR_LEN 6
 
typedef struct {
    uint8_t addr[SLP_ADDR_LEN];     
} SlpDeviceAddr;
 
typedef enum {
    SLP_SEC_MODE_LPLS = 0,          
    SLP_SEC_MODE_HPHS               
} SlpSecMode;
 
typedef enum {
    SLP_ENCRYPT_MODE_AES128 = 0,       
    SLP_ENCRYPT_MODE_SM4               
} SlpEncryptMode;
 
typedef enum {
    SLP_WB_SHARED_KEY = 0,       
    SLP_NB_SESSION_KEY           
} SlpSessionKeyMode;
 
typedef struct {
    uint8_t secMode;            
    uint8_t encryptMode;        
    uint8_t sessionKeyMode;     
    uint8_t sessionKeyIdx;      
} SlpSecurityParam;
 
typedef struct {
    uint8_t codeLen;            
    uint8_t syncCodeIdx;        
    uint8_t syncSymNum;         
    uint8_t ctsSegNum;          
    uint8_t ctsSegSymNum;       
    uint8_t gapBaseSymNum;      
    uint8_t ctsCpLen;           
} SlpFrameParam;
 
typedef enum {
    SLP_CH_5 = 0,        
    SLP_CH_6,            
    SLP_CH_8,            
    SLP_CH_9             
} SlpChannel;
 
typedef enum {
    SLP_USAGE_RANGING_AOX = 0,        
    SLP_USAGE_AIR_MOUSE,              
} SlpUsageMode;
 
typedef enum {
    SLP_RANGING_ONLY = 0,           
    SLP_RANGING_AOA,                
} SlpRangingMode;
 
typedef enum {
    SLP_ONE_TO_ONE = 0,         
    SLP_ONE_TO_MANY,            
    SLP_MANY_TO_MANY            
} SlpMultiNodeMode;
 
typedef enum {
    SLP_OWR = 0,            
    SLP_SS_TWR,             
    SLP_DS_TWR              
} SlpRangingRoundUsage;
 
typedef enum {
    SLP_MR_RECV = 0,        
    SLP_MR_SEND             
} SlpMrSource;
 
typedef enum {
    SLP_POLL_AOX = 0,              
    SLP_RESPONSE_AOX,              
    SLP_DOUBLE_SIDE_AOX            
} SlpAoxDirection;
 
typedef enum {
    SLP_NB_SINGLE_SIDE_SYNC = 1,        
    SLP_NB_DOUBLE_SIDE_SYNC,            
} SlpNbSyncMode;
 
typedef struct {
    uint8_t chIdx;                          
    uint8_t usageMode;                      
    uint8_t slpRangingMode;                 
    uint8_t multiNodeMode;                  
    uint8_t rangingRoundUsage;              
    uint8_t mrSource;                       
    uint8_t rangingFreq;                    
    uint8_t validRoundNum;                  
    uint8_t aoxDirection;                   
    uint8_t nbSyncMode;                     
    uint8_t deviceNum;                      
    uint32_t sessionId;                     
    SlpDeviceAddr deviceAddr[SLP_MAX_DEVICE_NUM]; 
} SlpRangingParam;
 
typedef struct {
    SlpFrameParam frameParam;           
    SlpSecurityParam secParam;          
    SlpRangingParam rangingParam;       
} SlpStartRangingParam;
 
typedef enum {
    SLP_SCREEN_720P = 0,              
    SLP_SCREEN_1080P,                 
    SLP_SCREEN_4K,                    
    SLP_SCREEN_8K                     
} SlpScreenResolution;
 
typedef enum {
    SLP_CURSOR_SPEED_LOW = 0,          
    SLP_CURSOR_SPEED_MEDIUM,           
    SLP_CURSOR_SPEED_HIGH,             
} SlpCursorSpeed;
 
typedef struct {
    uint8_t cursorSpeed;               
    uint8_t resolution;                
} SlpScreenParam;
 
typedef struct {
    SlpDeviceAddr localAddr;        
    SlpScreenParam screenParam;     
} SlpLocalAtt;
 
typedef struct {
    uint32_t distance;                  
    uint8_t aoxAziFom;                  
    uint8_t aoxElevFom;                 
    int16_t aoxAzi;                     
    int16_t aoxElev;                    
    SlpDeviceAddr providerAddr;         
    SlpDeviceAddr requestorAddr;        
} SlpRangingRpt;
 
typedef struct {
    uint8_t *payload;                  
    uint16_t payloadLen;               
} SlpPayloadInfo;
 
typedef void (*SlpReportRangingCallback)(SlpRangingRpt *rangingRpt);
 
typedef void (*SlpReportCursorCallback)(uint16_t x, uint16_t y);
 
typedef void (*SlpSendPayloadCallback)(const SlpPayloadInfo *info);
 
void SlpTask(void* param);
 
ErrcodeSlpClient SlpPowerOnCommand(void);
 
ErrcodeSlpClient SlpStartRangingCommand(const SlpStartRangingParam *param);
 
ErrcodeSlpClient SlpPowerOffCommand(void);
 
ErrcodeSlpClient SlpSleepCommand(void);
 
ErrcodeSlpClient SlpSetLocalAttCommand(const SlpLocalAtt *param);
 
ErrcodeSlpClient SlpRecvPayload(const SlpPayloadInfo *info);
 
ErrcodeSlpClient SlpRegisterSendPayloadCallback(SlpSendPayloadCallback cbk);
 
typedef struct {
    SlpReportCursorCallback rptCursorCbk;               
    SlpReportRangingCallback rptRangingCbk;             
} SlpReportCallbacks;
 
ErrcodeSlpClient SlpRegisterReportCallbacks(SlpReportCallbacks *func);
 
#ifdef __cplusplus
}
#endif
 
#endif