Differences

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

--- en:iot-open:practical:hardware:sut:stm32:iot_1 [2024/04/25 23:19] – [Prerequisites] ktokarz
+++ en:iot-open:practical:hardware:sut:stm32:iot_1 [2024/04/27 11:15] (current) – [Result validation] ktokarz
@@ Line 1: / Line 1: @@
+====== STM_IoT_1: Reading MAC address of the WiFi =====
+Each network card is supposed to have a unique physical address called a MAC address. MAC abbreviation stands for Medium Access Control protocol, which provides access to the physical link in the network layer. The STM32WB55 SoC doesn't have a WiFi network controller so our STM laboratory stands have the WiFi module based on ESP32-C3 SoC connected by serial port additional ESP32-C3 module and controlled with AT commands. To learn how to use these commands please refer to the STM_IoT_Intro chapter.
+\\
+ESP32 chip has built-in MAC. MAC can be used to identify devices, but note that it is not a "strong" ID: it can be programmatically changed and easily discovered. In the following scenario, we present how to read and display the MAC address on 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 ====
+Present a MAC address on the selected display. The steps below present the reading part and display it on LCD. This display has 16 characters per line, but the commonly used format for MAC addresses requires 17 characters. For seeing the full MAC address modify the example and use the display other than LCD.
+<note>
+The MAC addresses usually are expressed as six hexadecimal numbers separated by colons eg. "84:fc:e6:88:69:d5".
+</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 ===
+Include the LCD library in your source code:
+<code c>
+#include "LiquidCrystal.h"
+</code>
+Create objects of the LCD and Hardware Serial classes:
+<code c>
+// Serial port class and configuration (Constructor uses STM port numbering)
+HardwareSerial WiFiSerial(RxD_PIN, TxD_PIN, NC, NC);
+// LCD class
+const int rs = PC5, en = PB11, d4 = PB12, d5 = PB13, d6 = PB14, d7 = PB15;
+LiquidCrystal lcd(rs, en, d4, d5, d6, d7);
+</code>
+Declare two variables with the strings to be compared with the responses from the WiFi module.
+<code c>
+String compOK;
+String compERROR;
+</code>
+=== Step 2 ===
+In the Setup() function initialise the serial port, display, and strings.
+<code c>
+WiFiSerial.begin(115200);
+lcd.begin(16, 2);
+compOK = "OK";
+compERROR = "ERROR";
+</code>
+We will use the code template from [[en:iot-open:practical:hardware:sut:stm32:IoT_AT]] to communicate with the WiFi module. The first command we will send "AT" to confirm that everything works properly:
+<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>
+The next command can be the "AT+CIPSTAMAC?" which returns the MAC address in the response message which looks like this:
+<code c>
++CIPSTAMAC:"84:fc:e6:88:63:d1"
+</code>
+We can implement the part of displaying the MAC by repeating the block of the code similar to the one presented above with two modifications. Change the "AT" command, and add inside the code the following lines:
+<code c>
+if (response.startsWith("+CIPSTAMAC")) {
+  response.remove(0,12);
+  lcd.setCursor(0,0);
+  lcd.print(response);
+}
+</code>
+==== Result validation ====
+You should be able to see the MAC address of the ESP32-C3 module.
+<note>
+Using another node should change the MAC read. Book another device and discover its MAC.
+</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 MAC?**: Actually, yes, you can. 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>