AI 도구로 miniSMU 및 µSMU 스크립트 작성하기

어떤 측정이 필요한지는 정확히 알지만 Python 코드를 처음부터 작성하는 것은 익숙하지 않은 태양광 연구자, 배터리 과학자, 재료 엔지니어, 학생이라면 AI 코딩 어시스턴트의 도움을 받을 수 있습니다. Claude, ChatGPT, Gemini 같은 도구에 실험 내용을 일상적인 말로 설명하면 동작하는 코드를 받을 수 있습니다. 프로그래밍 경험은 필요하지 않습니다.

다만 한 가지 문제가 있습니다. 이러한 도구는 방대한 양의 코드로 학습되었지만, miniSMU나 µSMU Python 라이브러리의 세부 사항까지는 모를 수 있습니다. 이 가이드는 AI 도구가 알아야 할 모든 것을 알려 주는, 바로 쓸 수 있는 컨텍스트 템플릿으로 이 문제를 해결합니다.

ℹ

핵심: AI 도구는 다루는 라이브러리에 대한 컨텍스트가 주어졌을 때 가장 잘 작동합니다.

10년 전에 읽은 책의 내용을 떠올리려 할 때와, 책을 눈앞에 펼쳐 놓고 참고할 때를 비교해 보십시오. AI 모델이 학습 과정에서 익힌 지식과 ‘컨텍스트 윈도’에 있는 지식의 차이도 이와 비슷합니다.

이 가이드는 AI 어시스턴트가 miniSMU나 µSMU용으로 정확하고 동작하는 코드를 작성하도록 돕는, 바로 쓸 수 있는 컨텍스트 템플릿을 제공합니다.

컨텍스트 템플릿이란?

컨텍스트 템플릿은 라이브러리의 API, 자주 쓰는 패턴, 주의해야 할 함정을 정리한 참고 문서입니다. 이를 AI 어시스턴트에게 주는 것은 동료에게 도움을 청하기 전에 요약 자료를 건네주는 것과 같아서, 훨씬 좋은 결과를 얻을 수 있습니다.

저희는 두 Python 라이브러리 모두에 대해 컨텍스트 템플릿을 관리하고 있습니다. 템플릿은 다음과 같이 사용합니다.

어떤 AI 어시스턴트든 대화를 시작할 때 처음에 붙여 넣기
프로젝트 폴더에 파일로 저장하기(Claude Code는 CLAUDE.md, Copilot/Codex는 AGENTS.md). 그러면 AI가 자동으로 읽어 들입니다
시스템 프롬프트나 사용자 지정 지침에 추가하기

템플릿 받기

miniSMU

miniSMU MS01 템플릿은 2채널 동작, USB 및 Wi-Fi 연결, 하드웨어 I-V 스윕, 전류 레인지 제어, 4선식 켈빈 측정, 데이터 스트리밍을 다룹니다.

템플릿 받기: GitHub에서 보기 - ‘Raw’를 클릭한 다음 전체를 복사하십시오

µSMU

µSMU 템플릿은 USB 시리얼 연결, 출력 제어, 전압/전류 측정, 전류 제한, 소프트웨어 기반 I-V 스윕을 다룹니다.

템플릿 받기: GitHub에서 보기 - ‘Raw’를 클릭한 다음 전체를 복사하십시오

시작하기

위 링크에서 템플릿을 복사합니다(‘Raw’ 클릭, 전체 선택, 복사)
어떤 AI 도구든 대화를 시작할 때 붙여 넣습니다
일상적인 말로 측정 내용을 설명합니다
반복해서 다듬습니다 - AI에게 수정, 기능 추가, 문제 해결을 요청합니다

간단한 것부터 시작하십시오. 먼저 장치에 연결하여 측정을 한 번 수행하는 기본 스크립트를 요청하십시오. 그것이 동작하면 스윕을 추가하고, 그다음 CSV 내보내기, 그다음 그래프를 추가해 달라고 요청하십시오. 한 번에 모든 것을 요청하는 것보다 단계적으로 쌓아 가는 편이 더 안정적이며, 코드가 커지는 과정에서 코드를 더 잘 이해할 수 있습니다.

AI가 더 좋은 결과를 내도록 도우려면 다음을 알려 주십시오.

사용 중인 운영 체제와 COM 포트(예: “Windows를 사용하고 있고 장치는 COM3에 연결되어 있습니다”)
피측정 소자에서 예상되는 전류 범위
원하는 출력 형식(CSV, matplotlib 그래프, 콘솔 출력)
안전 기능 요청: “보호 한계를 추가하고, 오류가 발생하면 출력이 반드시 꺼지도록 해 주세요”

프롬프트 예시와 생성된 코드

이 워크플로가 실제로 어떤 모습인지 보여 드리기 위해, 실제 프롬프트와 AI 어시스턴트가 생성하는 코드의 예를 소개합니다.

태양전지 I-V 특성 평가

“miniSMU MS01로 태양전지의 I-V 곡선을 -0.2 V부터 0.8 V까지 101포인트로 측정하는 Python 스크립트를 작성해 주세요. 조사 세기 100 mW/cm², 전지 면적 1 cm²를 가정하여 Voc, Isc, 충진율, 효율을 계산하고 출력해 주세요. 데이터는 CSV 파일로 저장해 주세요.”

안전 차단 기능을 갖춘 LED 테스트

“miniSMU로 LED에 0부터 3.5 V까지 전압을 스윕하는 스크립트를 만들어 주세요. LED를 보호하기 위해 전류가 15 mA를 넘으면 즉시 멈춰야 합니다. 측정이 끝나면 I-V 곡선을 그래프로 그려 주세요.”

리튬 이온 배터리 충방전 사이클

“리튬 이온 배터리의 전체 충전 및 방전 사이클을 100 mA로 수행하는 스크립트를 작성해 주세요. 4.2 V까지 CC 충전, 전류가 10 mA로 떨어질 때까지 CV 유지, 5분 휴지, 3.0 V까지 CC 방전, 그리고 한 번 더 휴지를 포함해 주세요. 모든 데이터를 타임스탬프와 함께 CSV에 기록해 주세요.”

여러 시료 일괄 테스트

“여러 시료를 테스트해야 합니다. 시료 ID를 묻고, -1 V부터 1 V까지 I-V 스윕을 실행하고, 결과를 ‘sample_[ID].csv’로 저장한 다음, 계속할지 묻는 과정을 반복하는 스크립트를 작성해 주세요.”

시간에 따른 저항 모니터링

“1 mA를 인가하고 전압을 측정하여 저항을 모니터링하는 스크립트를 작성해 주세요. 5분 동안 1초마다 측정하고, 실시간으로 갱신되는 그래프를 보여 주세요.”

문제가 생겼을 때

AI가 준 코드가 실행되지 않아도 걱정하지 마십시오! 이는 과정의 일부로서 흔히 있는 일입니다(점점 줄어들고는 있습니다). 오류 메시지를 복사하여 다시 붙여 넣고 AI에게 고쳐 달라고 요청하십시오. 대개 바로 문제를 찾아냅니다.

자주 발생하는 문제와 빠른 해결 방법은 다음과 같습니다.

‘Module not found’ - 먼저 라이브러리를 설치하십시오.

pip install minismu-py  # For miniSMU
pip install usmu-py      # For µSMU

장치를 찾을 수 없음 - AI에게 다음과 같이 요청하십시오. “장치를 찾을 수 있도록 사용 가능한 시리얼 포트 목록을 표시하는 코드를 추가해 주세요”

측정값이 예상과 다름 - 다음과 같이 요청하십시오. “적절한 보호 한계를 추가하고, 각 설정이 어떤 역할을 하는지 설명해 주세요”

참고로, Python 라이브러리는 miniSMU 데스크톱 앱과 정확히 같은 하드웨어 명령을 사용하므로, 장치를 어떤 방식으로 제어하든 측정 정확도는 동일합니다. AI는 코드 작성을 도울 뿐, 전기적 측정 자체에는 영향을 주지 않습니다.

더 읽을거리

태양전지 I-V 테스트를 위한 켈빈 연결 - 정확한 특성 평가를 위한 4선식 측정 활용
miniSMU 펌웨어 업데이트 방법 - 하드웨어 스윕과 켈빈 측정 등 최신 기능 이용하기
miniSMU Python 라이브러리 - 전체 소스 코드와 문서
µSMU Python 라이브러리 - 전체 소스 코드와 문서

템플릿에 빠진 내용을 발견하셨거나 공유하고 싶은 유용한 코드 패턴이 있으십니까? 각 저장소의 CLAUDE.md 및 AGENTS.md 파일이 기준이 되는 원본이며, 풀 리퀘스트를 환영합니다.