TinySkiff ESP32-S3 Lab · Day 2 of 30

Get the toolchain
talking once

This is the one genuinely fiddly day — installing software and a driver. It's worth doing slowly, because once your board shows up as a port, you never have to think about setup again.

About 25 minutesSoftware onlyNothing to wireDo it once
Agent assist code TSK-DAY02-SETUP

Hand this to an agent so it can pull the lesson packet and coach you step by step.

01 First, know the pieces

What you need

Everything today is on your computer and the cable. Tap Define on anything unfamiliar.

Official manual photo of the ESP32-S3 development board.
Manual photo

ESP32-S3 board

The board you'll get your computer to recognise.

Official manual screenshot of the Arduino IDE interface.
Manual screenshot

Arduino IDE

The free app that will compile and upload your code.

02 One action at a time

Build it

Follow these in order. If a step stalls, the Test & debug section below is where the common snags live.

0 / 5 done
  1. Download and install the Arduino IDE from arduino.cc for your operating system.

  2. In Preferences, add the ESP32 boards URL, then install the ESP32 package from Boards Manager.

  3. If your system needs it, install the CH343 USB driver.

  4. Plug the board in with a data-capable USB-C cable.

  5. Choose your ESP32-S3 under Tools → Board, then pick its Port.

Handshake complete.

Your board is a selectable port now. Day 3 sends it its first code.

03 Understand, don't memorise

Board vs port

Two settings trip people up on Day 2. They sound similar but do different jobs, and both have to be right before anything uploads.

Board package

Teach the IDE

Adds the know-how to compile for the ESP32-S3.

Board setting

What it is

Tells the IDE which chip you're targeting.

Port setting

Where it is

Tells the IDE which USB connection to use.

Driver

If unseen

Lets the computer recognise the board's USB chip.

The rule right board + right port = uploads work

Why a port might not appear

A missing driver or a charge-only cable are the two usual reasons the board never shows up.

04 Know it worked

Test & debug

There's no sketch to run yet. Success is simply that the IDE can see the board.

How you know it worked
Tools → Port
  • Your ESP32-S3 appears as a selectable port in Tools → Port.
  • The board name is selectable under Tools → Board.
  • No error appears when you select them.

You don't need to upload anything today — seeing the port is the whole win.

If it doesn't
  • No port appears? Install the CH343 driver, then unplug and replug the board.
  • Only a charging sound, no port? Swap in a data-capable USB-C cable — some only carry power.
  • Board not in the list? Re-open Boards Manager and confirm the ESP32 package finished installing.

05 Make the idea yours

Try this: break it, then fix it

The best way to trust a setting is to change it and put it back. You'll recognise the mistake instantly next time it happens by accident.

Pick the wrong port

Choose a different port (or none). Notice the IDE has nowhere to send code.

Put it right

Reselect your ESP32-S3 board and its real port. That pairing is your normal starting point every day.

Logbook

06 Learn it with a hand on the tiller

Coach me through it

Every lesson ships with a code and a machine-readable packet, so an agent can guide you with full context.

Lesson code

TSK-DAY02-SETUP

How the agent should behave: walk the install one step at a time, and when the board doesn't appear, check driver, cable, board, and port in that order before anything else.

Field note

Shortcut

Prompt copied