fix(C6-WS): Fix typos and nitpicks in ESP32-C6 workshop (#341)

Co-authored-by: Jan Beran <[email protected]>

content/workshops/esp-idf-with-esp32-c6/assignment-1/index.cs.md

@@ -17,22 +17,23 @@ V obou případech budeme postupovat podle návodu na [githubových stránkách
 
 ### Instalace pro Windows
 
-1) Nainstalujte [Visual Studio Code](https://code.visualstudio.com/download)
-2) Ve VS Code otevřete **Extensions** (Ctrl + Shift + X nebo ⇧ + ⌘ + X)
-3) Najděte [ESP-IDF plugin](https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension) a nainstalujte ho
-4) Otevřete *View -> Command Pallete* (Ctrl + Shift + P nebo ⇧ + ⌘ + P) a do nově otevřené řádky napište *Configure ESP-IDF Extension*
-5) Vyberte možnost **Express** a následně vyberte Github jako download server a release/v5.3 jako ESP-IDF version
-6) Klikněte na "Install"
+1. Nainstalujte [Visual Studio Code](https://code.visualstudio.com/download)
+2. Nainstalujte potřebné [ovladače](https://www.silabs.com/documents/public/software/CP210x_Universal_Windows_Driver.zip)
+2. Ve VS Code otevřete **Extensions** (Ctrl + Shift + X nebo ⇧ + ⌘ + X)
+3. Najděte [ESP-IDF plugin](https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension) a nainstalujte ho
+4. Otevřete *View -> Command Pallete* (Ctrl + Shift + P nebo ⇧ + ⌘ + P) a do nově otevřené řádky napište *Configure ESP-IDF Extension*
+5. Vyberte možnost **Express** a následně vyberte Github jako download server a release/v5.3 jako ESP-IDF version
+6. Klikněte na "Install"
 
 ### Instalace pro Linux a Mac
 
-1) Nainstalujte [Visual Studio Code](https://code.visualstudio.com/download)
-2) Nainstalujte [prerekvizity podle vaší distribuce](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html#step-1-install-prerequisites) (**Pouze step 1**, celý návod se věnuje instalaci samostatného ESP-IDF, to v současné chvíli nepotřebujeme)
-3) Ve VS Code otevřete **Extensions** (Ctrl + Shift + X nebo ⇧ + ⌘ + X)
-4) Najděte [ESP-IDF plugin](https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension) a nainstalujte ho
-5) Otevřete *View -> Command Pallete* (Ctrl + Shift + P nebo ⇧ + ⌘ + P) a do nově otevřené řádky napište *Configure ESP-IDF Extension*
-6) Vyberte možnost **Express** a následně vyberte Github jako download server a release/v5.3 jako *ESP-IDF version*
-7) Klikněte na "Install"
+1. Nainstalujte [Visual Studio Code](https://code.visualstudio.com/download)
+2. Nainstalujte [prerekvizity podle vaší distribuce](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html#step-1-install-prerequisites) (**Pouze step 1**, celý návod se věnuje instalaci samostatného ESP-IDF, to v současné chvíli nepotřebujeme)
+3. Ve VS Code otevřete **Extensions** (Ctrl + Shift + X nebo ⇧ + ⌘ + X)
+4. Najděte [ESP-IDF plugin](https://marketplace.visualstudio.com/items?itemName=espressif.esp-idf-extension) a nainstalujte ho
+5. Otevřete *View -> Command Pallete* (Ctrl + Shift + P nebo ⇧ + ⌘ + P) a do nově otevřené řádky napište *Configure ESP-IDF Extension*
+6. Vyberte možnost **Express** a následně vyberte Github jako download server a release/v5.3 jako *ESP-IDF version*
+7. Klikněte na "Install"
 
 
 ### Instalace ESP BLE Prov
@@ -46,7 +47,7 @@ Aplikaci buď vyhledáte v appstoru příslušného systému, nebo přes odkazy
 
 ### VSCode, ESP-IDF plugin a samotné ESP-IDF
 
-Možná jste si všimli, že během instalace ESP-IDF pluginu jste vybírali i verzi samotného ESP-IDF a měli jste mj. i možnost zvolit lokální instalaci ESP-IDF. Jak spolu tedy souvisí ESP-IDF plugin a samotné ESP_IDF?
+Možná jste si všimli, že během instalace ESP-IDF pluginu jste vybírali i verzi samotného ESP-IDF a měli jste mj. i možnost zvolit lokální instalaci ESP-IDF. Jak spolu tedy souvisí ESP-IDF plugin a samotné ESP-IDF?
 
 ESP-IDF je **samostatný framework**, který lze používat i bez VSCode a pluginu. Ovládá se z příkazové řádky (nemá tedy žádné GUI) a obsahuje všechnu logiku pro build, flashování i monitorování aplikace. Když tedy zmáčknete např. tlačítko *Build* v *ESP-IDF Exploreru* (nebojte, v dalších lekcích si vysvětlíme, co to znamená), nakonec se stejně zavolá příkaz `idf.py build`. 
 

content/workshops/esp-idf-with-esp32-c6/assignment-4/index.cs.md

@@ -33,6 +33,11 @@ V ukázce si předvedeme, jak připravit *partition table*, NVS datový soubor a
 Jak jsme si řekli, NVS používá paměť flash. Ta se ale používá i pro jiná data. Musíme tedy upravit partition tabulku a alokovat v ní místo pro náš NVS oddíl.
 
 Pomocí nám již dobře známé zkratky Ctrl + Shift + P otevřeme *Command Palette* a vyhledáme *Open Partition Table Editor UI*. 
+
+{{< alert icon="circle-info">}}
+Pokud vám nejde vyvolat *Partition Table Editor*, ověřte, že máte v konfiguraci nastavenou možnost *Partition Table -> Partition Table* na *Custom partition table CSV*.
+{{< /alert >}}
+
 Tabulku naplníme pomocí "Add New Row" tak, jak je vidno na obrázku:
 
 {{< figure

content/workshops/esp-idf-with-esp32-c6/assignment-7/index.cs.md

@@ -54,7 +54,7 @@ V této ukázce si napíšeme kód, který rozbliká LED. Jednou se o řízení
 #include "ulp_lp_core_interrupts.h"
 
 #define WAKEUP_PIN LP_IO_NUM_0
-#define RED_PIN    LP_IO_NUM_4
+#define BLUE_PIN    LP_IO_NUM_4
 #define GREEN_PIN  LP_IO_NUM_5
 
 static uint32_t wakeup_count;
@@ -66,7 +66,7 @@ void LP_CORE_ISR_ATTR ulp_lp_core_lp_io_intr_handler(void)
     wakeup_count++;
 }
 
-int main (void):
+int main (void)
 {
     /* Register interrupt for the wakeup pin */
     ulp_lp_core_intr_enable();
@@ -76,13 +76,13 @@ int main (void):
     while (1) {
         /* Toggle the Red LED GPIO */
         ulp_lp_core_gpio_set_level(GREEN_PIN, 0);
-        ulp_lp_core_gpio_set_level(RED_PIN, level);
+        ulp_lp_core_gpio_set_level(BLUE_PIN, level);
         level = level ? 0 : 1;
         ulp_lp_core_delay_us(1000000);
 
         /* Wakeup the main processor after 4 toggles of the button */
         if (wakeup_count >= 4) {
-            ulp_lp_core_gpio_set_level(RED_PIN, 0);
+            ulp_lp_core_gpio_set_level(BLUE_PIN, 0);
             ulp_lp_core_wakeup_main_processor();
             wakeup_count = 0;
         }
@@ -145,7 +145,7 @@ extern const uint8_t ulp_main_bin_end[]   asm("_binary_ulp_main_bin_end");
 static void init_ulp_program(void);
 
 #define WAKEUP_PIN  GPIO_NUM_0
-#define RED_PIN     GPIO_NUM_4
+#define BLUE_PIN    GPIO_NUM_4
 #define GREEN_PIN   GPIO_NUM_5
 
 void app_main(void)
@@ -170,13 +170,13 @@ void app_main(void)
     /* Initialize selected GPIOs */
     rtc_gpio_init(WAKEUP_PIN);
     rtc_gpio_set_direction(WAKEUP_PIN, RTC_GPIO_MODE_INPUT_ONLY);
-    rtc_gpio_pulldown_dis(WAKEUP_PIfolderN);
+    rtc_gpio_pulldown_dis(WAKEUP_PIN);
     rtc_gpio_pullup_dis(WAKEUP_PIN);
 
-    rtc_gpio_init(RED_PIN);
-    rtc_gpio_set_direction(RED_PIN, RTC_GPIO_MODE_OUTPUT_ONLY);
-    rtc_gpio_pulldown_dis(RED_PIN);
-    rtc_gpio_pullup_dis(RED_PIN);
+    rtc_gpio_init(BLUE_PIN);
+    rtc_gpio_set_direction(BLUE_PIN, RTC_GPIO_MODE_OUTPUT_ONLY);
+    rtc_gpio_pulldown_dis(BLUE_PIN);
+    rtc_gpio_pullup_dis(BLUE_PIN);
 
     rtc_gpio_init(GREEN_PIN);
     rtc_gpio_set_direction(GREEN_PIN, RTC_GPIO_MODE_OUTPUT_ONLY);
@@ -189,7 +189,7 @@ void app_main(void)
 
     while (1) {
         /* Toggle the Green LED GPIO */
-        rtc_gpio_set_level(RED_PIN, 0);
+        rtc_gpio_set_level(BLUE_PIN, 0);
         rtc_gpio_set_level(GREEN_PIN, 1);
         vTaskDelay(pdMS_TO_TICKS(1000));
         rtc_gpio_set_level(GREEN_PIN, 0);

content/workshops/esp-idf-with-esp32-c6/introduction/index.cs.md

@@ -0,0 +1,194 @@
+---
+title: "Workshop: ESP-IDF a ESP32-C6: Úvod"
+date: 2024-09-30T00:00:00+01:00
+showTableOfContents: false
+series: ["WS001CZ"]
+series_order: 1
+showAuthor: false
+---
+
+## Představení ESP-IDF
+
+**ESP-IDF** (Espressif IoT Development Framework) je oficiální vývojový framework pro všechny čipy rodiny ESP32 od firmy Espressif Systems. Framework poskytuje kompletní prostředí pro vývoj, flashování a monitorování IoT aplikací, které mohou pokrývat vše od sítí přes bezpečnost, až po vysoce spolehlivé aplikace. Samotné čipy ESP32 jsou populární napříč odvětvími, od domácích kutilů a bastlířů až po profesionální a průmyslové nasazení. 
+
+ESP-IDF v sobě obsahuje také FreeRTOS, který vývojářům umožňuje tvořit *real-time* aplikace s podporou multitaskingu. Díky široké paletě knihoven, komponent, podporovaných protokolů (Wi-Fi, Bluetooth, Thread, ZigBee, MQTT a mnoho dalšího), nástrojům a podrobné dokumentaci ESP-IDF usnadňuje vývoj IoT aplikací a umožňuje jednoduché využití velkého spektra hardware a periferií. 
+
+Zároveň ESP-IDF obsahuje zhruba 400 příkladových projektů, pokrývajících základní případy použití, což umožňuje vývojářům dále zrychlit počáteční fázi vývoje a ti tak mohou rychleji začít pracovat na svých projektech. 
+
+### Architektura
+
+Architektura frameworku ESP-IDF je rozdělená do 3 vrstev:
+
+- **ESP-IDF platforma**
+  - Obsahuje samotné jádro ESP-IDF: FreeRTOS, ovladače, protokoly, build system...
+- **Middleware**
+  - Přidává další funkcionalitu do ESP-IDF, například audio framework ESP-ADF
+- **AIoT aplikace**
+  - Váš projekt
+
+{{< figure
+    default=true
+    src="/workshops/esp-idf-with-esp32-c6/assets/esp-idf-highlevel.webp"
+    >}}
+
+### Frameworks
+
+Na ESP-IDF je založených i několik dalších frameworků:
+
+- **Arduino for ESP32**
+- **ESP-ADF** (Audio Development Framework): Připravený pro audio aplikace
+- **ESP-WHO** (AI Development Framework): Zaměřený na rozpoznávání a detekci obličeje
+- **ESP-RainMaker**: Díky cloudovým službám zjednodušuje připojení a ovládání zařízení s ESP32
+- **ESP-Matter SDK**: Oficiální vývojový framework pro Matter na čipech rodiny ESP32
+
+Pokud se chcete podívat na všechny odvozené frameworky, navštivte náš [GitHub](https://github.com/espressif).
+
+### Podpora různých verzí ESP-IDF
+
+ESP-IDF se stále vyvíjí. Pro aktuální informace o podporovaných verzích navšitvte náš Github. 
+
+{{< github repo="espressif/esp-idf" >}}
+
+## Představení ESP32-C6
+
+ESP32-C6 je *ultra-low-power* čip s architekturou RISC-V. Obsahuje jedno "plnohodnotné" a jedno ULP (*ultra-low-power*) jádro a podporuje všechny běžné bezdrátové technologie:  2.4 GHz Wi-Fi 6 (802.11ax), Bluetooth® 5 (LE), Zigbee a Thread (802.15.4). K dispozici je volitelná 4MB flash paměť přímo v pouzdře čipu, 22 nebo 30 GPIO pinů a bohatá nabídka periferií:
+
+{{< figure
+    default=true
+    src="/workshops/esp-idf-with-esp32-c6/assets/esp32-c6-diagram.webp"
+    title="Blokový diagram ESP32-C6"
+    >}}
+
+
+- 30 (QFN40) nebo 22 (QFN32) pinů
+- 5 strapping piny
+- 6 GPIO pinů je potřebných pro in-package flash
+- **Analogová rozhraní:**
+  - 12-bit SAR ADC, až 7 kanálů
+  - Senzor teploty
+- **Digitální rozhraní:**
+  - 2x UARTs
+  - Low-power (LP) UART
+  - 2x SPI pro komunikaci s flash pamětí
+  - SPI pro obecné použití
+  - I2C
+  - Low-power (LP) I2C
+  - I2S
+  - Pulse count kontroler
+  - USB Serial/JTAG kontroler
+  - 2x TWAI® kontrolery, kompatibilní s ISO 11898-1 (CAN Specification 2.0)
+  - SDIO 2.0 slave kontroler
+  - LED PWM controller, až 6 kanálů
+  - Motor Control PWM (MCPWM)
+  - Remote control periferie (TX/RX)
+  - Paralelní IO rozhraní (PARLIO)
+  - Obecný DMA kontroler se 3 transmit 3 receive kanály
+  - Event task matrix (ETM)
+- **Timery:**
+  - 52-bit systémový timer
+  - 2x 54-bit timer pro obecné použití
+  - 3x digitální watchdog
+  - Analogový watchdog
+
+Pro více detailů se podívejte na [datasheet ESP32-C6](https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf).
+
+## Představení kitu ESP32-C6-DevKit-C
+
+ESP32-C6-DevKitC-1 je vývojová deska určená (nejen) začátečníkům, v jejímž srdci je modul ESP32-C6-WROOM-1(U) spolu s 8 MB SPI flash paměti. Stejně jako samotný čip ESP32-C6, deska podporuje mnoho protokolů, od Wi-Fi, přes Blzuetooth LE, až po Zigbee a Thread.
+
+Většina GPIO pinů je přístupná z vývodů po stranách desky se standardní roztečí 2.54 mm. Periferie na ně můžou být připojené pomocí klasických vodičů, případně lze desku zacvaknout do nepájivého pole. 
+
+### Vlastnosti
+
+Níže jsou uvedené základní vlastnosti vývojého kitu:
+
+- ESP32-C6-WROOM-1 modul
+- Pinové vývody po stranách
+- 5 V to 3.3 V low-dropou regulátor
+- 3.3 V Power On LED
+- USB-to-UART Bridge
+- ESP32-C6 USB Type-C Port pro flashování a debug
+- Boot Button
+- Reset Button
+- USB Type-C to UART Port
+- RGB LED na pinu GPIO8
+- J5 jumper pro měření proudu
+
+#### Popis desky
+
+{{< figure
+    default=true
+    src="/workshops/esp-idf-with-esp32-c6/assets/esp32-c6-devkitc-1-v1.2-annotated-photo.webp"
+    title="Schéma kitu ESP32-C6-DevKit-C"
+    >}}
+
+{{< figure
+    default=true
+    src="/workshops/esp-idf-with-esp32-c6/assets/esp32-c6-devkitc-1-v1.2-block-diagram.webp"
+    title="Blokový diagram kitu ESP32-C6-DevKit-C"
+    >}}
+
+#### Pinout desky
+
+
+
+{{< figure
+    default=true
+    src="/workshops/esp-idf-with-esp32-c6/assets/esp32-c6-devkitc-1-pin-layout.webp"
+    title="Pinout kitu ESP32-C6-DevKit-C"
+    >}}
+
+#### J1 pinové pole
+
+| No. | Name | Type | Function |
+|---|---|---|---|
+| 1 | 3V3 | P | 3.3 V power supply |
+| 2 | RST | I | High: enables the chip; Low: disables the chip. |
+| 3 | 4 | I/O/T | MTMS, GPIO4, **LP_GPIO4**, **LP_UART_RXD**, ADC1_CH4, FSPIHD |
+| 4 | 5 | I/O/T | MTDI, GPIO5, **LP_GPIO5**, **LP_UART_TXD**, ADC1_CH5, FSPIWP |
+| 5 | 6 | I/O/T | MTCK, GPIO6, **LP_GPIO6**, **LP_I2C_SDA**, ADC1_CH6, FSPICLK |
+| 6 | 7 | I/O/T | MTDO, GPIO7, **LP_GPIO7**, **LP_I2C_SCL**, FSPID |
+| 7 | 0 | I/O/T | GPIO0, XTAL_32K_P, **LP_GPIO0**, **LP_UART_DTRN**, ADC1_CH0 |
+| 8 | 1 | I/O/T | GPIO1, XTAL_32K_N, **LP_GPIO1**, **LP_UART_DSRN**, ADC1_CH1 |
+| 9 | 8 | I/O/T | GPIO8 |
+| 10 | 10 | I/O/T | GPIO10 |
+| 11 | 11 | I/O/T | GPIO11 |
+| 12 | 2 | I/O/T | GPIO2, **LP_GPIO2**, **LP_UART_RTSN**, ADC1_CH2, FSPIQ |
+| 13 | 3 | I/O/T | GPIO3, **LP_GPIO3**, **LP_UART_CTSN**, ADC1_CH3 |
+| 14 | 5V | P | 5 V power supply |
+| 15 | G | G | Ground |
+| 16 | NC | – | No connection |
+
+#### J3 pinové pole
+
+| No. | Name | Type | Function |
+|---|---|---|---|
+| 1 | G | G | Ground |
+| 2 | TX | I/O/T | U0TXD, GPIO16, FSPICS0 |
+| 3 | RX | I/O/T | U0RXD, GPIO17, FSPICS1 |
+| 4 | 15 | I/O/T | GPIO15 |
+| 5 | 23 | I/O/T | GPIO23, SDIO_DATA3 |
+| 6 | 22 | I/O/T | GPIO22, SDIO_DATA2 |
+| 7 | 21 | I/O/T | GPIO21, SDIO_DATA1, FSPICS5 |
+| 8 | 20 | I/O/T | GPIO20, SDIO_DATA0, FSPICS4 |
+| 9 | 19 | I/O/T | GPIO19, SDIO_CLK, FSPICS3 |
+| 10 | 18 | I/O/T | GPIO18, SDIO_CMD, FSPICS2 |
+| 11 | 9 | I/O/T | GPIO9 |
+| 12 | G | G | Ground |
+| 13 | 13 | I/O/T | GPIO13, USB_D+ |
+| 14 | 12 | I/O/T | GPIO12, USB_D- |
+| 15 | G | G | Ground |
+| 16 | NC | – | No connection |
+
+### Zdroje
+
+- [ESP32-C6 Datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf)
+- [ESP32-C6 Documentation](https://docs.espressif.com/projects/esp-idf/en/release-v5.3/esp32c6/index.html)
+- [ESP32-C6-DevKit-C Documentation](https://docs.espressif.com/projects/espressif-esp-dev-kits/en/latest/esp32c6/esp32-c6-devkitc-1/user_guide.html)
+- [ESP32-C6-DevKit-C Schematic](https://docs.espressif.com/projects/espressif-esp-dev-kits/en/latest/_static/esp32-c6-devkitc-1/schematics/esp32-c6-devkitc-1-schematics_v1.2.pdf)
+
+## Další krok
+
+Pro teoretickém úvodu již nastal čas pustit se do programování. Nejprve si ale musíme naisntalovat potřebné nástroje.
+
+[Úkol 1: Instalace ESP-IDF](../assignment-1)