Differences

This shows you the differences between two versions of the page.

--- en:iot-open:practical:hardware:sut:stm32:iot_2 [2024/04/26 13:23] – [STM_IoT_2: Connecting to the WiFi Access Point and presenting IP] ktokarz
+++ en:iot-open:practical:hardware:sut:stm32:iot_2 [2024/04/27 11:15] (current) – [Result validation] ktokarz
@@ Line 1: / Line 1: @@
+====== STM_IoT_2: Connecting to the WiFi Access Point and presenting IP =====
+Each computer connected to the Internet is identified with the IP address. IP abbreviation stands for Internet Protocol, which is responsible for transmitting data packets between computers in the whole global web - the Internet. The same mechanism is used for addressing and transmitting packets among IP-capable IoT devices. The most popular local networks which support IP addressing are Ethernet and WiFi. Currently, the transition from traditional IPv4 to the new IPv6 version is occurring. Our laboratory supports IPv4.
+\\
+The STM32WB55 SoC doesn't have Ethernet or WiFi network controller so our STM laboratory stands have the WiFi module based on ESP32-C3 SoC. It is connected by a serial port and controlled with AT commands. To learn how to use these commands please refer to the STM_IoT_Intro chapter.
+\\
+ESP32 chip gets the IP address from the DHCP server after establishing the connection with the WiFi access point. In this scenario, we present how to connect to a WiFi network and read and display the IP address on an LCD. Displaying on other display than LCD is up to the developer. You can refer to the appropriate scenario, as listed below.
+===== Prerequisites =====
+To implement this scenario, it is necessary to get familiar with at least one of the following scenarios first:
+  * [[en:iot-open:practical:hardware:sut:stm32:IoT_AT]],
+  * [[en:iot-open:practical:hardware:sut:stm32:emb5_1|]],
+  * [[en:iot-open:practical:hardware:sut:stm32:emb6_1|]],
+  * [[en:iot-open:practical:hardware:sut:stm32:emb7_1|]].
+===== Suggested Readings and Knowledge Resources =====
+  * [[en:iot-open:introductiontoembeddedprogramming2:cppfundamentals]],
+  * [[en:iot-open:hardware2:stm32|]],
+  * [[en:iot-open:hardware2:esp32|]],
+  * [[en:iot-open:practical:hardware:sut:stm32|]],
+  * [[en:iot-open:iotprogramming2:espressif_networking|]].
+===== Hands-on Lab Scenario =====
+==== Task to be implemented ====
+Join the WiFi network. Present an IP address on the selected display. The commonly used format for IPv4 addresses requires 15 characters, so LCD having 16 characters is sufficient to present the address. The steps below show the starting part of the software. How to implement the full software please refer to the previous scenarios:
+  * [[en:iot-open:practical:hardware:sut:stm32:IoT_AT]]
+  * [[en:iot-open:practical:hardware:sut:stm32:IoT_1]]
+<note>
+The IPv4 addresses are usually expressed as four decimal numbers ranging from 0 to 255 separated by dots eg. "192.168.1.100".
+</note>
+==== Start ====
+Check if you can see a full LCD in your video stream. Book a device and create a dummy Arduino file with ''void setup()...'' and ''void loop()...''.
+==== Steps ====
+=== Step 1 ===
+The beginning of the code is the same as in the previous scenario, so make a copy of it:
+  * [[en:iot-open:practical:hardware:sut:stm32:IoT_1]]
+We will use the code template from [[en:iot-open:practical:hardware:sut:stm32:IoT_AT]] repeated for every AT command.
+<code c>
+WiFiSerial.println("AT");
+lcd.setCursor(0,0);
+lcd.print("AT              ");
+do {
+  response = WiFiSerial.readStringUntil(0x0A);
+  lcd.setCursor(0,1);
+  lcd.print(response);
+} while (!(response.startsWith(compOK)));
+delay(1000);
+</code>
+=== Step 2 ===
+The procedure of connecting to the WiFi requires some steps. Below we present the AT commands only, your task is to implement the full code which sends the command and waits for the response for each command.
+<code c>
+// Test if module is available
+"AT"
+// Reset the module
+"AT+RST"
+// Prevent from storing the WiFi join parameters in non-volatile memory
+"AT+SYSSTORE=0"
+// Start module in station mode (which can join the access point)
+"AT+CWMODE=1"
+// Join the access point. Use SSID and password.
+"AT+CWJAP=\"SSID\",\"password\""
+// Get the IP address
+"AT+CIPSTA?"
+</code>
+<note>
+Texts sent as part of the message are delimited with double quotation marks. In C++ we need to mark them with backslash characters inside the string constants. Examples above include these markings.
+</note>
+Some explanation can be needed for the "AT+RST" and "AT+SYSSTORE=0" commands.
+If we don't use the "AT+SYSSTORE=0" command our module stores the WiFi credentials in non-volatile memory and automatically connects to the network after powering on. In our laboratory, it is not recommended because the next commands can return "ERROR" if we try to connect the network and MQTT broker if we are already connected.
+If we don't use the "AT+RST" command our module will keep the WiFi connection active, even if we upload the new version of the software. It would result in the same error in the case of WiFi or MQTT reconnecting.
+=== Step 3 ===
+The command for receiving the IP address is "AT+CIPSTA?". It returns in the response message the IP address, IP address of the gateway and IP address mask:
+<code c>
++CIPSTA:ip:"192.168.1.117"
++CIPSTA:gateway:"192.168.1.1"
++CIPSTA:netmask:"255.255.255.0"
+</code>
+While LCD use we have to filter out unwanted elements of the response. We can do it by displaying the answer containing "+CIPSTA:IP:" only removing the first 12 characters. Look into the following code:
+<code c>
+if (response.startsWith("+CIPSTA:ip:")){
+  response.remove(0,12);
+  lcd.setCursor(0,0);
+  lcd.print(response);
+}
+</code>
+==== Result validation ====
+You should be able to see the IP address of the ESP32-C3 module.
+<note>
+Using another node ar even the same node another time can change the IP read. You can book another device and discover its IP.
+</note>
+<note info>
+Because LCD can't properly display some non-visible characters the presented code sometimes shows additional, non-letter characters. It is out of the scope of this scenario to filter these characters out. We leave the task of making visual improvements to your invention.
+</note>
+===== FAQ =====
+**Can I change the IP address?**: Normally IP addresses are assigned by the server known as DHCP. In some situations, you can use static IP assigned manually in the station. It is not advised, however, because you may accidentally generate an overlapping address that will collide with another device in the same network.
+<WRAP noprint>
+===== Project information =====
+{{:en:iot-open:logo_iot_200_px.png?200|}}\\
+This Intellectual Output was implemented under the Erasmus+ KA2.\\
+Project IOT-OPEN.EU Reloaded – Education-based strengthening of the European universities, companies and labour force in the global IoT market.\\
+Project number: 2022-1-PL01-KA220-HED-000085090.
+**__Erasmus+ Disclaimer__**\\
+This project has been funded with support from the European Commission. \\
+This publication reflects the views of only the author, and the Commission cannot be held responsible for any use that may be made of the information contained therein.
+**__Copyright Notice__**\\
+This content was created by the IOT-OPEN.EU Reloaded consortium, 2022,2024.\\
+The content is Copyrighted and distributed under CC BY-NC [[https://en.wikipedia.org/wiki/Creative_Commons_license|Creative Commons Licence]], free for Non-Commercial use.
+<figure label>
+{{:en:iot-open:ccbync.png?100|}}
+</figure>
+</WRAP>