AI 펫 키트 · ESP32-C3 SuperMini

AI 펫 펌웨어 올리기
Arduino IDE 설치부터 업로드까지

처음 하는 사람도 순서대로 따라 하면 되도록 정리했습니다. 전체 20~30분 정도 걸리고, 대부분은 내려받는 시간입니다.

0준비물

1Arduino IDE 설치

코드를 열고, 컴파일하고, 보드에 올리는 프로그램입니다.

  1. arduino.cc/en/software에서 Arduino IDE 2.x를 내려받습니다. 자기 운영체제에 맞는 것을 고릅니다.
  2. 설치 파일을 실행합니다. 중간에 드라이버 설치를 묻는 창이 나오면 모두 설치를 누릅니다.
  3. Arduino IDE를 실행합니다. 처음 켜면 추가 구성 요소를 내려받느라 1~2분 걸릴 수 있습니다.
메뉴를 한글로 바꾸려면 File → Preferences → Language에서 한국어를 고르고 다시 실행하세요. 이 문서는 영어 메뉴 이름으로 적고 한글 이름을 괄호로 붙였습니다.

2ESP32 보드 패키지 설치

Arduino IDE는 처음에 아두이노 보드만 알고 있습니다. ESP32 칩을 다룰 수 있도록 보드 패키지를 추가합니다.

2-1. 보드 매니저 주소 추가

  1. File → Preferences (파일 → 기본 설정)을 엽니다. macOS는 Arduino IDE → Settings입니다.
  2. 아래쪽 Additional boards manager URLs (추가 보드 관리자 URL) 칸에 다음 주소를 붙여 넣고 OK를 누릅니다.
https://espressif.github.io/arduino-esp32/package_esp32_index.json

2-2. 패키지 설치

  1. 왼쪽 세로 막대의 보드 모양 아이콘(Boards Manager)을 누릅니다. 메뉴로는 Tools → Board → Boards Manager입니다.
  2. 검색 칸에 esp32를 입력합니다.
  3. esp32 by Espressif Systems를 찾아 3.x 버전을 INSTALL합니다.
  4. 수백 MB를 내려받으므로 5~10분 걸립니다. 아래 출력 창에 완료 메시지가 나올 때까지 기다립니다.
이름이 비슷한 것 주의. "Arduino ESP32 Boards"는 다른 패키지입니다. 만든 곳이 Espressif Systems인 것을 설치하세요.

3라이브러리 설치

AI 펫 코드는 화면과 블루투스를 다루기 위해 다른 사람이 만든 코드 묶음(라이브러리) 2개를 씁니다.

라이브러리만든 곳하는 일
Adafruit SSD1306AdafruitOLED 화면에 얼굴을 그립니다
NimBLE-Arduinoh2zero휴대폰 앱과 블루투스(BLE)로 통신합니다. 2.x 버전
  1. 왼쪽 세로 막대의 책 모양 아이콘(Library Manager)을 누릅니다. 메뉴로는 Sketch → Include Library → Manage Libraries입니다.
  2. Adafruit SSD1306을 검색해 INSTALL을 누릅니다.
  3. "함께 필요한 라이브러리도 설치할까요?"라는 창이 뜨면 INSTALL ALL을 누릅니다. Adafruit GFX와 Adafruit BusIO가 같이 설치됩니다.
  4. NimBLE-Arduino를 검색해 h2zero가 만든 것을 INSTALL합니다. 버전이 2.x인지 확인합니다.
코드 맨 위의 Wire.h(I2C 통신)와 Preferences.h(설정 저장)는 2단계에서 설치한 ESP32 패키지에 들어 있어서 따로 설치하지 않습니다.

4코드 열기

  1. File → Open으로 ai_pet_c3_ble 폴더 안의 ai_pet_c3_ble.ino를 엽니다.
  2. 창 위쪽에 탭이 2개 보여야 합니다: ai_pet_c3_ble.ino와 motion_learn.h.
폴더 이름과 파일 이름이 같아야 합니다. .ino 파일은 자기와 이름이 같은 폴더 안에 있어야 열립니다. motion_learn.h도 같은 폴더에 있어야 합니다. 없으면 컴파일할 때 "motion_learn.h: No such file" 오류가 납니다.

코드 맨 위에서 볼 것

핀 번호가 코드 위쪽에 모여 있습니다. 보드 배선과 같아야 동작합니다.

#define PIN_SDA 8                          // I2C 데이터 (OLED + 움직임 센서)
#define PIN_SCL 9                          // I2C 클럭
#define PIN_BUZZ 10                        // 부저
const uint8_t TOUCH_PINS[3] = {5, 6, 7};   // 터치: 머리, 등, 턱
#define MPU_ADDR 0x68                      // 움직임 센서(MPU6050) 주소

5보드 설정

가장 중요한 단계입니다. 여기서 틀리면 업로드는 되는데 보드가 켜지지 않습니다.

  1. USB-C 케이블로 AI 펫 보드를 컴퓨터에 연결합니다.
  2. Tools → Board → esp32 → ESP32C3 Dev Module을 고릅니다.
  3. Tools → Port에서 보드가 연결된 포트를 고릅니다.
    • Windows: COM3처럼 COM 뒤에 숫자가 붙습니다.
    • macOS: /dev/cu.usbmodem…으로 시작합니다.
    • 어느 것인지 모르겠으면 케이블을 뺐다 꽂으면서 새로 나타나는 항목을 고릅니다.
  4. Tools 메뉴의 나머지 항목을 아래 표대로 맞춥니다.
Tools 메뉴 항목맞출 값이유
USB CDC On BootEnabledUSB로 시리얼 모니터를 보려면 켜야 합니다
Flash ModeDIOQIO로 올리면 보드가 계속 재부팅됩니다
Flash Frequency40MHz위와 같은 이유
Partition SchemeHuge APP (3MB No OTA/1MB SPIFFS)블루투스가 들어가 프로그램이 커서 기본 크기로는 안 들어갑니다
Upload Speed921600 (기본값)업로드가 자주 실패하면 460800으로 낮춥니다
나머지기본값 그대로
Flash Mode는 꼭 DIO, Flash Frequency는 꼭 40MHz. 이 두 개가 다르면 업로드는 성공했다고 나오지만 화면이 켜지지 않고 보드가 계속 꺼졌다 켜집니다.

6업로드

  1. 왼쪽 위의 ✓ (Verify) 버튼을 눌러 먼저 컴파일만 해 봅니다. 처음에는 3~5분 걸립니다. 아래 창에 주황색 오류 없이 "Sketch uses … bytes"가 나오면 성공입니다.
  2. → (Upload) 버튼을 누릅니다.
  3. 아래 창에 Writing at 0x… (100 %)와 Hard resetting…이 나오면 끝입니다. 보드가 스스로 다시 켜집니다.

업로드가 시작되지 않을 때 — 수동으로 업로드 모드 넣기

아래 창에 Connecting……만 계속 나오거나 포트 오류가 나면 이렇게 합니다. C3 SuperMini 위에 작은 버튼이 2개 있습니다.

  1. BOOT 버튼을 누른 채로 있습니다.
  2. RST(RESET) 버튼을 한 번 눌렀다 뗍니다.
  3. BOOT 버튼에서 손을 뗍니다.
  4. Tools → Port에서 포트를 다시 고릅니다. 포트 이름이 바뀌었을 수 있습니다.
  5. Upload를 다시 누릅니다. 끝나면 RST를 한 번 눌러 보드를 다시 켭니다.

7잘 올라갔는지 확인

눈과 귀로 확인

전원을 켠 뒤 1초쯤은 보드를 가만히 두세요. 그때의 자세를 기준으로 움직임 센서를 맞춥니다.

시리얼 모니터로 확인

  1. 오른쪽 위의 돋보기 아이콘(Serial Monitor)을 누릅니다.
  2. 오른쪽 아래 속도를 115200 baud로 맞춥니다.
  3. 보드의 RST 버튼을 누르면 아래와 같은 글이 나옵니다.
=== AI 펫 C3: BLE + 동작 학습 + 소리 + 터치 ===
MPU6050 OK
BLE 광고 시작: AIPet-XXXX
이렇게 나오면뜻
MPU6050 OK움직임 센서를 찾았습니다
MPU6050 실패움직임 센서가 응답하지 않습니다. 센서 납땜과 방향을 확인합니다
OLED 실패화면이 응답하지 않습니다. OLED 케이블과 선 순서(GND, VCC, SCL, SDA)를 확인합니다
BLE 광고 시작: AIPet-XXXX블루투스가 켜졌습니다. 휴대폰 앱에서 이 이름으로 찾습니다
터치: …터치 센서를 만질 때마다 나옵니다

?문제 해결

Tools → Port에 아무것도 안 나옵니다
  • 케이블이 충전 전용일 가능성이 가장 높습니다. 휴대폰과 컴퓨터 사이에 파일이 옮겨지는 케이블로 바꿉니다.
  • USB 허브를 거치지 말고 컴퓨터에 직접 꽂습니다.
  • 6단계의 BOOT + RST 방법으로 업로드 모드에 넣으면 포트가 나타납니다.
업로드는 성공했는데 화면이 안 켜지고 보드가 계속 재부팅됩니다

Flash Mode가 DIO, Flash Frequency가 40MHz인지 확인하고 다시 올립니다. 시리얼 모니터에 TG1WDT나 rst:가 반복해서 나오면 이 문제입니다.

"Sketch too big" 또는 "text section exceeds available space" 오류

Partition Scheme을 Huge APP (3MB No OTA/1MB SPIFFS)로 바꿉니다.

"NimBLEDevice.h: No such file or directory" 오류

NimBLE-Arduino 라이브러리가 설치되지 않았습니다. 3단계를 다시 합니다.

"Adafruit_SSD1306.h" 또는 "Adafruit_GFX.h"를 못 찾는다는 오류

Adafruit SSD1306을 설치할 때 INSTALL ALL을 누르지 않았을 수 있습니다. Library Manager에서 Adafruit GFX Library를 검색해 따로 설치합니다.

NimBLE 관련 오류가 잔뜩 나옵니다 (함수 이름이 없다는 내용)

NimBLE-Arduino 버전이 1.x일 수 있습니다. Library Manager에서 버전을 2.x로 바꿔 다시 설치합니다. ESP32 보드 패키지도 3.x여야 합니다.

시리얼 모니터에 아무것도 안 나옵니다
  • 속도가 115200 baud인지 확인합니다.
  • USB CDC On Boot가 Enabled인지 확인하고, 아니면 바꾼 뒤 다시 업로드합니다.
  • RST 버튼을 누른 뒤 포트를 다시 고릅니다.
"Board at … is not available" 또는 "port busy" 오류

다른 프로그램이나 다른 Arduino 창의 시리얼 모니터가 포트를 쓰고 있습니다. 모두 닫고 다시 업로드합니다.

컴파일이 너무 오래 걸립니다

처음 한 번은 ESP32 전체를 컴파일하므로 3~5분 걸리는 것이 정상입니다. 두 번째부터는 바뀐 부분만 컴파일해서 훨씬 빠릅니다.

✓한 장 요약

항목값
프로그램Arduino IDE 2.x
보드 패키지esp32 by Espressif Systems, 3.x
라이브러리Adafruit SSD1306 (+ GFX, BusIO), NimBLE-Arduino 2.x
보드ESP32C3 Dev Module
USB CDC On BootEnabled
Flash Mode / FrequencyDIO / 40MHz
Partition SchemeHuge APP (3MB No OTA/1MB SPIFFS)
시리얼 모니터115200 baud
핀SDA 8 · SCL 9 · 터치 5/6/7 · 부저 10