0준비물
- AI 펫 보드 (ESP32-C3 SuperMini가 달린 것)
- 데이터 전송이 되는 USB-C 케이블. 충전 전용 케이블은 컴퓨터가 보드를 인식하지 못합니다.
- 컴퓨터 (Windows 10 이상 또는 macOS)
- 펌웨어 폴더
ai_pet_c3_ble. 안에 파일이 2개 있어야 합니다:ai_pet_c3_ble.ino,motion_learn.h
1Arduino IDE 설치
코드를 열고, 컴파일하고, 보드에 올리는 프로그램입니다.
- arduino.cc/en/software에서 Arduino IDE 2.x를 내려받습니다. 자기 운영체제에 맞는 것을 고릅니다.
- 설치 파일을 실행합니다. 중간에 드라이버 설치를 묻는 창이 나오면 모두 설치를 누릅니다.
- Arduino IDE를 실행합니다. 처음 켜면 추가 구성 요소를 내려받느라 1~2분 걸릴 수 있습니다.
2ESP32 보드 패키지 설치
Arduino IDE는 처음에 아두이노 보드만 알고 있습니다. ESP32 칩을 다룰 수 있도록 보드 패키지를 추가합니다.
2-1. 보드 매니저 주소 추가
- File → Preferences (파일 → 기본 설정)을 엽니다. macOS는 Arduino IDE → Settings입니다.
- 아래쪽 Additional boards manager URLs (추가 보드 관리자 URL) 칸에 다음 주소를 붙여 넣고 OK를 누릅니다.
https://espressif.github.io/arduino-esp32/package_esp32_index.json
2-2. 패키지 설치
- 왼쪽 세로 막대의 보드 모양 아이콘(Boards Manager)을 누릅니다. 메뉴로는 Tools → Board → Boards Manager입니다.
- 검색 칸에
esp32를 입력합니다. - esp32 by Espressif Systems를 찾아 3.x 버전을 INSTALL합니다.
- 수백 MB를 내려받으므로 5~10분 걸립니다. 아래 출력 창에 완료 메시지가 나올 때까지 기다립니다.
3라이브러리 설치
AI 펫 코드는 화면과 블루투스를 다루기 위해 다른 사람이 만든 코드 묶음(라이브러리) 2개를 씁니다.
| 라이브러리 | 만든 곳 | 하는 일 |
|---|---|---|
| Adafruit SSD1306 | Adafruit | OLED 화면에 얼굴을 그립니다 |
| NimBLE-Arduino | h2zero | 휴대폰 앱과 블루투스(BLE)로 통신합니다. 2.x 버전 |
- 왼쪽 세로 막대의 책 모양 아이콘(Library Manager)을 누릅니다. 메뉴로는 Sketch → Include Library → Manage Libraries입니다.
Adafruit SSD1306을 검색해 INSTALL을 누릅니다.- "함께 필요한 라이브러리도 설치할까요?"라는 창이 뜨면 INSTALL ALL을 누릅니다. Adafruit GFX와 Adafruit BusIO가 같이 설치됩니다.
NimBLE-Arduino를 검색해 h2zero가 만든 것을 INSTALL합니다. 버전이 2.x인지 확인합니다.
Wire.h(I2C 통신)와 Preferences.h(설정 저장)는 2단계에서 설치한 ESP32 패키지에 들어 있어서 따로 설치하지 않습니다.4코드 열기
- File → Open으로
ai_pet_c3_ble폴더 안의ai_pet_c3_ble.ino를 엽니다. - 창 위쪽에 탭이 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보드 설정
가장 중요한 단계입니다. 여기서 틀리면 업로드는 되는데 보드가 켜지지 않습니다.
- USB-C 케이블로 AI 펫 보드를 컴퓨터에 연결합니다.
- Tools → Board → esp32 → ESP32C3 Dev Module을 고릅니다.
- Tools → Port에서 보드가 연결된 포트를 고릅니다.
- Windows:
COM3처럼COM뒤에 숫자가 붙습니다. - macOS:
/dev/cu.usbmodem…으로 시작합니다. - 어느 것인지 모르겠으면 케이블을 뺐다 꽂으면서 새로 나타나는 항목을 고릅니다.
- Windows:
- Tools 메뉴의 나머지 항목을 아래 표대로 맞춥니다.
| Tools 메뉴 항목 | 맞출 값 | 이유 |
|---|---|---|
| USB CDC On Boot | Enabled | USB로 시리얼 모니터를 보려면 켜야 합니다 |
| Flash Mode | DIO | QIO로 올리면 보드가 계속 재부팅됩니다 |
| Flash Frequency | 40MHz | 위와 같은 이유 |
| Partition Scheme | Huge APP (3MB No OTA/1MB SPIFFS) | 블루투스가 들어가 프로그램이 커서 기본 크기로는 안 들어갑니다 |
| Upload Speed | 921600 (기본값) | 업로드가 자주 실패하면 460800으로 낮춥니다 |
| 나머지 | 기본값 그대로 |
6업로드
- 왼쪽 위의 ✓ (Verify) 버튼을 눌러 먼저 컴파일만 해 봅니다. 처음에는 3~5분 걸립니다. 아래 창에 주황색 오류 없이 "Sketch uses … bytes"가 나오면 성공입니다.
- → (Upload) 버튼을 누릅니다.
- 아래 창에
Writing at 0x… (100 %)와Hard resetting…이 나오면 끝입니다. 보드가 스스로 다시 켜집니다.
업로드가 시작되지 않을 때 — 수동으로 업로드 모드 넣기
아래 창에 Connecting……만 계속 나오거나 포트 오류가 나면 이렇게 합니다. C3 SuperMini 위에 작은 버튼이 2개 있습니다.
- BOOT 버튼을 누른 채로 있습니다.
- RST(RESET) 버튼을 한 번 눌렀다 뗍니다.
- BOOT 버튼에서 손을 뗍니다.
- Tools → Port에서 포트를 다시 고릅니다. 포트 이름이 바뀌었을 수 있습니다.
- Upload를 다시 누릅니다. 끝나면 RST를 한 번 눌러 보드를 다시 켭니다.
7잘 올라갔는지 확인
눈과 귀로 확인
- OLED 화면에 AIPet-XXXX 같은 이름이 잠깐 뜹니다. XXXX는 보드마다 다릅니다.
- 부저에서 켜지는 소리가 납니다.
- 잠시 뒤 화면에 얼굴이 나옵니다.
- 머리, 등, 턱의 터치 센서를 만지면 표정과 소리가 바뀝니다.
시리얼 모니터로 확인
- 오른쪽 위의 돋보기 아이콘(Serial Monitor)을 누릅니다.
- 오른쪽 아래 속도를 115200 baud로 맞춥니다.
- 보드의 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 Boot | Enabled |
| Flash Mode / Frequency | DIO / 40MHz |
| Partition Scheme | Huge APP (3MB No OTA/1MB SPIFFS) |
| 시리얼 모니터 | 115200 baud |
| 핀 | SDA 8 · SCL 9 · 터치 5/6/7 · 부저 10 |