MX1081 + 庆科Wifi库函数手册

cl17726 · 发表于2014-10-22 21:48

MX1081 + 庆科Wifi库函数手册 [复制链接]

AD0005_mxchipWNet_Library.pdf (1.47 MB, 下载次数: 35)

概览通过阅读头文件:

#ifndef __FILE_H__
#define __FILE_H__
#include "stdlib.h"
#include "string.h"
#include "mxchipWNet_TypeDef.h"
#include "stm32f2xx.h"
#define AF_INET 2
#define SOCK_STREAM 1
#define SOCK_DGRM 2
#define IPPROTO_TCP 6
#define IPPROTO_UDP 17
#define SOL_SOCKET 1
#define INADDR_ANY 0
#define INADDR_BROADCAST 0xFFFFFFFF
#define u8 unsigned char
#define u16 unsigned short
#define u32 unsigned int
#ifndef ssize_t
#define ssize_t unsigned int
#endif
//#ifndef size_t
//#define size_t unsigned int
//#endif
typedef struct _component_baseinfo_st{
char protocol_ver[32];
char hw_ver[32];
char sw_ver[32];
char product_id[32];
char product_date[32];
} COMPONENT_BASEINFO_st;
typedef struct _component_WIFIinfo_st{
COMPONENT_BASEINFO_st baseinfo;
char swlst[32];//eg:softap/wps
char securityt[32];//eg:wpa/wep/wpa2
char wkmode[32];//eg: b/g/n/a/bg/gn/bgn
} COMPONENT_WIFIINFO_st;
typedef struct _component_BTinfo_st{
COMPONENT_BASEINFO_st baseinfo;
int MFIflg;//if has MFI with CP 1-has ,0-none
} COMPONENT_BTINFO_st;
typedef struct _component_NFCinfo_st{
COMPONENT_BASEINFO_st baseinfo;
char nfc_model_no[32];//product model number
char nfc_id[32];//product id
char tag_type;//tag0:0，tag1:1，tag2:2，tag3:3
char nfc_mode;//passive：0，active：1，bi_direction：2；
} COMPONENT_NFCINFO_st;
struct sockaddr_t {
u16 s_type;
u16 s_port;
u32 s_ip;
u16 s_spares[6]; /* unused in TCP realm */
} ;
typedef struct in_addr {
u32 s_addr __attribute__ ((packed)); //fancpp add 2007.3.14 __packed, align byte
} in_addr_t;
struct timeval_t {
unsigned long tv_sec; /* seconds */
unsigned long tv_usec; /* microseconds */
};
typedef long time_t; /* 时间值time_t 为长整型的别名*/;
typedef struct _timeval_st{
long tv_sec; /*1970年1月1日至今的秒数*/
long tv_hmsec; /* 1970年1月1日至今的百豪秒数*/
}TIMEVAL_st;
#define NULL 0
typedef int socklen_t;
typedef enum
{
IRQ_TRIGGER_RISING_EDGE = 0x1, /* Interrupt triggered at input signal's rising edge */
IRQ_TRIGGER_FALLING_EDGE = 0x2, /* Interrupt triggered at input signal's falling edge */
IRQ_TRIGGER_BOTH_EDGES = IRQ_TRIGGER_RISING_EDGE | IRQ_TRIGGER_FALLING_EDGE,
} gpio_irq_trigger_t;
typedef void (*gpio_irq_handler_t)( void* arg);
typedef enum {
SO_REUSEADDR = 2, /* Socket always support this option */
SO_BROADCAST = 6, /* Socket always support this option */
SO_BLOCKMODE = 0x1000, /* set socket as block/non-block mode, default is block mode */
SO_SNDTIMEO = 0x1005, /* send timeout */
SO_RCVTIMEO =0x1006 , /* receive timeout */
SO_CONTIMEO =0x1007 , /* connect timeout */
SO_RDBUFLEN = 0x1008,
SO_WRBUFLEN = 0x1009,
} SOCK_OPT_VAL;
typedef struct _net_para {
char dhcp;
char ip[16]; // such as string "192.168.1.1"
char gate[16];
char mask[16];
char dns[16];
char mac[16]; // such as string "7E0000001111"
char broadcastip[16];
} net_para_st;
typedef struct _ApList_str
{
char ssid[32];
char ApPower; // min:0, max:100
}ApList_str;
typedef struct _UwtPara_str
{
char ApNum; //AP number
ApList_str * ApList;
} UwtPara_str;
typedef struct _uart_get_str
{
int BaudRate; //The baud rate
char number; //The number of data bits
char parity; //The parity(0: none, 1:odd, 2:evn, default:0)
char StopBits; //The number of stop bits
char FlowControl; //support flow control is 1
}uart_get_str;
typedef struct _uart_set_str
{
char UartName[8]; // the name of uart
int BaudRate; //The baud rate
char number; //The number of data bits
char parity; //The parity(default NONE)
char StopBits; //The number of stop bits
char FlowControl; //support flow control is 1
}uart_set_str;
typedef struct _uart_str
{
char baudrate; //The baud rate, 0:9600, 1:19200, 2:38400, 3:57600, 4:115200, 5:230400, 6:460800, 7:921600
char databits; //0:8, 1:9
char parity; //The parity(default NONE) 0:none, 1:even parity, 2:odd parity
char stopbits; //The number of stop bits , 0:1, 1:0.5, 2:2, 3:1.5
} uart_str;
typedef struct _network_InitTypeDef_st
{
char wifi_mode; // SoftAp(0)，sta(1)
char wifi_ssid[32];
char wifi_key[32];
char local_ip_addr[16];
char net_mask[16];
char gateway_ip_addr[16];
char dnsServer_ip_addr[16];
char dhcpMode; // disable(0), client mode(1), server mode(2)
char address_pool_start[16];
char address_pool_end[16];
int wifi_retry_interval;//sta reconnect interval, ms
} network_InitTypeDef_st;
typedef struct _sta_ap_state{
int is_connected;
int wifi_strength;
u8 ssid[32];
u8 bssid[6];
}sta_ap_state_t;
struct wifi_InitTypeDef
{
u8 wifi_mode; // adhoc mode(1), AP client mode(0), AP mode(2)
u8 wifi_ssid[32];
u8 wifi_key[32];
};
typedef enum {
MXCHIP_SUCCESS = 0,
MXCHIP_FAILED = -1,
MXCHIP_8782_INIT_FAILED = -2,
MXCHIP_SYS_ILLEGAL = -3,
MXCHIP_WIFI_JOIN_FAILED = -4,
MXCHIP_WIFI_UP = 1,
MXCHIP_WIFI_DOWN,
MXCHIP_UAP_UP,
MXCHIP_UAP_DOWN,
} MxchipStatus;
/* Upgrade iamge should save this table to flash */
#pragma pack(1)
typedef struct _boot_table_t {
u32 start_address; // the address of the bin saved on flash.
u32 length; // file real length
u8 version[8];
u8 type; // B:bootloader, P:boot_table, A:application, D: 8782 driver
u8 upgrade_type; //u:upgrade,
u8 reserved[6];
}boot_table_t;
typedef struct _lib_config_t {
int tcp_buf_dynamic; // TCP socket buffer dynamic malloc. 1:enable 0:diaable
int hw_watchdog; // Watchdag output: EMW3162->PC2, EMW3161->PB14. 1:enable 0:diaable
}lib_config_t;
enum {
SLEEP_UNIT_MS = 0,
SLEEP_UNIT_BEACON = 1,
};
#define FD_UART 1
#define FD_USER_BEGIN 2
#define FD_SETSIZE 1024 // MAX 1024 fd
typedef unsigned long fd_mask;
#define NBBY 8 /* number of bits in a byte */
#define NFDBITS (sizeof(fd_mask) * NBBY) /* bits per mask */
#define howmany(x, y) (((x) + ((y) - 1)) / (y))
typedef struct fd_set {
fd_mask fds_bits[howmany(FD_SETSIZE, NFDBITS)];
} fd_set;
#define _fdset_mask(n) ((fd_mask)1 << ((n) % NFDBITS))
#define FD_SET(n, p) ((p)->fds_bits[(n)/NFDBITS] |= _fdset_mask(n))
#define FD_CLR(n, p) ((p)->fds_bits[(n)/NFDBITS] &= ~_fdset_mask(n))
#define FD_ISSET(n, p) ((p)->fds_bits[(n)/NFDBITS] & _fdset_mask(n))
#define FD_ZERO(p) memset(p, 0, sizeof(*(p)))
#define MSG_DONTWAIT 0x40 /* Nonblocking io */
extern void lib_config(lib_config_t* conf);
extern int setSslMaxlen(int len);
extern int getSslMaxlen(void);
extern void set_cert(const char *cert_pem, const char*private_key_pem);
extern int setSSLmode(int enable, int sockfd);
extern int SelectSupport(void);
extern int tx_buf_size(int sockfd);
extern int socket(int domain, int type, int protocol);
extern int setsockopt(int sockfd, int level, int optname,const void *optval, socklen_t optlen);
extern int bind(int sockfd, const struct sockaddr_t *addr, socklen_t addrlen);
extern int connect(int sockfd, const struct sockaddr_t *addr, socklen_t addrlen);
extern int listen(int sockfd, int backlog);
extern int accept(int sockfd, struct sockaddr_t *addr, socklen_t *addrlen);
extern int select(int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, struct timeval_t *timeout);
extern ssize_t send(int sockfd, const void *buf, size_t len, int flags);
extern ssize_t sendto(int sockfd, const void *buf, size_t len, int flags,const struct sockaddr_t *dest_addr,
socklen_t addrlen);
extern ssize_t recv(int sockfd, void *buf, size_t len, int flags);
extern ssize_t recvfrom(int sockfd, void *buf, size_t len, int flags,struct sockaddr_t *src_addr, socklen_t
*addrlen);
extern int read(int sockfd, void *buf, size_t len);
extern int write(int sockfd, void *buf, size_t len);
extern int close(int fd);
extern int GetUartPara (char *uart_name, uart_get_str * uart_para);
extern int GetUartNum(char *uartname);
extern int SetUartPara (uart_set_str *puartpara);
extern int OpenUART(char* uart_name);
extern MxchipStatus mxchipInit(void);
extern int StartNetwork(network_InitTypeDef_st* pNetworkInitPara);
int getNetPara(net_para_st * pnetpara, WiFi_Interface iface);
extern void mxchipTick(void);
extern void mxchipStartScan(void);
extern int StartScan(int interval);
extern int StopScan(void);
extern int CheckNetLink(sta_ap_state_t *ap_state);
int ReallocIP(void);
int gethostbyname(const char * name, u8 * ip_addr, u8 ipLength);
u32 dns_request(char *hostname);
extern int SetTimer(unsigned long ms, void (*psysTimerHandler)(void));
/* User provide watch dog callback function */
extern void WatchDog(void);
extern int FlashGetInfo(int *flashadd,int len);
extern int FlashRead(int flashadd,char *pbuf,int len);
extern int FlashWrite(int flashadd,char *pbuf,int len);
extern int FlashErase(int flashadd, int erase_bytelen);
extern MxchipStatus newimage_write(int offset , int len , char *pbuf);
extern int sleep(int seconds);
extern int msleep(int mseconds);
extern u16 ntohs(u16 n);
extern u16 htons(u16 n);
extern u32 ntohl(u32 n);
extern u32 htonl(u32 n);
/* Convert an ip address string in dotted decimal format to its binary representation.*/
extern u32 inet_addr(char *s);
/* Convert a binary ip address to its dotted decimal format.
PARAMETER1 's': location to place the dotted decimal string. This must be an array of at least 16 bytes.
PARAMETER2 'x': ip address to convert.
RETURN VALUE: returns 's' .
*/
extern char *inet_ntoa( char *s, u32 x );
extern void enable_ps_mode(int unit_type, int unitcast_ms, int multicast_ms);
extern void disable_ps_mode(void);
extern void system_reload(void);
/* This is function is used to caclute the md5 value for the input buffer
* input: the source buffer;
* len: the length of the source buffer;
* output: point the output buffer, should be a 16 bytes buffer
*/
extern void md5_hex(u8 *input, u32 len, u8 *output);
int wifi_power_down(void);
int wifi_power_up(void);
int wlan_disconnect(void);
int sta_disconnect(void);
int uap_stop(void);
int OpenConfigmodeWPS(int timeout);
int CloseConfigmodeWPS(void);
int OpenEasylink(int timeout);
int CloseEasylink(void);
int OpenBT(int timeout);
int CloseBT(void);
int SetBTName(char *name);
int SetBTpin(char *pin, int enable);
int SetBTboundleID(char*boundleID);
int SetBTseedID(char* seedID);
int SetBTsdkProto(char*sdkproto);
int GetBTArg(char *name, char *pin, int *enable_pin, char *boundleID);
int SetBT_SearchAppPara(char *boundleID, char *seedId, char *SdkProtocolToken);
/* devlist return mac[4][6], return 4 mac address, last_dev_index is the last connected dev index (0~3)*/
int GetBTDevlist(char *devlist, u8 *last_dev_index);
int CheckComponentBT(COMPONENT_BTINFO_st *pst);
int CheckComponentWIFI(COMPONENT_WIFIINFO_st *pst);
int CheckComponentNFC(COMPONENT_NFCINFO_st * st);
int OpenConfigmodeNFC(int timeout);
int CloseConfigmodeNFC(void);
void RptConfigmodeRslt(network_InitTypeDef_st *nwkpara);
void ApListCallback(UwtPara_str *pApList);
time_t user_time(TIMEVAL_st *t);
void ps_enable(void);
void ps_disable(void);
void set_tcp_keepalive(int num, int seconds);
void get_tcp_keepalive(int *num, int *seconds);
int gpio_irq_enable ( GPIO_TypeDef* gpio_port, uint8_t gpio_pin_number, gpio_irq_trigger_t trigger, gpio_irq_handler_t handler, void* arg );
int gpio_irq_disable( GPIO_TypeDef* gpio_port, uint8_t gpio_pin_number );
int get_tcp_clients(void);
void memory_status(int *total_free, int *max_len);
void get_malloc_list(void (*debug_mem)(u32 p, int len));
void malloc_list_mem(u8 *memory_tbl, int size);
// user provide callback function
void WatchDog(void);
void WifiStatusHandler(int status);
void RptConfigmodeRslt(network_InitTypeDef_st *nwkpara);
void NetCallback(net_para_st *pnet);
void ApListCallback(UwtPara_str *pApList);
void dns_ip_set(u8 *hostname, u32 ip);
void socket_connected(int fd);
void NoOS_systick_irq(void);
void gpio_irq(void);
void sdio_irq(void);
void dma_irq(void);
void bt_uart_irq(void);
/* transform src string to hex mode
* example: "aabbccddee" => 0xaabbccddee
* each char in the string must 0~9 a~f A~F, otherwise return 0
* return the real obuf length
*/
extern unsigned int str2hex(unsigned char *ibuf, unsigned char *obuf, unsigned int olen);
#endif

复制代码