Espressif systems Esp32-s2-mini-2 User manual

ESP32-S2-MINI-2UserManual2.4GHzWi-Fi(802.11b/g/n)moduleBuiltaroundESP32-S2seriesofSoC(chiprevisionv1.0),Xtensa®single-core32-bitLX7mi-croprocessor4MBflashandoptional2MBPSRAMinchippackage37GPIOs,richsetofperipheralsOn-boardPCBantennaESP32-S2-MINI-2Pre-releasev0.5EspressifSystemsCopyright©2022www.espressif.com

1ModuleOverview1ModuleOverviewESP32-S2-MINI-2isageneral-purposeWi-Fimodule.Therichsetofperipheralsandasmallsizemakethismoduleanidealchoiceforsmarthomes,industrialautomation,healthcare,consumerelectronics,etc.Table1:ESP32-S2-MINI-2SpecificationsCategoriesParametersSpecificationsWi-FiProtocols802.11b/g/n(upto150Mbps)Frequencyrange2412~2462MHzHardwareModuleinterfacesGPIO,SPI,I2S,UART,I2C,LEDPWM,TWAI®,LCD,Camerainterface,ADC,DAC,touchsensor,temper-aturesensor,USBOTGIntegratedcrystal40MHzcrystalOperatingvoltage/Powersupply3.0V~3.6VOperatingcurrentAverage:80mAMinimumcurrentdeliveredbypowersupply500mAAmbienttemperature–40°C~+85°C/105°CMoisturesensitivitylevel(MSL)Level3EspressifSystems2ESP32-S2-MINI-2UserManualv0.5

ContentsContents1ModuleOverview22PinDefinitions42.1PinLayout42.2PinDescription43GetStarted73.1WhatYouNeed73.2HardwareConnection73.3SetupDevelopmentEnvironment83.3.1InstallPrerequisites83.3.2GetESP-IDF83.3.3SetupTools93.3.4SetupEnvironmentVariables93.4CreateYourFirstProject93.4.1StartaProject93.4.2ConnectYourDevice93.4.3Configure103.4.4BuildtheProject103.4.5FlashontotheDevice113.4.6Monitor124U.S.FCCStatement145RelatedDocumentationandResources18RevisionHistory19EspressifSystems3ESP32-S2-MINI-2UserManualv0.5

2PinDefinitions2PinDefinitions2.1PinLayoutThepindiagrambelowshowstheapproximatelocationofpinsonthemodule.

Pin 1

Pin 2

Pin 3

Pin 4

Pin 5

Pin 6

Pin 7

Pin 8

Pin 9

Pin 10

Pin 11

Pin 12

Pin 13

Pin 14

Pin 15

GND

3V3

IO0

IO1

IO2

IO3

IO4

IO5

IO6

IO7

IO8

IO9

IO10

IO11

Pin 63

GND

IO12 Pin 16

Pin 17

Pin 18

Pin 19

Pin 20

Pin 21

Pin 22

Pin 23

Pin 24

Pin 25

Pin 26

Pin 27

Pin 28

Pin 29

Pin 30

Pin 64

GND

Pin 31

IO13

IO14

IO15

IO16

IO17

IO18

IO19

IO20

IO21

IO26

IO33

IO34

GND

Pin 32

Pin 33

Pin 34

Pin 35

Pin 36

Pin 37

Pin 38

Pin 39

Pin 40

Pin 41

Pin 42

Pin 43

Pin 44

Pin 45

Pin 65

GND

Pin 62

GND

Pin 46

Pin 47

Pin 48

Pin 49

Pin 50

Pin 51

Pin 52

Pin 53

Pin 54

Pin 55

Pin 56

Pin 57

Pin 58

Pin 59

Pin 60

Pin 61

GND

GND GND GND

GNDGND

GND GND GND

IO35

IO36

IO37

IO38

IO39

IO40

IO41

IO42

TXD0

RXD0

IO45

GND

IO46

GND

Keepout Zone

Figure1:PinLayout(TopView)2.2PinDescriptionThemodulehas65pins.SeepindefinitionsinTable2.Forperipheralpinconfigurations,pleaserefertoESP32-S2SeriesDatasheet.Table2:PinDefinitionsNameNo.Type1FunctionGND1,2,30,42,43,46-65PGround3V33PPowersupplyCont’donnextpageEspressifSystems4ESP32-S2-MINI-2UserManualv0.5

2PinDefinitionsTable2–cont’dfrompreviouspageNameNo.Type1FunctionIO04I/O/TRTC_GPIO0,GPIO0IO15I/O/TRTC_GPIO1,GPIO1,TOUCH1,ADC1_CH0IO26I/O/TRTC_GPIO2,GPIO2,TOUCH2,ADC1_CH1IO37I/O/TRTC_GPIO3,GPIO3,TOUCH3,ADC1_CH2IO48I/O/TRTC_GPIO4,GPIO4,TOUCH4,ADC1_CH3IO59I/O/TRTC_GPIO5,GPIO5,TOUCH5,ADC1_CH4IO610I/O/TRTC_GPIO6,GPIO6,TOUCH6,ADC1_CH5IO711I/O/TRTC_GPIO7,GPIO7,TOUCH7,ADC1_CH6IO812I/O/TRTC_GPIO8,GPIO8,TOUCH8,ADC1_CH7IO913I/O/TRTC_GPIO9,GPIO9,TOUCH9,ADC1_CH8,FSPIHDIO1014I/O/TRTC_GPIO10,GPIO10,TOUCH10,ADC1_CH9,FSPICS0,FSPIIO4IO1115I/O/TRTC_GPIO11,GPIO11,TOUCH11,ADC2_CH0,FSPID,FSPIIO5IO1216I/O/TRTC_GPIO12,GPIO12,TOUCH12,ADC2_CH1,FSPICLK,FSPIIO6IO1317I/O/TRTC_GPIO13,GPIO13,TOUCH13,ADC2_CH2,FSPIQ,FSPIIO7IO1418I/O/TRTC_GPIO14,GPIO14,TOUCH14,ADC2_CH3,FSPIWP,FSPIDQSIO1519I/O/TRTC_GPIO15,GPIO15,U0RTS,ADC2_CH4,XTAL_32K_PIO1620I/O/TRTC_GPIO16,GPIO16,U0CTS,ADC2_CH5,XTAL_32K_NIO1721I/O/TRTC_GPIO17,GPIO17,U1TXD,ADC2_CH6,DAC_1IO1822I/O/TRTC_GPIO18,GPIO18,U1RXD,ADC2_CH7,DAC_2,CLK_OUT3IO1923I/O/TRTC_GPIO19,GPIO19,U1RTS,ADC2_CH8,CLK_OUT2,USB_D-IO2024I/O/TRTC_GPIO20,GPIO20,U1CTS,ADC2_CH9,CLK_OUT1,USB_D+IO2125I/O/TRTC_GPIO21,GPIO21IO26226I/O/TSPICS1,GPIO26NC27—NCIO3328I/O/TSPIIO4,GPIO33,FSPIHDIO3429I/O/TSPIIO5,GPIO34,FSPICS0IO3531I/O/TSPIIO6,GPIO35,FSPIDIO3632I/O/TSPIIO7,GPIO36,FSPICLKIO3733I/O/TSPIDQS,GPIO37,FSPIQIO3834I/O/TGPIO38,FSPIWPIO3935I/O/TMTCK,GPIO39,CLK_OUT3IO4036I/O/TMTDO,GPIO40,CLK_OUT2IO4137I/O/TMTDI,GPIO41,CLK_OUT1IO4238I/O/TMTMS,GPIO42TXD039I/O/TU0TXD,GPIO43,CLK_OUT1RXD040I/O/TU0RXD,GPIO44,CLK_OUT2IO4541I/O/TGPIO45IO4644IGPIO46EN45IHigh:on,enablesthechip.Low:off,thechippowersoff.Note:DonotleavetheENpinfloating.EspressifSystems5ESP32-S2-MINI-2UserManualv0.5

2PinDefinitions1P:powersupply;I:input;O:output;T:highimpedance.2IO26isusedbytheembeddedPSRAMontheESP32-S2-MINI-2-N4R2module,andcannotbeusedforotherpurposes.EspressifSystems6ESP32-S2-MINI-2UserManualv0.5

3GetStarted3GetStarted3.1WhatYouNeedTodevelopapplicationsformoduleyouneed:•1xESP32-S2-MINI-2•1xEspressifRFtestingboard•1xUSB-to-Serialboard•1xMicro-USBcable•1xPCrunningLinuxInthisuserguide,wetakeLinuxoperatingsystemasanexample.FormoreinformationabouttheconfigurationonWindowsandmacOS,pleaserefertoESP-IDFProgrammingGuide.3.2HardwareConnection1.SoldertheESP32-S2-MINI-2moduletotheRFtestingboardasshowninFigure2.Figure2:HardwareConnection2.ConnecttheRFtestingboardtotheUSB-to-SerialboardviaTXD,RXD,andGND.3.ConnecttheUSB-to-SerialboardtothePC.4.ConnecttheRFtestingboardtothePCorapoweradaptertoenable5Vpowersupply,viatheMicro-USBcable.5.Duringdownload,connectIO0toGNDviaajumper.Then,turn”ON”thetestingboard.6.Downloadfirmwareintoflash.Fordetails,seethesectionsbelow.EspressifSystems7ESP32-S2-MINI-2UserManualv0.5

3GetStarted7.Afterdownload,removethejumperonIO0andGND.8.PoweruptheRFtestingboardagain.Themodulewillswitchtoworkingmode.Thechipwillreadprogramsfromflashuponinitialization.Note:IO0isinternallylogichigh.IfIO0issettopull-up,theBootmodeisselected.Ifthispinispull-downorleftfloating,theDownloadmodeisselected.FormoreinformationonESP32-S2-MINI-2,pleaserefertoESP32-S2SeriesDatasheet.3.3SetupDevelopmentEnvironmentTheEspressifIoTDevelopmentFramework(ESP-IDFforshort)isaframeworkfordevelopingapplicationsbasedontheEspressifSoCs.UserscandevelopapplicationswithESP32-S2inWindows/Linux/macOSbasedonESP-IDF.HerewetakeLinuxoperatingsystemasanexample.3.3.1InstallPrerequisitesTocompilewithESP-IDFyouneedtogetthefollowingpackages:•CentOS7&8:1sudo yum -y update && sudo yum install git wget flex bison gperf python3 python3-

pip

2python3-setuptools cmake ninja-build ccache dfu-util libusbx

•UbuntuandDebian:1sudo apt-get install git wget flex bison gperf python3 python3-pip python3-

setuptools

2cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

•Arch:1sudo pacman -S --needed gcc git make flex bison gperf python-pip cmake ninja

ccache

2dfu-util libusb

Note:•Thisguideusesthedirectory~/esponLinuxasaninstallationfolderforESP-IDF.•KeepinmindthatESP-IDFdoesnotsupportspacesinpaths.3.3.2GetESP-IDFTobuildapplicationsforESP32-S2-MINI-2module,youneedthesoftwarelibrariesprovidedbyEspressifinESP-IDFrepository.TogetESP-IDF,createaninstallationdirectory(~/esp)todownloadESP-IDFtoandclonetherepositorywith‘gitclone’:EspressifSystems8ESP32-S2-MINI-2UserManualv0.5

3GetStarted1mkdir -p ~/esp

2cd ~/esp

3git clone --recursive https://github.com/espressif/esp-idf.git

ESP-IDFwillbedownloadedinto~/esp/esp-idf.ConsultESP-IDFVersionsforinformationaboutwhichESP-IDFversiontouseinagivensituation.3.3.3SetupToolsAsidefromtheESP-IDF,youalsoneedtoinstallthetoolsusedbyESP-IDF,suchasthecompiler,debugger,Pythonpackages,etc.ESP-IDFprovidesascriptnamed’install.sh’tohelpsetupthetoolsinonego.1cd ~/esp/esp-idf

2./install.sh

3.3.4SetupEnvironmentVariablesTheinstalledtoolsarenotyetaddedtothePATHenvironmentvariable.Tomakethetoolsusablefromthecommandline,someenvironmentvariablesmustbeset.ESP-IDFprovidesanotherscript’export.sh’whichdoesthat.IntheterminalwhereyouaregoingtouseESP-IDF,run:1. $HOME/esp/esp-idf/export.sh

Noweverythingisready,youcanbuildyourfirstprojectonESP32-S2-MINI-2module.3.4CreateYourFirstProject3.4.1StartaProjectNowyouarereadytoprepareyourapplicationforESP32-S2-MINI-2module.Youcanstartwithget-started/hello_worldprojectfromexamplesdirectoryinESP-IDF.Copyget-started/hello_worldto~/espdirectory:1cd ~/esp

2cp -r $IDF_PATH/examples/get-started/hello_world .

ThereisarangeofexampleprojectsintheexamplesdirectoryinESP-IDF.Youcancopyanyprojectinthesamewayaspresentedaboveandrunit.Itisalsopossibletobuildexamplesin-place,withoutcopyingthemfirst.3.4.2ConnectYourDeviceNowconnectyourmoduletothecomputerandcheckunderwhatserialportthemoduleisvisible.SerialportsinLinuxstartwith‘/dev/tty’intheirnames.Runthecommandbelowtwotimes,firstwiththeboardunplugged,thenwithpluggedin.Theportwhichappearsthesecondtimeistheoneyouneed:1ls /dev/tty*

Note:Keeptheportnamehandyasyouwillneeditinthenextsteps.EspressifSystems9ESP32-S2-MINI-2UserManualv0.5

3GetStarted3.4.3ConfigureNavigatetoyour‘hello_world’directoryfromStep3.4.1.StartaProject,setESP32-S2chipasthetargetandruntheprojectconfigurationutility‘menuconfig’.1cd ~/esp/hello_world

2idf.py set-target esp32s2

3idf.py menuconfig

Settingthetargetwith‘idf.pyset-targetESP32-S2’shouldbedoneonce,afteropeninganewproject.Iftheprojectcontainssomeexistingbuildsandconfiguration,theywillbeclearedandinitialized.Thetargetmaybesavedinenvironmentvariabletoskipthisstepatall.SeeSelectingtheTargetforadditionalinformation.Ifthepreviousstepshavebeendonecorrectly,thefollowingmenuappears:Figure3:ProjectConfiguration-HomeWindowYouareusingthismenutosetupprojectspecificvariables,e.g.Wi-Finetworknameandpassword,theprocessorspeed,etc.Settinguptheprojectwithmenuconfigmaybeskippedfor“hello_word”.ThisexamplewillrunwithdefaultconfigurationThecolorsofthemenucouldbedifferentinyourterminal.Youcanchangetheappearancewiththeoption‘-฀-style’฀.Pleaserun‘idf.pymenuconfig-฀-help’฀forfurtherinformation.3.4.4BuildtheProjectBuildtheprojectbyrunning:1idf.py build