dialog DA16200 Wi-Fi Connection Notification

Abstract
This document describes how to use the Wi-Fi connection notification function of the DA16200.

Terms and Definitions

MCU  Microcontroller Unit

References

[1] DA16200, SDK Programmer Guide, Dialog Semiconductor

Introduction

This document describes how to implement Wi-Fi Connection Notification in the customer’s program in the DA16200.

The DA16200 SDK provides the Wi-Fi connection status notification function when running STA mode. Using this function, customers/developer can implement their own operation to let MCU or other hardwired devices know the notified Wi-Fi connection status.

How to Create New F/W with Wi-Fi Notification Function

The DA16200 SDK provides a Wi-Fi connection status notification function as a compiled feature.
~/SDK/apps/da16200/get_started/inc/config_generic_sdk.h #undef __SUPPORT_WIFI_CONN_CB__

The customer or developer can change the compiled feature mentioned above to

define in order to create a new F/W.

Also, users should implement their own operations. For example, sending a specified event or data to the MCU or other hardwired device by using the defined protocol.
The released generic DA16200 SDK only shows a notification message on the console terminal.

Sequence for Wi-Fi Connection Status Notification

The DA16200 Wi-Fi connection status notification function runs as a library and the customer or developer needs to add their own code to send the result to the MCU or another hardwired device.
To use this function, the DA16200 SDK should include all source codes as shown in the following sequences.

• Register call-back functions to use this feature
  ~/SDK/apps/da16200/get_started/src/system_start.c

• Create a mutex-sema flags to prevent simultaneous access and register connect/disconnect callback function
  ~/SDK/core/common/main/util_api.c

• Wi-Fi connection function
  When Wi-Fi is connected, this function sends the notification “wifi_conn_flag = TRUE” and the Customer/Developer can use this flag for their function.

• Wi-Fi connection-fail function
  When Wi-Fi is connected, this function sends the notification “wifi_conn_fail_flag = TRUE” and the Customer/Developer can use this flag for their function.

• Wi-Fi disconnection function
  When Wi-Fi is disconnected, this function notifies “wifi_disconn_flag = TRUE” and sends the reason_code “wifi_disconn_reason”.
  These flag and reason_code are checked and used in the customer/developer function.

NOTE: No other changes should be made to the sequences and functions listed in the above Section 5 Sequence for Wi-Fi Connection Status Notification.

User Function for Wi-Fi Connection Status

For the Wi-Fi connection status notification function, customers/developer should add their own operation in the DA16200 SDK before creating a new image.
In the DA16200 SDK, the customer/developer Wi-Fi connection status notification operation to MCU or hardwired device is created as independent threads to avoid affecting the basic Wi-Fi module operation.
~/SDK/apps/da16200/get_started/src/user_apps.c

NOTE: No other changes should be made to the above two thread creation items in user_apps_table except for the stack_size and the thread running priority.

• Wi-Fi connection status function:
  ~/SDK/apps/da16200/get_started/user_apps.c
  In the provided source code, the customer/developer should only change the Event/Data TX part to send a notification to MCU or hardwired device. Don’t clear the flag or change the mutex handling.

• Wi-Fi connection-fail status function:
  ~/SDK/apps/da16200/get_started/user_apps.c
  In the provided source code, the customer/developer should only change the Event/Data TX part to send a notification to MCU or hardwired device. Don’t clear the flag or change the mutex handling.

• Wi-Fi connection-fail status function:
  ~/SDK/apps/da16200/get_started/user_apps.c
  In the provided source code, the customer/developer should only change the Event/Data TX part to send a notification to MCU or hardwired device. Don’t clear the flag or change the mutex handling.

Revision History

SDK source path, Figures, ETC modified by SDK folder structure change

1.0| 02-Sep-2020| Initial version.

Status Definitions

approval, which may result in modifications or additions.
APPROVED or unmarked| The content of this document has been approved for publication.

Disclaimer

Unless otherwise agreed in writing, the Dialog Semiconductor products (and any associated software) referred to in this document are not designed, authorized or warranted to be suitable for use in life support, life-critical or safety- critical systems or equipment, nor in applications where failure or malfunction of a Dialog Semiconductor product (or associated software) can reasonably be expected to result in personal injury, death or severe property or environmental damage. Dialog Semiconductor and its suppliers accept no liability for the inclusion and/or use of Dialog Semiconductor products (and any associated software) in such equipment or applications and therefore such inclusion and/or use is at the customer’s own risk.
Information in this document is believed to be accurate and reliable. However, Dialog Semiconductor does not give any representations or warranties, express or implied, as to the accuracy or completeness of such information. Dialog Semiconductor furthermore takes no responsibility whatsoever for the content in this document if provided by any information source outside of Dialog Semiconductor.

Dialog Semiconductor reserves the right to change without notice the information published in this document, including, without limitation, the specification and the design of the related semiconductor products, software and applications. Notwithstanding the foregoing, for any automotive-grade version of the device, Dialog Semiconductor reserves the right to change the information published in this document, including, without limitation, the specification and the design of the related semiconductor products, software, and applications, in accordance with its standard automotive change notification process.

Applications, software, and semiconductor products described in this document are for illustrative purposes only. Dialog Semiconductor makes no representation or warranty that such applications, software, and semiconductor products will be suitable for the specified use without further testing or modification. Unless otherwise agreed in writing, such testing or modification is the sole responsibility of the customer and Dialog Semiconductor excludes all liability in this respect.

Nothing in this document may be construed as a license for customers to use the Dialog Semiconductor products, software and applications referred to in this document. Such license must be separately sought by a customer with Dialog Semiconductor.

All use of Dialog Semiconductor products, software, and applications referred to in this document is subject to Dialog Semiconductor’s Standard Terms and Conditions of Sale, available on the company website (www.dialogsemiconductor.com) unless otherwise stated.

Dialog, Dialog Semiconductor, and the Dialog logo are trademarks of Dialog Semiconductor Plc or its subsidiaries. All other product or service names and marks are the property of their respective owners.

© 2021 Dialog Semiconductor. All rights reserved.
RoHS Compliance

Dialog Semiconductor’s suppliers certify that its products are in compliance with the requirements of Directive 2011/65/EU of the European Parliament on the restriction of the use of certain hazardous substances in electrical and electronic equipment. RoHS certificates from our suppliers are available on request.

Contacting Dialog Semiconductor

United Kingdom (Headquarters) Dialog Semiconductor (UK) LTD Phone: +44 1793 757700
Germany
Dialog Semiconductor GmbH Phone: +49 7021 805-0
The Netherlands
Dialog Semiconductor B.V. Phone: +31 73 640 8822
Email:
[email protected]

North America
Dialog Semiconductor Inc. Phone: +1 408 845 8500
Japan
Dialog Semiconductor K. K. Phone: +81 3 5769 5100
Taiwan
Dialog Semiconductor Taiwan Phone: +886 281 786 222
Web site:
www.dialog-semiconductor.com

Hong Kong
Dialog Semiconductor Hong Kong Phone: +852 2607 4271
Korea
Dialog Semiconductor Korea Phone: +82 2 3469 8200

China (Shenzhen)
Dialog Semiconductor China Phone: +86 755 2981 3669
China (Shanghai)
Dialog Semiconductor China Phone: +86 21 5424 9058

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>