Introduction to ESP32 programming using official development framework, ESP-IDF and Arduino for ESP32. Every demo code is published in this github repository: https://github.com/alwint3r/RTR_Surabaya2017

2. Introduction to ESP32 Programming
Using ESP-IDF & Arduino Framework

3. $ whoami
Alwin Arrasyid
Software Engineer, DycodeX
winter@dycode.com
twitter.com/alwin_wint3r
github.com/alwint3r

4. ESP32

5. CPU: Tensilica Xtensa 32-bit dual core, up to 240 MHz, 600 DMIPS.
Operating voltage: 3.3V
Memory: 448 KB ROM, 520 KB SRAM 16 KB SRAM in RTC, 1 Kbit of eFuse.
External Flash: 512 KB to (4 x 16) MiB
WiFi (802.11): b/g/n/e/i
Bluetooth: v4.2 BR/EDR & BLE
Peripherals: GPIOs, PWM, ADC, DAC, I2S, UART, SPI, I2C, CAN, RMII, Cap Touch

6. ESP8266 vs ESP32

7. ESP32 Modules

8. ESP32 Boards

9. ESP32 Boards

10. ESP-IDF
ESP32 Development Platforms

11. ESP32 Development Tools / IDE

12. Our Focus
ESP-IDF

13. What is ESP-IDF?
ESP IoT Development Framework or abbreviated as ESP-IDF is
the official development framework for ESP32.
source code: https://github.com/espressif/esp-idf
documentation: http://esp-idf.readthedocs.io

14. ESP-IDF is built with these languages

15. Let's get started!

17. Installation Steps
• Download required software packages (OS specific)
• Download & setup xtensa-esp32 toolchain
• Download & setup ESP-IDF

18. Prerequisites - GNU/Linux (Debian-based)
git wget make libncurses-dev flex bison gperf python python-serial
Install the following packages using the package manager

19. Prerequisites - macOS
sudo easy_install pip
Install pip, package manager for python
sudo pip install pyserial
Install pyserial using pip

20. Toolchain Setup - GNU/Linux (Debian-based)
https://dl.espressif.com/dl/xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz
Toolchain for 32 bit system
https://dl.espressif.com/dl/xtensa-esp32-elf-linux64-1.22.0-61-gab8375a-5.2.0.tar.gz
Toolchain for 64 bit system

21. Toolchain Setup - GNU/Linux (Debian-based)
$ mkdir -p ~/esp
$ cd ~/esp
$ tar -xzf ~/Downloads/xtensa-esp32-elf-linux64-1.22.0-61-gab8375a-
5.2.0.tar.gz
Download & extract the toolchain to the ~/esp directory.

22. Toolchain Setup - GNU/Linux (Debian-based)
$ export PATH=$PATH:$HOME/esp/xtensa-esp32-elf/bin
"Introduce" the toolchain so the system knows they're there.
You can also append above line to the .bashrc, .profile, or .bash_profile, so you only need
to do this only once.

23. Toolchain Setup - macOS
https://dl.espressif.com/dl/xtensa-esp32-elf-osx-1.22.0-61-gab8375a-5.2.0.tar.gz
The steps are pretty much the same with the previous one. Only the
filename & URL of the toolchain that is different with the GNU/Linux.

24. Toolchain Setup - Windows
https://dl.espressif.com/dl/esp32_win32_msys2_environment_and_toolchain-20170330.zip
You only need to download the toolchain + msys2 environment from this
URL & extract the archive to C: drive.
Open msys2 terminal & create esp directory inside home folder.
$ mkdir -p ~/esp

25. ESP-IDF Setup
$ cd ~/esp
$ git clone -- recursive https://github.com/espressif/esp-idf.git
Clone the esp-idf repository.

26. ESP-IDF Setup - GNU/Linux & macOS
$ export IDF_PATH=$HOME/esp/esp-idf
Set a new environment variable with the path to ESP-IDF directory as its
value.
It is recommended to append above line to the .bashrc, .profile, or .bash_profile, so you
only need to do this only once.

27. ESP-IDF Setup - Windows
$ touch /etc/profile.d/export_idf_path.sh
Create a user script file inside the C:/msys32/etc/profile.d/ directory. We'll
call it export_idf_path.sh.
Export the ESP-IDF path
$ echo export IDF_PATH=C:/msys32/home/user-name/esp/esp-idf >>
/etc/profile.d/export_idf_path.sh

28. Complete installation guide:
esp-idf.readthedocs.io/en/latest/get-started

29. Hello World

30. Hello World
~/esp/esp-idf/examples/get-started/hello_world
Copied from examples provided by ESP-IDF.

31. ├── main
│ ├── component.mk
│ └── hello_world_main.c
├── Makefile
└── README.md
Project Tree

32. Build & Flash the Firmware
We need to configure the project first. The configuration includes the serial
port of the ESP32 board, the baud rate, and so many more!
$ make menuconfig

33. Build & Flash the Firmware
$ make -j3
$ make flash
$ make monitor
$ make -j3 flash monitor
Or even better, a one liner!

34. ESP-IDF Component

35. ESP-IDF Component
• Has a C/C++ source & header files
• Has a component.mk file
• Optionally has Kconfig (configuration) file

36. component_name
├── component.mk
├── component_source.c
├── include
│ └── component_source.h
└── Kconfig
ESP-IDF Component Anatomy

37. component_name
├── component.mk
├── Kconfig
├── component_source.h
└── component_source.c
ESP-IDF Component Anatomy

38. Another Demo

39. Using Arduino for ESP32

40. Using Arduino for ESP32
• Arduino is still the preferred choice among makers
• Huge community
• Easier to get started with

41. Using Arduino for ESP32 - Trade-off!
• Lose control of the configurations & low level stuff

42. Arduino for ESP32 Demo

43. Choose one!
ESP-IDF or Arduino?

45. ESP-IDF + =
as component

46. Proof, please!

47. Moar demo!

48. Where to go from here?

49. ESP32 Learning Resources
• Official documentation
esp-idf.readthedocs.io
• ESP-IDF examples code
github.com/espressif/esp-idf/tree/master/examples
• Technical Book (Free!)
leanpub.com/kolban-ESP32
• Really useful snippets
github.com/nkolban/esp32-snippets
• ESP32 forum
esp32.com

50. Code shown during this session:
github.com/alwint3r/RTR_Surabaya2017

51. Thank you!