View source for Component: WLAN (ESP-12S) (Wireless)



{| width="50%"
|-
| width="20%" style="color: gray;" | Author
| Matrix Ltd.
|-
| width="20%" style="color: gray;" | Version
| 2.1 (Release)
|-
| width="20%" style="color: gray;" | Category
| Wireless
|}



==[[File:Component Icon 66990164_3c50_4960_916d_327737a7a093.png|Image]] WLAN (ESP-12S) component==
Wireless LAN component designed to work with the ESP-12S module.
Provides a very simple interface to allow webpages to be hosted from hardware or simulation.
Also available in the form of the BL0136 WIFI E-block.

==Examples==

The examples below are all done using a EB091 board as the host

The EB069 ESP8266 Wifi E-block is connected to PORTD 0-7 with the patch setting set to B.

The EB005 LCD E-block is connected to PORTB 0-7 with the patch setting set to Default.

Other host boards are compatible with the examples, simply change the target chip and component connection properties.



===Firmware Test===

This example collects the firmware version from the ESP8266 module and displays it on an LCD. Tested working with firmware version 00150900.

{{Fcfile|ESP8266_FirmwareTest.fcfx|FirmwareTest}}


===Wireless Scanner===

This example scans for wireless networks in range and prints the network IDs to the LCD along with the signal strength and security type.

{{Fcfile|ESP8266_WifiScan.fcfx|WifiScan}}


===Creating An Access Point===

This example creates an access point you can connect your phone or laptop to named Flowcode_ESP8266. The password to connect to the access point is flowcode6.

Note this example simply creates an access point, no data is transferred.

{{Fcfile|ESP8266_CreateAP.fcfx|CreateAP}}


===Joining An Access Point===

This example joins an existing access point. The network ID and Password must be altered to match your local WIFI network settings.

Note this example simply joins an access point, no data is transferred.

{{Fcfile|ESP8266_JoinAP.fcfx|JoinAP}}


===TCP Client===

This example joins an existing access point. The network ID and Password must be altered to match your local WIFI network settings.

Once joined to the network the example connects to the MatrixTSL website and requests a file which is printed out on the LCD.

{{Fcfile|ESP8266_TCPClient.fcfx|TCPClient}}


===TCP Server===

This example creates an access point you can connect your phone or laptop to named Flowcode_ESP8266. The password to connect to the access point is flowcode6.

Once the access point is created the example shows the server IP address on the LCD. 
Connecting to the wireless network on your phone or laptop and visiting the IP address shown on the LCD using a web browser allows you to switch LED outputs on and off.

{{Fcfile|ESP8266_TCPServer.fcfx|TCPServer}}


===Network Comms===

Here are some examples using the Network Communication component linked to the ESP8266 component.

{{Fcfile|NetworkComms-ESP8266-Client.fcfx|NetworkComms ESP8266 Client}}

{{Fcfile|NetworkComms-ESP8266-Server.fcfx|NetworkComms ESP8266 Webserver}}

==Downloadable macro reference==

===<span style="font-weight: normal;"><u><tt>DisconnectFromSSID</tt></u></span>===
Disconnects from the current SSID. 

Returns 1 if the command was accepted and returned an "OK"

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>SendString</tt></u></span>===
Sends the given Text. 

Appends a CR to the end of the string it SendCR is greater than 0.

'''Parameters'''

:[[Variable Types|<- STRING]] ''Text''
::''This parameter may be returned back to the caller''

:[[Variable Types|BYTE]] ''SendCR''


'''Return value'''

:''This call does not return a value''


===<span style="font-weight: normal;"><u><tt>ClientConnect</tt></u></span>===
Creates a TCP or UDP connection to a remote server.

Returns the state of the connection.

0=Connection failed

1=Connection active

'''Parameters'''

:[[Variable Types|BYTE]] ''Type''
::0 = TCP, 1 = UDP

:[[Variable Types|<- STRING]] ''IPAddress''
::e.g. "192.168.1.20"
::''This parameter may be returned back to the caller''

:[[Variable Types|UINT]] ''Port''
::Remote port number to connect to, HTTP comms = Port 80


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>ControlTCPServer</tt></u></span>===
Allows a TCP web page server to be switched on and off on the selected port.

Returns 1 if the command was completed correctly.

'''Parameters'''

:[[Variable Types|BYTE]] ''Enable''
::0 = Stop Server, 1 = Start Server

:[[Variable Types|UINT]] ''Port''
::Server port to listen for incoming TCP/IP data requests


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>GetFirmwareVersion</tt></u></span>===
Collects the firmware version from the ESP8266 module and returns it as a string.

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:[[Variable Types|STRING]]


===<span style="font-weight: normal;"><u><tt>CheckForPageRequests</tt></u></span>===
To be called periodically. Returns non-zero if a request has been processed

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>ClientSendRequest</tt></u></span>===
Sends out a request for data

'''Parameters'''

:[[Variable Types|<- STRING]] ''Request''
::e.g. "GET / HTTP/1.0\r\n\r\n"
::''This parameter may be returned back to the caller''


'''Return value'''

:''This call does not return a value''


===<span style="font-weight: normal;"><u><tt>ReadSSIDFromScan</tt></u></span>===
Collects one of the SSID name strings from the last SSID Scan.

The ScanForSSID macro must be called first.

'''Parameters'''

:[[Variable Types|BYTE]] ''Index''
::SSID Index


'''Return value'''

:[[Variable Types|STRING]]


===<span style="font-weight: normal;"><u><tt>CreateAccessPoint</tt></u></span>===
Sets up the wireless LAN module into AP mode to host a wireless network.

Other WIFI enabled devices can then connect to the module.

Returns 1 for success.

'''Parameters'''

:[[Variable Types|<- STRING]] ''SSID''
::Name of the wireless network to create
::''This parameter may be returned back to the caller''

:[[Variable Types|<- STRING]] ''Password''
::Password used to gain access to the network
::''This parameter may be returned back to the caller''

:[[Variable Types|BYTE]] ''Channel''
::802.11 Channel Range 1-14

:[[Variable Types|BYTE]] ''Encryption''
::0=Open, 1=WEP, 2=WPA_PSK, 3=WPA2_PSK, 4=WPA_WPA2_PSK


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>SetOutValue</tt></u></span>===
Set the value of an outbound substitution string

'''Parameters'''

:[[Variable Types|BYTE]] ''index''
::Range 0-4

:[[Variable Types|<- STRING]] ''value''
::''This parameter may be returned back to the caller''


'''Return value'''

:''This call does not return a value''


===<span style="font-weight: normal;"><u><tt>ReadSignalStrengthFromScan</tt></u></span>===
Collects the signal strength from the last SSID Scan.

The ScanForSSID macro must be called first.

Value returned is in negative dB, smaller value = better signal

'''Parameters'''

:[[Variable Types|BYTE]] ''Index''
::SSID Index


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>ReadEncryptionModeFromScan</tt></u></span>===
Collects one of the encryption modes from the last SSID Scan.

The ScanForSSID macro must be called first.

0=Open, 1=WEP, 2=WPA_PSK, 3=WPA2_PSK, 4=WPA_WPA2_PSK

'''Parameters'''

:[[Variable Types|BYTE]] ''Index''
::SSID Index


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>GetByteWithTimeout</tt></u></span>===
Attempts to receive a byte from the circular buffer.

If nothing is available then waits up to 20 ms for data to become available.

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>GetInValue</tt></u></span>===
Returns the string value of a Request parameter

'''Parameters'''

:[[Variable Types|BYTE]] ''index''
::Index of the request paramter, starting at zero Range 0-2


'''Return value'''

:[[Variable Types|STRING]]


===<span style="font-weight: normal;"><u><tt>ConnectToSSID</tt></u></span>===
Attempts to connect to the given SSID and Key values. 

Returns 1 if the SSID has been connected.

'''Parameters'''

:[[Variable Types|<- STRING]] ''SSID''
::''This parameter may be returned back to the caller''

:[[Variable Types|<- STRING]] ''Key''
::''This parameter may be returned back to the caller''

:[[Variable Types|BYTE]] ''Timeout''
::Number of seconds to wait for the connection, default 2


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>ScanForSSID</tt></u></span>===
Checks for wireless networks in the local area which are broadcasting their SSID.

Must not be connected to a network to allow this to function.

Returns the number of wireless networks found, max 8.

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>Initialise</tt></u></span>===
Initialise the device with the property data.

Returns 1 if "ready" message successfully received 

Returns 0 if no reply from module

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:[[Variable Types|BYTE]]


===<span style="font-weight: normal;"><u><tt>CheckTCPServerIP</tt></u></span>===
Collects the local IP address of the active TCP server.

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:[[Variable Types|STRING]]



==Simulation macro reference==

''This component does not contain any simulation macros''


==Property reference==
<span style="font-weight: normal;"><u>Receive Buffer Size</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''RxBufferSize''.

Buffer used to store incoming data ready for processing.

Default 128 Bytes.

<span style="font-weight: normal;"><u>Scan Buffer Size</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''ScanBufferSize''.

Buffer used to hold SSID names when performing a SSID network scan.

Default 100 Bytes.

<span style="font-weight: normal;"><u>Reset Mode</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''ResetMode''.

The initialise automatically resets the WIFI module before establishing communications.

Software reset uses an AT command to preform the reset

Hardware reset uses an extra I/O pin to toggle the signal to the reset pin on the module.

<span style="font-weight: normal;"><u>Command Termination</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''Termination''.

Older versions of the firmware require \r to terminate a AT command string.

Newer versions of the firmware have changed to use \r\n termination.

<span style="font-weight: normal;"><u>Channel</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''group1::cal_uart1::CHANNEL''.

UART Channel selector

Software channels are bit banged using generic I/O pins but are not as reliable as hardware channels.

Hardware channels use the selected peripheral on-board the target microcontroller.

<span style="font-weight: normal;"><u>Baud Options</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''group1::cal_uart1::BAUD_LIST''.

Baud rate option selector

<span style="font-weight: normal;"><u>Baud Rate</u></span>

This property is of type ''Signed integer'' and can be referenced with the variable name ''group1::cal_uart1::BAUD''.

''<span style="color:red;">No additional information</span>''



<span style="font-weight: normal;"><u>TX</u></span>

This property is of type ''Single digital pin'' and can be referenced with the variable name ''group1::cal_uart1::TX''.

Pin to be used for Transmit data

<span style="font-weight: normal;"><u>TX Remap Pin</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''group1::cal_uart1::OutputPins''.

Allows the hardware transmit pin to be configured from a list of available pins based on your target device,

<span style="font-weight: normal;"><u>RX</u></span>

This property is of type ''Single digital pin'' and can be referenced with the variable name ''group1::cal_uart1::RX''.

Pin to be used for Receive data

<span style="font-weight: normal;"><u>RX Remap Pin</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''group1::cal_uart1::InputPins''.

Allows the hardware receive pin to be configured from a list of available pins based on your target device,

<span style="font-weight: normal;"><u>Reset</u></span>

This property is of type ''Single digital pin'' and can be referenced with the variable name ''RESET''.

WLAN module reset pin connection

<span style="font-weight: normal;"><u>Use Flow Control</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''group1::cal_uart1::FLOWEN''.

Flow Control (Handshake) enable or disable.

    On: Two I/O pins are used to control the flow of data in and out of the device.

    Off: Flow control is disabled.

<span style="font-weight: normal;"><u>Max Web Pages</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''PAGES''.

Maximum number of individual webpages we can serve up with the component.

<span style="font-weight: normal;"><u>Web Page Timeout</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''TIMEOUT''.

Number of cycles to try and send / receive a webpage before timing out.

<span style="font-weight: normal;"><u>Line Delay</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''LineDelay''.

Fixed delay in microseconds sent in between sending a HTML line when running as a web page server.

<span style="font-weight: normal;"><u>Name Page 1</u></span>

This property is of type ''Line of text'' and can be referenced with the variable name ''name1''.

HTML name of webpage 1

<span style="font-weight: normal;"><u>HTML Page 1</u></span>

This property is of type ''Multiple lines of text'' and can be referenced with the variable name ''html1''.

HTML content for webpage 1

<span style="font-weight: normal;"><u>Name Page 2</u></span>

This property is of type ''Line of text'' and can be referenced with the variable name ''name2''.

HTML name of webpage 2

<span style="font-weight: normal;"><u>HTML Page 2</u></span>

This property is of type ''Multiple lines of text'' and can be referenced with the variable name ''html2''.

HTML content for webpage 2

<span style="font-weight: normal;"><u>Name Page 3</u></span>

This property is of type ''Line of text'' and can be referenced with the variable name ''name3''.

HTML name of webpage 3

<span style="font-weight: normal;"><u>HTML Page 3</u></span>

This property is of type ''Multiple lines of text'' and can be referenced with the variable name ''html3''.

HTML content for webpage 3

<span style="font-weight: normal;"><u>Name Page 4</u></span>

This property is of type ''Line of text'' and can be referenced with the variable name ''name4''.

HTML name of webpage 4

<span style="font-weight: normal;"><u>HTML Page 4</u></span>

This property is of type ''Multiple lines of text'' and can be referenced with the variable name ''html4''.

HTML content for webpage 4

<span style="font-weight: normal;"><u>Count</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''Outgoing_Count''.

Maximum number of outbound string substitutions

<span style="font-weight: normal;"><u>Length 0</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''Out_Len_0''.

Number of bytes to reserve for data string.

<span style="font-weight: normal;"><u>Count</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''Incoming_Count''.

Maximum number of inbound string substitutions

<span style="font-weight: normal;"><u>Length 0</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''In_Len_0''.

Number of bytes to reserve for data string.

<span style="font-weight: normal;"><u>Label</u></span>

This property is of type ''Line of text'' and can be referenced with the variable name ''label''.

Text label used to help identify the component on the panel.

<span style="font-weight: normal;"><u>Simulation Method</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''SimMethod''.

Decides how to handle the simulation of the component.

TCP Base - Allows simulation of the network communications using the TCP Base component and DLL.

COM/Injector - Allows the simulation to connect to real hardware or injectors.

<span style="font-weight: normal;"><u>Scope Traces</u></span>

This property is of type ''True or false'' and can be referenced with the variable name ''group1::cal_uart1::ScopeTraces''.

Selects if the scope traces are automatically added to the data recorder window or not.

    Simulation - draws an approximation of the UART data onto the scope trace.

    ICT - sets up the scope trace for incoming data and adds UART packet decoding at the correct BAUD.

<span style="font-weight: normal;"><u>Console Data</u></span>

This property is of type ''True or false'' and can be referenced with the variable name ''group1::cal_uart1::ConsoleData''.

Selects if the console data is automatically generated or not

<span style="font-weight: normal;"><u>Console Columns</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''group1::cal_uart1::ConsoleColumns''.

Number of characters that can be displayed on a single line of the console.

<span style="font-weight: normal;"><u>Data Source</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''group1::cal_uart1::DataSource''.

Simulation data source used to allow the component to connect to various remote devices

    Nothing - Simulation data is ignored

    COM port - Routes the communication data to and from a physical or virtual COM port 

    Injector - Routes the communication data via a data injector component on the Panel.