HTTP Server#

Functions#

int16_t

rsi_wlan_nwk_register_json_update_cb(uint32_t callback_id, void(*callback_handler_ptr)(uint8_t *filename, uint8_t *json_object, uint32_t length, uint32_t status))

int16_t

rsi_wlan_nwk_register_json_event_cb(uint32_t callback_id, void(*callback_handler_ptr)(uint32_t status, uint8_t *json_object, uint32_t length))

int16_t

rsi_wlan_nwk_register_webpage_req_cb(uint32_t callback_id, void(*callback_handler_ptr)(uint8_t type, uint8_t *url_name, uint8_t *post_content_buffer, uint32_t post_content_length, uint32_t status))

int16_t

rsi_wlan_nwk_register_wireless_fw_upgrade_cb(uint32_t callback_id, void(*callback_handler_ptr)(uint8_t type, uint32_t status))

int32_t

rsi_webpage_load(uint8_t flags, uint8_t *file_name, uint8_t *webpage, uint32_t length)

Load the webpage to the HTTP Server's file system that is present in the WiSeConnect module. This is a blocking API.

int32_t

rsi_json_object_create(uint8_t flags, const char *file_name, uint8_t *json_object, uint32_t length)

Create the JSON object to the webpage that is already present in the WiSeConnect module's HTTP server file system. This is a blocking API.

int32_t

rsi_webpage_erase(uint8_t *file_name)

Erase the webpage from HTTP server's file system that is present in the WiSeConnect module. This is a blocking API.

int32_t

rsi_json_object_delete(uint8_t *file_name)

Delete the JSON object of the HTTP server's file system that is already present in the WiSeConnect module. This is a blocking API.

int32_t

rsi_webpage_send(uint8_t flags, uint8_t *webpage, uint32_t length)

Send the webpage to HTTP server's file system. This is a blocking API.

Function Documentation#

rsi_wlan_nwk_register_json_update_cb#

int16_t rsi_wlan_nwk_register_json_update_cb (uint32_t callback_id, void(*)(uint8_t *filename, uint8_t *json_object, uint32_t length, uint32_t status) callback_handler_ptr, filename, json_object, length, status)

Parameters

Type	Direction	Argument Name	Description
uint32_t	[in]	callback_id	- call back number which needs to be registered
void()(uint8_t filename, uint8_t *json_object, uint32_t length, uint32_t status)	[in]	callback_handler_ptr	- call back handler which needs to be registered for a given call back
	[out]	filename	- json object filename
	[out]	json_object	- json object data
	[out]	length	- This is the length of the response buffer.
	[out]	status	- This is the response status.

Returns

0 - Success Negative Value - Failure

Note

Please refer to Error Codes section for the description of the above error codes Error Codes.

References rsi_wlan_cb_non_rom_s::nwk_callbacks , rsi_nwk_callback_s::rsi_json_object_update_handler , and RSI_SUCCESS

rsi_wlan_nwk_register_json_event_cb#

int16_t rsi_wlan_nwk_register_json_event_cb (uint32_t callback_id, void(*)(uint32_t status, uint8_t *json_object, uint32_t length) callback_handler_ptr, status, json_object, length)

Parameters

Type	Direction	Argument Name	Description
uint32_t	[in]	callback_id	- call back number which needs to be registered
void()(uint32_t status, uint8_t json_object, uint32_t length)	[in]	callback_handler_ptr	- call back handler which needs to be registered for a given call back
	[out]	status	- This is the response status.
	[out]	json_object	- json object data
	[out]	length	- This is the length of the response buffer.

Returns

0 - Success Positive Value - Failure

References rsi_wlan_cb_non_rom_s::nwk_callbacks , rsi_nwk_callback_s::rsi_json_object_event_handler , and RSI_SUCCESS

rsi_wlan_nwk_register_webpage_req_cb#

int16_t rsi_wlan_nwk_register_webpage_req_cb (uint32_t callback_id, void(*)(uint8_t type, uint8_t *url_name, uint8_t *post_content_buffer, uint32_t post_content_length, uint32_t status) callback_handler_ptr, type, url_name, post_content_buffer, post_content_length, status)

Parameters

Type	Direction	Argument Name	Description
uint32_t	[in]	callback_id	- call back number which needs to be registered
void()(uint8_t type, uint8_t url_name, uint8_t *post_content_buffer, uint32_t post_content_length, uint32_t status)	[in]	callback_handler_ptr	- call back handler which needs to be registered for a given call back
	[out]	type	- command type
	[out]	url_name	- URL address of the domain
	[out]	post_content_buffer	- This is the response buffer.
	[out]	post_content_length	- This is the length of the response buffer.
	[out]	status	- This is the response status.

Returns

0 - Success Positive Value - Failure

References rsi_wlan_cb_non_rom_s::nwk_callbacks , rsi_nwk_callback_s::rsi_webpage_request_handler , and RSI_SUCCESS

rsi_wlan_nwk_register_wireless_fw_upgrade_cb#

int16_t rsi_wlan_nwk_register_wireless_fw_upgrade_cb (uint32_t callback_id, void(*)(uint8_t type, uint32_t status) callback_handler_ptr, type, status)

Parameters

Type	Direction	Argument Name	Description
uint32_t	[in]	callback_id	- call back number which needs to be registered
void(*)(uint8_t type, uint32_t status)	[in]	callback_handler_ptr	- call back handler which needs to be registered for a given call back
	[out]	type	- command type
	[out]	status	- This is the response status.

Returns

0 - Success Positive Value - Failure

References rsi_wlan_cb_non_rom_s::nwk_callbacks , rsi_nwk_callback_s::rsi_wireless_fw_upgrade_handler , and RSI_SUCCESS

rsi_webpage_load#

int32_t rsi_webpage_load (uint8_t flags, uint8_t * file_name, uint8_t * webpage, uint32_t length)

Load the webpage to the HTTP Server's file system that is present in the WiSeConnect module. This is a blocking API.

Parameters

Type	Direction	Argument Name	Description
uint8_t	[in]	flags	- BIT (2) is used to set the webpage that is associated with JSON object
uint8_t *	[in]	file_name	- Filename of the HTML webpage
uint8_t *	[in]	webpage	- Pointer to the HTML webpage that contains the HTML webpage content
uint32_t	[in]	length	- Webpage length

rsi_wireless_init() API needs to be called before this API.

Returns

0 - Success Negative Value - Failure -4 - Buffer not available to serve the command

Note

Refer to Error Codes section for the description of the above error codes Error Codes.

References RSI_SUCCESS , SL_PRINTF , rsi_driver_cb_s::wlan_cb , and rsi_check_and_update_cmd_state

rsi_json_object_create#

int32_t rsi_json_object_create (uint8_t flags, const char * file_name, uint8_t * json_object, uint32_t length)

Create the JSON object to the webpage that is already present in the WiSeConnect module's HTTP server file system. This is a blocking API.

Parameters

Type	Direction	Argument Name	Description
uint8_t	[in]	flags	- Reserved
const char *	[in]	file_name	- Filename of the JSON object data
uint8_t *	[in]	json_object	- Pointer to the JSON object data
uint32_t	[in]	length	- Length of the JSON object data

rsi_wireless_init() API needs to be called before this API

Returns

0 - Success Negative Value - Failure -4 - Buffer not available to serve the command

Note

Refer to Error Codes section for the description of the above error codes Error Codes.

References UNUSED_PARAMETER , RSI_SUCCESS , rsi_driver_cb_s::wlan_cb , and rsi_check_and_update_cmd_state

rsi_webpage_erase#

int32_t rsi_webpage_erase (uint8_t * file_name)

Erase the webpage from HTTP server's file system that is present in the WiSeConnect module. This is a blocking API.

Parameters

Type	Direction	Argument Name	Description
uint8_t *	[in]	file_name	- Erase particular/all loaded webpage files from the HTTP server's file system file_name - Erase a particular webpage file NULL - Erase all loaded webpage files

rsi_wireless_init() API needs to be called before this API

Returns

0 - Success Negative Value - Failure -4 - Buffer not available to serve the command

Note

Refer to Error Codes section for the description of the above error codes Error Codes.

References RSI_SUCCESS , SL_PRINTF , rsi_driver_cb_s::wlan_cb , and rsi_check_and_update_cmd_state

rsi_json_object_delete#

int32_t rsi_json_object_delete (uint8_t * file_name)

Delete the JSON object of the HTTP server's file system that is already present in the WiSeConnect module. This is a blocking API.

Parameters

Type	Direction	Argument Name	Description
uint8_t *	[in]	file_name	- Delete a particular JSON object that is already created in the HTTP server's file system

rsi_wireless_init() API needs to be called before this API.

Returns

0 - Success Negative Value - Failure -4 - Buffer not available to serve the command

Note

Refer to Error Codes section for the description of the above error codes Error Codes.

References RSI_SUCCESS , SL_PRINTF , rsi_driver_cb_s::wlan_cb , and rsi_check_and_update_cmd_state

rsi_webpage_send#

int32_t rsi_webpage_send (uint8_t flags, uint8_t * webpage, uint32_t length)

Send the webpage to HTTP server's file system. This is a blocking API.

Parameters

Type	Direction	Argument Name	Description
uint8_t	[in]	flags	- Reserved
uint8_t *	[in]	webpage	- Pointer to the HTML webpage that contains the HTML webpage content
uint32_t	[in]	length	- Webpage length

rsi_wlan_connect() API needs to be called before this API.

Returns

0 - Success Negative Value - Failure -4 - Buffer not available to serve the command

Note

Refer to Error Codes section for the description of the above error codes Error Codes.

References UNUSED_PARAMETER , RSI_SUCCESS , SL_PRINTF , rsi_driver_cb_s::wlan_cb , rsi_wlan_cb_s::state , and rsi_check_and_update_cmd_state