rapi/README.md

Start Guide - LoadCell Measure

새로운 Raspberry Pi 5 환경에서 rapimeasure.py 실행을 위한 빠른 시작 가이드

작성일: 2026-01-12

---

구성

항목	요구사항
하드웨어	Raspberry Pi 5
OS	Raspberry Pi OS (64-bit)
연결	SSH 접속 가능 (Putty 등)
HX711	로드셀 + HX711 앰프 모듈

---

하드웨어 연결

먼저 HX711 모듈을 Raspberry Pi에 연결하세요:

HX711        Raspberry Pi 5
─────        ──────────────
VCC    →     Pin 1  (3.3V)
GND    →     Pin 6  (GND)
DT     →     Pin 29 (GPIO5)
SCK    →     Pin 31 (GPIO6)

---

실행 순서

#1단계: root 입장

su -

> 비밀번호 입력 (GPIO 접근에 root 권한 필요)

-------------------------------
#2단계: 시스템 패키지 업데이트

apt update

-------------------------------
#3단계: lgpio 개발 라이브러리 설치 (처음 1회 수행)

apt install -y liblgpio-dev

-------------------------------
#4단계: HX711 C++ 라이브러리 설치 (처음 1회 수행)

cd /tmp
git clone https://github.com/endail/hx711
cd hx711
make
make install
ldconfig

-------------------------------
#5단계: 프로젝트 폴더 이동

cd /home/shkim/rnd2/rapi

-------------------------------
#6단계: Python 가상환경 입장

source venv/bin/activate

> 프롬프트에 `(venv)`가 표시되면 성공

-------------------------------
#7단계: Python HX711 라이브러리 설치 (처음 1회 수행)

pip install hx711-rpi-py

-------------------------------
#8단계: 설치 확인

python3 -c "from HX711 import SimpleHX711; print('OK')"

> `OK` 출력되면 설치 완료

-------------------------------
#9단계: measure.py 실행

python3 rapimeasure.py

---

처음 SD카드 사용 시, 전체 명령어

# SSH 접속 후 실행
su -

# 시스템 패키지
apt update
apt install -y liblgpio-dev

# HX711 C++ 라이브러리
cd /tmp
git clone https://github.com/endail/hx711
cd hx711
make && make install && ldconfig

# 프로젝트 폴더
mkdir -p /home/shkim/rnd2/rapi
cd /home/shkim/rnd2/rapi

# Python 환경
python3 -m venv venv
source venv/bin/activate
pip install hx711-rpi-py

# 실행
python3 measure.py

---

재접속 시 실행 방법

이미 설치가 완료된 환경에서 재접속 후:

su -
cd /home/shkim/rnd2/rapi
source venv/bin/activate
python3 rapimeasure.py

---

키보드 명령어

키	기능
c	영점 조절 (tare)
p	일시정지
r	재시작
h	도움말
q	종료

---

설치 확인 체크리스트

단계	확인 명령어	예상 결과
lgpio	ls /usr/include/lgpio.h	파일 존재
HX711 C++	ls /usr/local/lib/libhx711*	.so 파일 존재
Python lib	pip list | grep hx711	hx711-rpi-py 표시
전체 확인	python3 -c "from HX711 import SimpleHX711; print('OK')"	OK