aboutsummaryrefslogtreecommitdiff
path: root/stm32f091/server.h
blob: 44882e441ca176bb2a547df996e0806264bf96c2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
#pragma once

#include <stdlib.h>
#include <stdint.h>
#include <stdbool.h>

typedef enum {
	WS_SERVER_LM_CMD_ECHO, /** @brief listen for echo of sent command */
	WS_SERVER_LM_STATUS_CODE, /** @brief listen for busy, ERROR or OK */
	WS_SERVER_LM_IDLE, /** @brief listen for incoming +IPD commands */
	WS_SERVER_LM_IPD_LISTENING, /** @brief +IPD received, now reading data */
} ws_e_server_listen_mode;

typedef enum {
	WS_SERVER_CL_CHANNEL_ID, /** @brief listen channel id */
	WS_SERVER_CL_DATA_LENGTH, /** @brief listen for data byte length */
	WS_SERVER_CL_DATA_READ, /** @brief listen for data and pipe to ws_protocol_parse_req_byte */
} ws_e_channel_listen_mode;

typedef enum {
	WS_SERVER_RC_NONE = -1,
	WS_SERVER_RC_BUSY,
	WS_SERVER_RC_ERR,
	WS_SERVER_RC_OK,
} ws_e_server_response_code;

typedef struct {
	ws_e_server_listen_mode mode;
	ws_e_server_response_code last_response;
	unsigned int current_channel;
	unsigned int channel_data_length;
	unsigned int channel_data_counter;
	ws_e_channel_listen_mode channel_listen_mode;
	bool channel_data_ignore;
} ws_s_server_parser;

/**
 * @brief +IPD incoming request handler
 *
 * this function takes chunks of data from the esp8266 and parses +IPD
 * commands. when a valid +IPD command is detected, it gets forwarded to
 * ws_protocol_parse_req_byte.
 *
 * @param data  pointer to data array
 * @param size  amount of bytes allowed to be read from `data`
 */
void ws_server_req_incoming(uint8_t* data, size_t size);

/** @brief send response to incoming request on specific channel */
void ws_server_req_respond(unsigned int channel, uint8_t* data, size_t size);

/** @brief send data to esp, waiting until server returns to idle mode */
void ws_server_send(uint8_t* data, size_t size);

/**
 * @brief parse byte from channel
 *
 * automatically creates parser struct and passes data onto protocol parser
 * functions
 *
 * @param channel  request channel
 * @param byte  data byte
 * @param ignore  ignore mode
 */
void ws_server_req_parse_byte(unsigned int channel, uint8_t byte, bool ignore);

/**
 * @brief close connection
 *
 * deallocates any parser struct that were automatically created in
 * ws_server_req_parse_byte
 *
 * @param channel  request channel
 * @param ignore  ignore mode
 */
void ws_server_req_finish(unsigned int channel, bool ignore);