VSC Platform.io 커스텀보드 추가하기

목표: 제목 그대로 Visual Studio Code 확장 프로그램 Platform.io에 보드 목록에 없는 커스텀 보드를 추가해보자. 

환경: 맥 M1 Ventura 13.2.1 / VSC 1.81.1 / PlatformIO IDE 3.3.1

추가하고자 하는 보드: esp32-s3-devkitc-1-n16r8v (다른 보드 찾기)

현상: ESP32 웹서버 튜토리얼을 따라하고 있었는데 단순히 와이파이 연결해서 html 파일 요청하면 전송하는 아주 간단한 예제도 실행이 되지 않는 것이었다. 보드 이름이 뭔가 정확하지 않아보여서 다시 목록에서 내가 가지고 있는 보드를 찾아보았지만 보이지 않았다. 구글링을 해보니 커스텀 보드를 추가하는 방법에 대한 글들이 보였다. 

참고한 글:

https://community.platformio.org/t/how-do-you-set-up-a-new-board-esp32-s3-n16r8/32306

How do you set up a new board ESP32-S3 N16R8

https://docs.platformio.org/en/stable/platforms/creating_board.html

Custom Embedded Boards — PlatformIO v6.1 documentation

추가하기: 

먼저 Platform.io가 설치되어 있는 경로를 알아야하는데 나의 기준으로 root 디렉터리에 .platformio에 설치되어 있었다. 근데 닷 파일이라서 숨겨져서 안보이는 경우가 있을텐데 명령어로는 ls -a, Finder에서는 cmd +  shift + . (dot)을 누르면 숨겨져 있던 파일들이 보이게 된다. 

그 다음은 .platformio/platforms/*/boards/ 이 경로를 찾아들어가준다. 그러면 이미 있던 보드들의 json 파일들이 쭉 보일 거다. 

이제는 우리의 커스텀 보드의 JSON파일을 추가할 차례이다. 아래의 링크에서 필요한 보드의 JSON 파일을 찾아주고 다운로드하거나 복사해준다. 그리고 .platformio/platforms/*/boards/ 이 경로에 JSON 파일을 넣어주면 끝이다. 터미널에서 바로 만들어줘도 되고 나는 저 경로를 VSCode로 열어서 다른 JSON 파일과 비교도 해볼겸 새로운 파일을 생성해서 코드를 붙여넣어주었다. 

https://github.com/handledexception/platform-espressif32/blob/deb6aa342245ad7bcb3d9ed69050f203779833ab/boards/esp32-s3-devkitc-1-n16r8v.json

그리고 VSCode를 다시 부팅해주면 새로운 프로젝트를 생성할 때 방금 추가해준 커스텀 보드가 짠하고 나타날 거다. 

그 보드와 함께 다음 여정을 계속 해나가면 된다.

튜토리얼 처럼 아주 세세하게 적어두지는 않았는데 혹시 궁금한 점이 있거나 막히는 부분이 있다면 댓글로 문의 주세요 :)

 

JSON 파일 샘플

{
    "build": {
      "arduino":{
        "ldscript": "esp32s3_out.ld",
        "partitions": "default_16MB.csv",
        "memory_type": "qio_opi"
      },
      "core": "esp32",
      "extra_flags": [
        "-DARDUINO_ESP32S3_DEV",
        "-DBOARD_HAS_PSRAM",
        "-DARDUINO_USB_MODE=1",
        "-DARDUINO_USB_CDC_ON_BOOT=1"
      ],
      "f_cpu": "240000000L",
      "f_flash": "80000000L",
      "flash_mode": "qio",
      "psram_type": "opi",
      "hwids": [
        [
          "0x303A",
          "0x1001"
        ]
      ],
      "mcu": "esp32s3",
      "variant": "esp32s3"
    },
    "connectivity": [
      "wifi",
      "bluetooth"
    ],
    "debug": {
      "default_tool": "esp-builtin",
      "onboard_tools": [
        "esp-builtin"
      ],
      "openocd_target": "esp32s3.cfg"
    },
    "frameworks": [
      "arduino",
      "espidf"
    ],
    "name": "Espressif ESP32-S3-DevKitC-1-N16R8V (16 MB QD, 8MB PSRAM)",
    "upload": {
      "flash_size": "16MB",
      "maximum_ram_size": 327680,
      "maximum_size": 16777216,
      "require_upload_port": true,
      "speed": 921600
    },
    "url": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html",
    "vendor": "Espressif"
  }