Arduino CLI 윈도우에서 포터블로 사용하기.

-
arduino-ide_2.3.6_Windows_64bit 기준으로 작성 했습니다.

이 문서는 다음 항목으로 구성 됩니다.
설치.
사용법.
명령어.

=======================================
설치.
=======================================
- Arduino CLI 다운로드.
https://www.arduino.cc/en/software/ 에서 arduino-cli_#.#.#_Windows_64bit.zip 을 다운로드 받아 압축을 풉니다. #는 버전번호로 최신버전을 받으면 됩니다.

- 이 다음부터는 아래 폴더구조라고 가정합니다. 
폴더는 아래 설정에 따라 설치 중에 자동으로 만들어 집니다.
 D:\Tools\ArduinoCLI\
  ├─ arduino-cli.exe        ← ZIP에서 꺼낸 실행 파일
  ├─ arduino-cli.yaml       ← 포터블 설정 파일(직접 만듦)
  ├─ data\                  ← 코어/툴/캐시(Arduino15 대체)
  ├─ user\            ← 스케치/라이브러리
  └─ libraries\               ← 실행용 배치파일(선택)

- arduino-cli.yaml 파일 생성.
arduino-cli.exe config init --config-file .\arduino-cli.yaml

- arduino-cli.yaml 편집. 
아래와 같이 편집해 주세요.
자세한 설명은 URL을 참조하세요.
https://docs.arduino.cc/arduino-cli/configuration/ 

아래 명령어로 설정을 확인할 수 있습니다.
arduino-cli --config-file arduino-cli.yaml config dump

D:\Tools\ArduinoCLI\arduino-cli.yaml
board_manager:
    additional_urls:
daemon:
    port: "50051"
directories:
    data: .\data
    downloads: .\downloads
    user: .\user
    builtin.libraries: .\libraries
library:
    enable_unsafe_install: false
logging:
    file: .\arduino-cli.log
    format: text
    level: info

- arduino-cli.exe가 있는 폴더에서 터미널을 엽니다.
파워쉘 말고 명령프롬프트(cmd.exe) 로 여세요.

- !중요! 
명령어를 칠때 항상 arduino-cli.yaml를 지정해 줘야 합니다.
지정하지 않으면 %LOCALAPPDATA%\Arduino15 에 각종 파일이 설치됩니다.

예) 
arduino-cli --config-file arduino-cli.yaml core update-index
arduino-cli --config-file arduino-cli.yaml core upgrade

- 아두이노 코어 설치 및 보드 설치.
arduino-cli
참고로 data 폴더에 설치 됩니다.

arduino-cli --config-file arduino-cli.yaml core update-index
arduino-cli --config-file arduino-cli.yaml core install arduino:avr

설치 확인.
arduino-cli --config-file arduino-cli.yaml core list


- esp32 보드 코어 설치.
esp32 보드가 아니면 안해도 됩니다.

arduino-cli --config-file arduino-cli.yaml config set board_manager.additional_urls https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

arduino-cli --config-file arduino-cli.yaml core update-index
arduino-cli --config-file arduino-cli.yaml core install esp32:esp32

arduino-cli --config-file arduino-cli.yaml core list
arduino-cli --config-file arduino-cli.yaml core search esp32

- 설치 오류시.
다운로드 오류가 나면 arduino-cli.yaml 을 열어 아래 내용을 추가해 주세요.
네트워크 시간 늘림.
network:
  timeout: 300s 

아래 명령어로 다운로드만 받아 복사합니다.  
arduino-cli --config-file arduino-cli.yaml core download esp32:esp32 --verbose

--verbose 옵션으로 실행하면 실패한 파일의 URL이 보이는데 크롬이나 다른 브라우저에서 다운로드 받습니다.  arduino-cli.yaml에서 downloads: 옵션에서 지정한 폴더 안에 \packages 폴더에 다운로드 받은 파일을 복사합니다. 
다운로드에 실패할 때마다 위의 것을 반복합니다. 아마 arduino-cli 의 다운로드 기능에 문제가 있는거 같습니다.

모든 다운로드가 완료되었으면 아래 명령어로 설치합니다.
arduino-cli --config-file arduino-cli.yaml core install esp32:esp32 --verbose

이래도 안되면 버전을 지정해 봅니다.
arduino-cli --config-file arduino-cli.yaml core download esp32:esp32@3.3.2 --verbose
arduino-cli --config-file arduino-cli.yaml core install esp32:esp32@3.3.2 --verbose

=======================================
사용법.
=======================================

- 사용할 보드의 fqbn 찾기.
arduino-cli --config-file arduino-cli.yaml board listall | findstr /I "esp32s3"

ESP32S3 Dev Module                          esp32:esp32:esp32s3

여기서 esp32:esp32:esp32s3 를 기억 합니다.

- 연결된 보드 목록.
arduino-cli --config-file arduino-cli.yaml board list
여기서 COM7 포트를 기억 합니다.

- 생성.
arduino-cli --config-file arduino-cli.yaml sketch new sketchbook\Test

- 연결.
attach하면 sketch.yaml 파일이 생성되고 --fqbn이나 --port 플래그를 입력할 필요가 없습니다.
혹은 수동으로 해도 됩니다.
arduino-cli --config-file arduino-cli.yaml board attach -b esp32:esp32:esp32s3 -p COM5 "sketchbook\test"

- sketch.yaml 설정.
sketch.yaml 을 편집기에서 설정합니다. 아래 url을 참조하세요.
https://arduino.github.io/arduino-cli/1.3/sketch-project-file/

위에서 찾은 fqbn 보드의 설정을 보는 방법. 
arduino-cli --config-file arduino-cli.yaml board details -b esp32:esp32:esp32s3

이런 텍스트가 출력 되는데 오른쪽의 값 중에서 하나를 골라 설정합니다.
속도가 115200라면 UploadSpeed=115200 으로 설정합니다.
Option:        Upload Speed                                                                UploadSpeed
               921600                                         ✔                            UploadSpeed=921600
               115200                                                                      UploadSpeed=115200

간단한 sketch.yaml 설정.
default_fqbn: esp32:esp32:esp32s3:UploadSpeed=921600,USBMode=hwcdc,CDCOnBoot=cdc,PartitionScheme=huge_app,CPUFreq=240,FlashMode=qio,FlashSize=16M,PSRAM=opi  
default_port: COM7
default_port_config:
  baudrate: 921600
default_protocol: serial

프로파일을 사용한 sketch.yaml 설정.
코드는 하나 인데 보드가 여러가지인 경우 혹은 이외의 다양한 설정이 필요한 경우 프로파일을 여러개 설정해 사용할 수 있습니다.
!주의! 프로파일을 사용하면 전역으로 설치된 라이브러리가 무시되므로 따로 설정해야 합니다.
아래와 같이 프로파일 이름을 지정해 컴파일 합니다.
arduino-cli compile --profile esp32s3
혹은 default_profile: esp32s3 같이 기본 프로파일을 지정할 수 있습니다.


default_profile: esp32s3

profiles:
  esp32s3:
    notes: ESP32-S3-WROOM-1 N16R8 development configuration
    fqbn: esp32:esp32:esp32s3:USBMode=hwcdc,PartitionScheme=huge_app,CPUFreq=240,FlashMode=qio,FlashSize=16M,UploadSpeed=921600,PSRAM=opi    
    platforms:
      - platform: esp32:esp32
        platform_index_url: https://espressif.github.io/arduino-esp32/package_esp32_index.json
    libraries:
      - dir: libraries/ESP32-audioI2S-master

    port: COM7
    protocol: serial
    port_config:
      baudrate: 921600


- 컴파일 + 업로드 + 모니터.
arduino-cli --config-file arduino-cli.yaml compile --export-binaries --upload --port COM7 "sketchbook\test" && arduino-cli --config-file arduino-cli.yaml monitor -p COM7 -c 921600 --timestamp


- 컴파일 - attach 했을때.
arduino-cli --config-file arduino-cli.yaml compile --export-binaries "sketchbook\test"
- 컴파일, 업로드 오류가 나면 --verbose 플래그를 추가하면 상세한 로그를 볼 수 있습니다.
프로젝트 폴더에 build 폴더가 생성됩니다. 여기에 바이너리가 추가 됩니다.
- 컴파일 - attach 안 했을때.
arduino-cli --config-file arduino-cli.yaml compile --export-binaries --fqbn esp32:esp32:esp32s3 sketchbook\test
- 업로드.
arduino-cli --config-file arduino-cli.yaml upload -p COM5 --fqbn esp32:esp32:esp32s3 sketchbook\test
- 컴파일, 업로드 동시 실행.
arduino-cli --config-file arduino-cli.yaml compile --export-binaries -u -p COM5 --fqbn esp32:esp32:esp32s3 sketchbook\test
- 클린.
arduino-cli --config-file arduino-cli.yaml compile --clean

- 모니터.
arduino-cli monitor -p COM7

arduino-cli monitor -p COM7
arduino-cli monitor -p COM7 -c 921600 --timestamp
arduino-cli monitor -p COM7 --config baudrate=921600
arduino-cli monitor -p COM7 -b esp32:esp32:esp32_family
arduino-cli --config-file arduino-cli.yaml monitor -p COM7 -c baudrate=921600

시리얼 포트 정보.
arduino-cli monitor -p COM7 --describe

=======================================
명령어.
=======================================

- arduino-cli upgrade.
ZIP로 설치했으면, 최신 ZIP을 받아서 실행 파일만 교체하면 됩니다.

- --config-file arduino-cli.yaml 로 설정파일을 지정하지 않으면 %LOCALAPPDATA%\Arduino15 폴더에 설치 됩니다.

- --verbose 플래그를 추가하면 세부 정보를 볼 수 있습니다. 컴파일, 업로드 등 오류 시에 유용.
arduino-cli --config-file arduino-cli.yaml core download esp32:esp32 --verbose

- 실행 옵션.
arduino-cli help
arduino-cli compile -h

- 버전.
arduino-cli --config-file arduino-cli.yaml version

- 설정.
arduino-cli --config-file arduino-cli.yaml config dump

- 설치된 코어 목록.
arduino-cli --config-file arduino-cli.yaml core list

- 설치된 보드 목록.
arduino-cli --config-file arduino-cli.yaml board listall

- 설치된 라이브러리 목록.
arduino-cli --config-file arduino-cli.yaml lib list

- 현재 연결된 보드 목록.
arduino-cli --config-file arduino-cli.yaml board list

- 업데이트.
arduino-cli --config-file arduino-cli.yaml update
arduino-cli --config-file arduino-cli.yaml upgrade
혹은
arduino-cli --config-file arduino-cli.yaml core update-index
arduino-cli --config-file arduino-cli.yaml core upgrade
arduino-cli --config-file arduino-cli.yaml lib update-index
arduino-cli --config-file arduino-cli.yaml lib upgrade

- 프로젝트 생성.
arduino-cli --config-file arduino-cli.yaml sketch new sketchbook\test

- 보드 정보. COM 포트 조회.
arduino-cli --config-file arduino-cli.yaml board details esp32:esp32:esp32s3

- 라이브러리 설치 방법.
조회.
arduino-cli --config-file arduino-cli.yaml lib search "ESP32-audioI2S"
설치.
arduino-cli --config-file arduino-cli.yaml lib install "ESP32-audioI2S"
설치 - 버전지정.
arduino-cli --config-file arduino-cli.yaml lib install "ESP32-audioI2S@3.4.2"
설치 - url.
arduino-cli --config-file arduino-cli.yaml lib install --git-url https://github.com/schreibfaul1/ESP32-audioI2S
설치 - zip.
arduino-cli --config-file arduino-cli.yaml lib install lib install --zip-path ""C:\Users\test\Downloads\ESP32-audioI2S-3.4.2.zip""

삭제.
arduino-cli --config-file arduino-cli.yaml lib uninstall "ESP32-audioI2S"
삭제 - 폴더 삭제.
arduino-cli.yaml의 directories.user 에 설정한 폴더에 libraries 폴더 삭제.

설치된 라이브러리 목록.
arduino-cli --config-file arduino-cli.yaml lib list



arduino-cli --config-file arduino-cli.yaml compile --export-binaries --upload --port COM7 "sketchbook\test" && arduino-cli monitor -p COM7 -c 921600

댓글

댓글 쓰기

이 블로그의 인기 게시물

콘탁 Kontakt, KOMPLETE 저렴한 구입 방법.

-
6월 여름할인가 기준으로 Kontakt 399달러를 124달러에 구매할 수 있습니다. KOMPLETE 599달러를 323달러에 구매할 수 있습니다. 방법을 대략 설명하면 1. 콘탁 무료 라이브러리 받음. 2. Native Instrument에 무료 라이브러리 등록. 3. Kontakt 구매시 Crossgrade로 구매.(6월 여름할인으로 124달러) 4. KOMPLETE 구매시 Upgrade로 구매.(6월 여름할인으로 199달러) Kontakt 가격. 할인전 399달러. Crossgrade 249달러. Crossgrade 여름할인 124달러. KOMPLETE 가격. 할인전 599달러. Upgrade 399달러. Upgrade 여름할인 199달러. ////////////////////////////// 추가 Native Access에 등록할 수 있는 무료버전이 더 있어 추가합니다. arcane  https://www.embertone.com/instruments/arcane.php JAY MAAS SIGNATURE SERIES DRUMS LITE EDITION  https://www.roomsound.com/products/jaymaas/ projectsam the free orchestra  https://projectsam.com/libraries/the-free-orchestra/ ////////////////////////////// ========================================== 1. 아래 링크의 무료 버전을 구입합니다. https://www.embertone.com/instruments/arcane.php 2. Native Instrument에 계정을 생성합니다. 기존 계정이 있으면 다음으로 넘어갑니다. https://www.native-instruments.com 3. Native Instrumen...
자세한 내용 보기

대성 산업 탁상 시계 DS-173 메뉴얼

-
이미지
대성 산업 탁상 시계 DS-173 메뉴얼 입니다. 3년 넘게 2개를 사용하고 있는데 망가지지 않고 평생AS도 되는 물건이라 계속 사용하기 위해 글 남겨 놓습니다. 개인 메뉴얼 보관용이기도 합니다. 버튼이 A, B, C, D 이렇게만 되어 있어 설정이 어렵습니다. 전원 코드 뽑으면 시간도 이상하게 바뀌고 알람 설정하기도 쉽지 않습니다. 인터넷 검색해도 메뉴얼이 나오지 않아 난감해 하다 집에서 메뉴얼을 찾았습니다. 정식 메뉴얼인지는 확실치 않고 구입할 때 받은 메뉴얼입니다. 사용하고 있는 다른 분들께도 도움이 되길 바랍니다. 문제가 있고 내려 달라는 요청이 있으면 자진삭제 하겠습니다.
자세한 내용 보기

샤오신 패드 12.7 2025 사용기, 충전기에 대해.

-
이미지
- 추가. 애플 118w 호환 충전기로 고속충전 되네요. 45w 충전 됐습니다. 9-10v 에서 4.5a 출력 됩니다. 충전기에 표시된 출력은 다음과 같습니다. Output: 5V-20V 5.9A PD/QC3.0 ////////////////////////////////////////// 샤오신 패드 12.7 2025 사용 후기 가격 및 구성 직구 가격: 본체 185,000원, 펜 22,000원 (총 207,000원) 장점 - 품질 가격을 떠나서 전체적으로 마감과 외관이 매우 우수합니다. - 성능 아이패드 2024 에어 13 M2와 비교해 인터넷 서핑, 유튜브 시청 등 일상적인 사용에서는 체감 성 능 차이가 거의 없습니다. 단점 - 반글화 문제 반글화 처리가 번거롭고, 소프트웨어 업데이트 시 다시 원상복구되는 경우가 있습니다. 글로벌 롬 을 올리고 업데이트를 막는 방법도 있지만, 이 역시 번거롭습니다. - 화면 비율 16:10 화면비라서, 좀 더 정사각형에 가까웠으면 더 좋았을 것 같습니다. - 충전 방식 충전이 다소 까다롭습니다. 글로 썼더니 복잡해서 정리해 봤습니다. 충전규격 충전기에 표시된 글자 충전 가능 여부 PPS PPS DC 5~11V 4.5A   충전 가능. 구형충전기 5V 2A (2A의 숫자는 충전기에 따라 다르며, 높을수록 충전 빠름.)   충전 가능. PD, QC 5V 3A, 9V 5A, 12V 3A (한꺼번에 여러가지 표시)   충전회로에 따라 될 수도 있고 안 될 수도 있음. 하지만 확실한건 USB-C 전류 테스터로 충전 상태를 확인해 봐야 압니다.  케이블이 문제일 수도 있으니 아래 케이블 항목을 보세요. -- PPS(Programmable Power Supply) 규격: DC 5~11V 4.5A로 충전해야 하며, 현재 이 규격을 지 원하는 충전기와 케이블이 많지 않습니다. -- 호환성 문제. 충전기나 케이블의 보호회로가 맞지 않으면 충전기가 리셋되거나, 30W약 3A 이상 전 류를 요구할 때 ...
자세한 내용 보기