状态机实现WIFI模组物联网功能详解

1.0 状态机框架原理

如果成功的话就连接热点,如果失败就返回AT通信检查,如果AT通信检查还是失败就放回硬件复位这个状态,如果热点链接成功,就连接MQTT指令,如果失败就返回AT通信检查,如果成功就连接云平台通信,如果失败就返回AT通信检查这个状态。


2.0 程序编写


在这个过程中使用的是连接固定的热点,后续会连接可变动的WIFI热点,注上面的状态图是基于固定的WIFI热点连接的状态图形。

// 创建枚举类型
typedef enum
{
	WIFI_COMM_WAIT,
	WIFI_COMM_OK,
	WIFI_COMM_FALL,
}WifiCommState_t;

注:WIFI_COMM_WAIT 表示的是正在处理AT指令,WIFI_COMM_OK,表示AT指令发送完成,FALL表示AT指令发送超时,


3.0 Wi-Fi模块与AT命令交互

static WifiCommState_t AtCmdHandle(char *cmd, char* rsp, uint32_t timeoutMs)
{
	static WifiCommState_t s_commState = WIFI_COMM_OK;
	static uint64_t s_sendCmdTime;
	char *recvStrBuf;
	
	if (s_commState != WIFI_COMM_WAIT)
	{
		if (cmd != NULL)
		{
			SendWifiModuleStr(cmd);
		}
		s_commState = WIFI_COMM_WAIT;
		s_sendCmdTime = GetSysRunTime();
	}
	else
	{
		if ((GetSysRunTime() - s_sendCmdTime) < timeoutMs)
		{
			recvStrBuf = RecvWifiModuleStr();
			if (strstr(recvStrBuf, rsp) != NULL)
			{
				s_commState = WIFI_COMM_OK;
			}
		}
		else
		{
			s_commState = WIFI_COMM_FALL;
		}
	}
	return s_commState;
}

4.0 AT 命令结构体信息

// AT命令信息
typedef struct
{
	char *cmd;
	char *rsp;
	uint32_t timeoutMs;
}AtCmdInfo_t;

5.0 模组初始化命令集

/*模组初始化命令集*/
static AtCmdInfo_t g_checkModuleCmdTable[] = {
    {
        .cmd = "ATE0\r\n",        // 关闭回显
        .rsp = "OK",
		.timeoutMs = 1000,
    },
	{
        .cmd = "AT+CWMODE=1\r\n",
        .rsp = "OK",
		.timeoutMs = 1000,	
	},
};

对应在AT指令说明文档中的命令是:ATE 表示的是开启和关闭回显

.cmd = "AT+CWMODE=1\r\n",

注:这个指令是用于设置WIFI的工作模式,该指令表示的原因是设置WIFI的工作指令为客户端的工作模式。

  1. .cmd = "AT+CWMODE=1\r\n":

  2. 这是AT命令的字符串表示形式,用于设置Wi-Fi模块的工作模式。
  3. AT+CWMODE=1 表示设置Wi-Fi模块工作在Station模式(客户端模式),即Wi-Fi模块将连接到一个现有的Wi-Fi网络。
  4. \r\n 是回车换行符,通常用于表示命令的结束。
  5. .rsp = "OK":

  6. 这是指令成功执行后期望从Wi-Fi模块接收到的响应字符串。
  7. 在许多情况下,Wi-Fi模块会在成功执行AT命令后返回 "OK"
  8. .timeoutMs = 1000:

  9. 这是一个整数,表示在等待Wi-Fi模块响应时的超时时间,单位是毫秒。
  10. 在本例中,超时时间为1000毫秒(1秒)。

4.0 检查WIFI模组的工作状态

WifiCommState_t CheckWifiModuleWork(void)
{
	WifiCommState_t commState;
	static uint8_t retryCount = 0;
	static AtCheckModuleCmdType cmdType = AT_E0;
	
	switch (cmdType)
	{
		case AT_E0:
			commState = AtCmdHandle(g_checkModuleCmdTable[AT_E0].cmd, g_checkModuleCmdTable[AT_E0].rsp,
			g_checkModuleCmdTable[AT_E0].timeoutMs);
			if (commState == WIFI_COMM_OK)
			{
				retryCount = 0;
				cmdType = AT_CWMODE_1;
			}
			else if (commState == WIFI_COMM_FALL)
			{
				retryCount++;
				if (retryCount == 3)
				{
					retryCount = 0;
					return WIFI_COMM_FALL;
				}
			}
			break;
		case AT_CWMODE_1:
			commState = AtCmdHandle(g_checkModuleCmdTable[AT_CWMODE_1].cmd, g_checkModuleCmdTable[AT_CWMODE_1].rsp,
			g_checkModuleCmdTable[AT_CWMODE_1].timeoutMs);
			
			if (commState == WIFI_COMM_OK)
			{
				cmdType = AT_E0;
				return WIFI_COMM_OK;
			}
			else if (commState == WIFI_COMM_FALL)
			{
				return WIFI_COMM_FALL;
			}
			break;
	}
	return WIFI_COMM_WAIT;
}

5.0 创建AT指令表

static AtCmdInfo_t g_ConnectApCmdTable[] = {
	{
		.cmd = "AT+CWJAP=\"%s\",\"%s\"\r\n",   // 这里的\是给编译器用的
		//.cmd = "AT+CWJAP=\"HIKE_5F\\,2.4G\",\"hike666666\"\r\n",
		.rsp = "GOT IP",
		.timeoutMs = 15000,
	},
};

注:"AT+CWJAP=\"%s\",\"%s\"\r\n" 此处这条AT指令的格式为什么是这样,主要原因是AT手册规定的格式就是这个样子:在程序中凡是AT指令出现, " \ 都需要在前面添加\号进行转义,具体如下所示:


6.0 AT+CWJAP 命令详解

注:

  • AT+CWJAP: 这是Wi-Fi模块用于连接到无线接入点(Access Point, AP)的AT命令。
  • SSID: 服务集标识符(Service Set Identifier),它是用来唯一标识一个无线网络的名字。
  • PWD: 密码,指的是Wi-Fi网络的安全密钥或密码。
  • AT+CWJAP="SSID","password"
  • SSID 替换为你要连接的Wi-Fi网络的名称。
  • password 替换为对应的Wi-Fi网络密码。

  • 7.0 检查WIFI连接函数

    typedef enum 
    {
    	AT_CWJAP_SSID_PWD,
    } AtConnectApCmdType;
    
    static char g_apSsid[20] = "HIKE_5F_2.4G";
    static char g_apPwd[20] = "hike666666";
    
    WifiCommState_t CheckWifiConnect(void)
    {
    	WifiCommState_t commState;
    	static AtConnectApCmdType cmdType = AT_CWJAP_SSID_PWD;
    	static uint8_t retryCount = 0;
    	char cmdStrBuf[256];
    	switch (cmdType)
    	{		
    		case AT_CWJAP_SSID_PWD:
    			
    			sprintf(cmdStrBuf, g_ConnectApCmdTable[AT_CWJAP_SSID_PWD].cmd, g_apSsid, g_apPwd);
    			commState = AtCmdHandle(cmdStrBuf, g_ConnectApCmdTable[AT_CWJAP_SSID_PWD].rsp, 
    								 g_ConnectApCmdTable[AT_CWJAP_SSID_PWD].timeoutMs);
    		
    			if (commState == WIFI_COMM_OK)
    			{
    				retryCount = 0;
    				return WIFI_COMM_OK;
    			}
    			else if (commState == WIFI_COMM_FAIL)
    			{
    				retryCount++;
    				if (retryCount == 3)
    				{
    					retryCount = 0;
    					return WIFI_COMM_FAIL;
    				}
    
    			}
    			break;
    	}
    	return WIFI_COMM_WAIT;	
    }

    8.0 枚举WIFI工作状态

    typedef enum
    {
    	CHECK_WIFI_MODULE,
    	CHECK_WIFI_CONNECT,
    	CONNECT_MQTT_SERVER,
    	COMM_MQTT_SERVER,
    	HWRESET_WIFI_MODULE,
    	WIWI_MODULE_ERROR,
    } WifiWorkState_t;
    

    注:一以上各个枚举变量的含义:

    这个枚举类型 WifiWorkState_t 定义了一系列的状态,用于描述Wi-Fi模块在执行特定任务时的不同阶段。这些状态可以帮助我们跟踪Wi-Fi模块的工作流程。下面是每个枚举成员的含义:

    1. CHECK_WIFI_MODULE:

    2. 这个状态表示正在检查Wi-Fi模块的基本功能或状态。这可能是初始化过程的一部分,用于验证Wi-Fi模块是否准备好接受进一步的命令。
    3. CHECK_WIFI_CONNECT:

    4. 这个状态表示正在检查Wi-Fi模块是否已成功连接到Wi-Fi网络。这通常发生在Wi-Fi模块尝试连接到一个接入点之后。
    5. CONNECT_MQTT_SERVER:

    6. 这个状态表示Wi-Fi模块正在尝试连接到MQTT服务器。一旦Wi-Fi连接建立,下一步就是与MQTT服务器建立连接。
    7. COMM_MQTT_SERVER:

    8. 这个状态表示Wi-Fi模块已经成功连接到了MQTT服务器,并且正在与其进行通信。这可能涉及到发布消息、订阅主题等MQTT协议的交互。
    9. HWRESET_WIFI_MODULE:

    10. 这个状态表示正在对Wi-Fi模块执行硬件重置。这可能是因为遇到一些无法通过软件解决的问题,或者是为了确保Wi-Fi模块回到一个已知的初始状态。
    11. WIWI_MODULE_ERROR:

    12. 这个状态表示Wi-Fi模块遇到了错误。这可能是由于硬件故障、软件错误或其他未知问题引起的。当Wi-Fi模块无法正常工作时,它可能会进入这个状态。

    9.0 WIFI网络工作任务函数

    void WifiNetworkTask(void)
    {
    	WifiCommState_t commState;
    	static WifiWorkState_t workState = CHECK_WIFI_MODULE;
    	static uint8_t hwresetCnt = 0;
    	switch (workState)
    	{
    		case CHECK_WIFI_MODULE:
    			commState = CheckWifiModuleWork();
    			if (commState == WIFI_COMM_OK)
    			{
    				workState = CHECK_WIFI_CONNECT;
    			}
    			else if (commState == WIFI_COMM_FAIL)
    			{
    				workState = HWRESET_WIFI_MODULE;
    			}
    			break;
    		case CHECK_WIFI_CONNECT:
    			commState = CheckWifiConnect();
    			if (commState == WIFI_COMM_OK)
    			{
    				workState = CONNECT_MQTT_SERVER;
    			}
    			else if (commState == WIFI_COMM_FAIL)
    			{
    				workState = CHECK_WIFI_MODULE;
    			}
    			break;		
    		case CONNECT_MQTT_SERVER:
    			break;
    		case COMM_MQTT_SERVER:
    			break;
    		case HWRESET_WIFI_MODULE:
    			if (hwresetCnt < 1)                 // 如果AT命令不通,硬件复位1次
    			{
    				HwresetWifiModule();
    				DelayNms(1000);
    				workState = CHECK_WIFI_MODULE;
    				hwresetCnt++;
    			}
    			else
    			{
    				printf("wifi module error!\n");
    				workState = WIWI_MODULE_ERROR;  // 如果硬件复位1次,AT命令还是不通,就不再执行WIFI任务的业务逻辑,直接退出,避免影响其他任务
    			}
    			break;
    		default:
    			break;
    	}
    }

    10.0 网络连接成功

    作者:_沧浪之水_

    物联沃分享整理
    物联沃-IOTWORD物联网 » 状态机实现WIFI模组物联网功能详解

    发表回复