Show page

Differences

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

--- iothings:laboratoare:2022:lab9 [2023/01/13 11:31]
dan.tudose [Run as sudo]
+++ iothings:laboratoare:2022:lab9 [2023/11/20 15:50] (current)
dan.tudose
@@ Line 1: / Line 1: @@
-====== Lab 9. NuttX OS ======
+====== Lab 9. HTTPS and SSL/TLS ======
-In this laboratory you will learn how to build and upload the NuttX OS on your ESP32 Sparrow boards. They use the WROVER modules, so we'll need to specify this when we build the OS binaries.
-===== Linux set-up tutorial =====
-==== Environment ====
-=== Native Linux machine ===
-You can go ahead to section [Run as sudo].
-=== Windows setup ===
-If running on Windows, you must configure a Linux virtual machine through which to access the USB ports of the host. For this you can use the [[ https://repository.grid.pub.ro/cs/so/linux-2021/so-ubuntu-20-04.ova | SO virtual machine]] - a light Ubuntu 20.04 image that comes only with a CLI - or download the latest official image of any other Linux distributions.
-If available to you, you can use the [[https://vmware.pub.ro/ | VMware Workstation 16 pro]] which is the easiest to configure - just don't forget to add the USB controller to the VM.
-If you do not have access to VMWare, please download VirtualBox. In order to ssh to your virtual machine, please do the following steps:
-  * add a second network adapter to the VM. The first must be a host-only device in order to provide connectivity from host to guest, while the second will be under NAT and will provide Internet acces.
-  * boot the virtual machine. Test with **ping 8.8.8.8** that you have Internet connectivity
-  * add a static IP address on the second interface in the **192.168.56.0/56** subnetwork. For mine I used **192.168.56.56/24**.
-To connect the USB device to the VM instead of the host, head to the upper bar and select //Devices > USB Devices > the UART controller// .
-Currently, the WSL subsystem does not provide native support for USB devices and you must use an open-source tool. Please refer to [[https://learn.microsoft.com/en-us/windows/wsl/connect-usb | this ]] for further details.
-==== Run as sudo ====
-Running as non-root will require a few extra commands for configuration.
-Refer to [[https://blog.espressif.com/getting-started-with-esp32-and-nuttx-fd3e1a3d182c | this]] if you decide to continue as non-root.
-Follow the steps below in order to get your Linux machine properly configured:
-  * install the package dependencies
-  * download the toolchain, since we won't be able to compile with the standard gcc compiler
-  * clone the repositories: nuttx, nuttx-apps
-  * download the prebuilt partition table and bootloader. Alternatively, you can compile your own binaries but this tutorial does not cover it.
-  * compile the NuttX binary
-  * finally, flash the board
-== Install dependencies ==
-<code>
-apt-get update
-apt-get upgrade -y
-apt-get install -y bison flex gettext texinfo libncurses5-dev libncursesw5-dev gperf automake libtool pkg-config build-essential gperf genromfs libgmp-dev libmpc-dev libmpfr-dev libisl-dev binutils-dev libelf-dev libexpat-dev gcc-multilib g++-multilib picocom u-boot-tools util-linux chrony libusb-dev libusb-1.0.0-dev kconfig-frontends python3-pip
-</code>
-== Download the toolchain ==
-<code>
-curl https://dl.espressif.com/dl/xtensa-esp32-elf-gcc8_2_0-esp-2020r2-linux-amd64.tar.gz | tar -xz
-mkdir /opt/xtensa
-mv xtensa-esp32-elf/ /opt/xtensa/
-echo "export PATH=\$PATH:/opt/xtensa/xtensa-esp32-elf/bin" >> ~/.bashrc
-source ~/.bashrc
-</code>
-== Clone the repositories ==
-<code>
-mkdir ~/nuttxspace && cd ~/nuttxspace
-git clone https://github.com/apache/incubator-nuttx.git nuttx
-git clone https://github.com/apache/incubator-nuttx-apps.git apps
-</code>
-== Download the prebuilt bootloader and partition table ==
-<code>
-mkdir esp-bins
-curl -L "https://github.com/espressif/esp-nuttx-bootloader/releases/download/latest/bootloader-esp32.bin" -o esp-bins/bootloader-esp32.bin
-curl -L "https://github.com/espressif/esp-nuttx-bootloader/releases/download/latest/partition-table-esp32.bin" -o esp-bins/partition-table-esp32.bin
-</code>
-== Compile and run ==
-While this step is not necessary for the ESP32 Sparrow boards, please be aware that if you're compiling for a different hardware board, depending on the board version, you might be required to press down the `BOOT` button when flashing the memory - this puts the board in a download state instead of the default boot state. The button must be pressed down only when the connection is being established, as depicted below:
-{{ :iothings:laboratoare:2022:nuttx_download_mode.png |}}
-<code>
-pip3 install esptool
-pip3 install pyserial
-cd ~/nuttxspace/nuttx
-./tools/configure.sh esp32-wrover-kit:nsh
-</code>
-The last line is specific to boards containing the WROVER module, such as the ESP32 Sparrow boards we use in the lab. Please note that if you're compiling for another hardware target, such as one containing the more popular WROOM modules, the last line needs to be changed to reflect that, e.g. //./tools/configure.sh esp32-devkitc:nsh//
-<code>
-make -j4
-esptool.py erase_flash
-make flash ESPTOOL_PORT=/dev/ttyUSB0 ESPTOOL_BAUD=115200 ESPTOOL_BINDIR=../esp-bins
-picocom /dev/ttyUSB0 -b 115200
-</code>
-Flashing the board could be also done by using <code> esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 921600 write_flash 0x1000 ../esp-bins/bootloader-esp32.bin 0x8000 ../esp-bins/partition-table-esp32.bin 0x10000 nuttx.bin </code>
-If the parameters are correct, you should see a log similar to the one below:
-{{ :iothings:laboratoare:2022:nuttx_flash_log.png?700 |}}
-Finally, the boot log should look like this:
-{{ :iothings:laboratoare:2022:nuttx_boot_log.png?700 |}}
-<note>**Assignment 1:** Modify and compile the NuttX OS kernel to toggle on and off an on-board LED. You can use the [[https://embetronicx.com/tutorials/rtos/nuttx/blink-led-on-esp32-using-nuttx-rtos/ | following tutorial]] to get started. </note>
-<note>**Assignment 2:** Build a driver for the LTR308 light sensor on the Sparrow ESP32 boards. Use [[https://github.com/robertalexa2000/nuttx-esp32-docs/blob/main/drivers/sensors.md | this]] tutorial as a starting point.</note>
-==== References ====
-  * [[https://github.com/robertalexa2000/nuttx-esp32-docs/blob/main/bringup/linux_tutorial.md | Robert Alexa's excellent tutorial]]
-  * [[https://embetronicx.com/tutorials/rtos/nuttx/setup-nuttx-rtos-on-esp32-dev-board/ | Embedtronix tutorial for ESP32-WROOM]]
-  * [[https://nuttx.apache.org/docs/latest/quickstart/index.html | Official NuttX build tutorial]]
-  * [[https://nuttx.apache.org/docs/latest/platforms/xtensa/esp32/index.html | Official NuttX ESP32 build tutorial]]
-  * [[https://blog.espressif.com/getting-started-with-esp32-and-nuttx-fd3e1a3d182c | Sara Monteiro's tutorial]]
+In this laboratory assignment you will familiarize yourself with establishing an HTTPS connection between your ESP32 board and a browser client. The board will act as a server, with an attached SSL certificate to establish the necessary credentials.
+Follow the steps [[https://randomnerdtutorials.com/esp32-https-requests/ | in this tutorial]] to set up everything on your board.
+<note>**Assignment 1:** Build an ESP32 HTTPS server and connect to it through a browser. </note>