# 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)
```

---

## 실행 순서

```bash
#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카드 사용 시, 전체 명령어

```bash
# 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
```

---

## 재접속 시 실행 방법

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

```bash
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 |