ADXL345

배선

가속도계의 연결 방식은 아래 그림과 같습니다

참조 구성

[adxl345]
cs_pin: PB12
spi_bus: spi2 # 하드웨어 spi, 하드웨어 spi와 소프트웨어 spi 중 하나 선택. 기본 하드웨어 spi
# spi_software_mosi_pin: PB15 # 소프트웨어 spi, 하드웨어 spi와 소프트웨어 spi 중 하나 선택. 기본 하드웨어 spi
# spi_software_miso_pin: PB14
# spi_software_sclk_pin: PB13

[resonance_tester]
accel_chip: adxl345
#accel_chip_y: adxl345 bed
probe_points:
    100, 100, 20  # 일반적으로 히트베드의 정중앙, 사용자의 기계 실제 상황에 따라 수정하십시오

사용 설명서

가속도계 테스트 및 보정

종속 패키지 설치

주의사항

장치에 FlyOS-FAST 시스템이 실행 중인 경우, 시스템에 필요한 종속 항목이 사전 설치되어 있으므로 이 단계를 건너뛸 수 있습니다.
FLY가 아닌 상위 컴퓨터를 사용하는 경우, 반드시 아래 설치 작업을 완료하세요.
MobaXterm, PuTTY 등 SSH 도구를 사용하여 연결한 후 작업을 진행하는 것을 권장합니다.
본 튜토리얼은 라즈베리 파이를 기준으로 하며, 다른 플랫폼은 참고용입니다.

설치 단계

다음 명령어를 순서대로 실행하여 종속 패키지를 설치합니다.
설치 시간은 CPU 성능과 네트워크 상태에 따라 다르며, 일반적으로 10–20분이 소요되므로 완료될 때까지 기다려 주세요.
장치 메모리(RAM)가 너무 작으면 설치가 실패할 수 있습니다.

1단계: 시스템 종속 패키지 설치

sudo apt install python3-numpy python3-matplotlib libatlas-base-dev

2단계: Klipper 가상 환경 종속 패키지 설치

~/klippy-env/bin/pip install matplotlib numpy

가속도계 테스트

사전 조건

프린터가 귀환(Homing) 작업을 완료했어야 합니다.
Klipper 구성 파일에 가속도계가 올바르게 활성화되어 있는지 확인하세요.

테스트 명령어

Klipper 콘솔에서 다음 명령어를 입력합니다:

ACCELEROMETER_QUERY

여러 개의 가속도계가 연결된 경우, 칩을 지정하여 테스트할 수 있습니다:

ACCELEROMETER_QUERY CHIP=<ADXL 칩 이름>

<ADXL 칩 이름>을 실제 가속도계 식별자(예: adxl345)로 바꾸세요.

힌트

일부 구형 Klipper 버전은 ACCELEROMETER_QUERY를 두 번 실행해야 가속도 데이터를 얻을 수 있습니다.

일반적인 문제 처리

전원 차단 작업

가속도계 배선을 확인, 재연결 또는 교체하기 전에 프린터를 완전히 종료하고 전원 공급을 차단하세요. 전원이 켜진 상태에서 ADXL/LIS2DW/MPU/ICM 모듈을 삽입, 제거하거나 노출된 핀을 만지지 마세요.

첫 실행 실패: 일부 Klipper 버전에서는 명령 인식 지연이 있을 수 있습니다. 첫 실행 시 데이터가 반환되지 않으면 동일한 명령을 다시 한 번 실행하세요.
명령어 인식 불가: 여러 번 실행해도 알 수 없는 명령어가 표시되면 Klipper 버전이 너무 낮은 것일 수 있습니다. 다음을 권장합니다:
- Klipper를 최신 버전으로 업데이트
- 또는 최신 시스템(예: FlyOS-FAST 최신 버전)으로 재설치
Invalid adxl345 id: Invalid adxl345 id (got xx vs e5) 오류가 발생하면, 즉시 ACCELEROMETER_QUERY를 다시 한 번 실행하세요. 계속 오류가 발생하면 완제품 가속도계 배선, 어댑터 보드 또는 센서 모듈을 교체하여 교차 테스트하는 것이 좋으며, 고객이 직접 납땜 보충이나 납땜 지점 수리를 시도하지 않는 것이 좋습니다.
Invalid lis2dw / mpu / icm id: LIS2DW, MPU9250, ICM20948 등의 센서를 사용하는 경우, 구성 세그먼트 이름, 통신 버스 및 칩 모델이 실제 하드웨어와 일치하는지 확인하세요.
Unable to obtain response / timeout: 일반적으로 상위 컴퓨터와 가속도계 MCU 간의 통신 이상을 나타냅니다. USB/CAN 연결, [mcu] ID, cs_pin, spi_bus 또는 i2c_bus를 확인하세요.

결과 판단

정상 출력: 연속적인 데이터 스트림이 반환되면(아래 그림 참조) 가속도계가 정상적으로 작동하는 것이며, 공진 보상 측정을 진행할 수 있습니다.
오류 출력: 시간 초과, 데이터 없음 또는 통신 오류가 표시되면 다음을 순서대로 확인하세요:
1. 전원을 차단한 후 가속도계 배선이 단단히 고정되어 있는지 확인
2. 구성 파일의 센서 설정과 SPI가 올바른지 확인
3. 완제품 배선, 어댑터 보드 또는 센서 모듈을 교체하여 전원 공급/통신 문제를 진단하는 것이 우선

공진 테스트 일반적인 오류

오류 메시지	일반적인 원인	처리 방법
`No data received from accelerometer`	가속도계 미연결, SPI/I2C 배선 순서 오류, 전원 공급 이상	먼저 `ACCELEROMETER_QUERY`를 실행하여 통신이 정상인지 확인한 후 다시 테스트
`Insufficient axis data for shaper calibration`	이동 범위가 너무 작음, 가속도가 너무 낮음, 센서 판독값 노이즈 과다	테스트 범위 또는 `accel_per_hz` 증가, 가속도계가 단단히 고정되었는지 확인
`Frequency range too narrow`	벨트가 너무 느슨함, 기계적 공진 주파수가 측정 범위를 벗어남	벨트 장력, 기계 구조물 고정 확인; 필요 시 `max_freq` 낮추거나 `accel_per_hz` 증가
공진 그래프가 모두 노이즈이며 뚜렷한 피크 없음	센서가 단단히 고정되지 않음, 팬 진동 간섭, 배선 흔들림	전원 차단 후 센서 재고정, 테스트 시 팬 끄기, 신호선과 모터선 분리 배선
`SHAPER_CALIBRATE` 실행 후 출력 없음 또는 오류로 종료	Python 종속 항목 부족(numpy/matplotlib), 메모리 부족	이 문서 시작 부분의 종속 패키지 설치 단계를 따라 추가 설치; 대형 공진 그래프 계산에 더 많은 메모리가 필요할 수 있음
`Cannot test Z axis together with other axes`	`TEST_RESONANCES`가 Z축과 X/Y축을 동시에 지정함	Z축은 단독으로 테스트해야 하며, X/Y와 혼합하지 마세요
`Invalid POINT parameter`	`POINT=` 좌표 형식 오류 또는 `x,y,z` 세 값 누락	`POINT=100,100,20` 형식으로 작성
`Invalid NAME parameter`	출력 이름이 비어 있거나, 특수 문자 포함 또는 명령 요구 사항과 불일치	영어, 숫자, 밑줄 또는 하이픈으로 이름 지정
`No accelerometer measurements found`	테스트 과정에서 유효한 가속도 데이터를 수집하지 못함	먼저 `ACCELEROMETER_QUERY`를 실행한 후 센서 고정 및 통신 확인
`Unsupported output`	`OUTPUT=` 매개변수에 지원되지 않는 유형을 입력함	Klipper에서 지원하는 출력 유형에 따라 작성, 일반적으로 `resonances` 사용

ACCELEROMETER_QUERY는 정상이지만 공진 테스트가 계속 실패하는 경우, 다음 순서로 우선 확인하세요:

전원 차단 후 가속도계 표면이 테스트 대상 부품에 밀착되어 있는지, 완충 재료나 양면 테이프 헐거움이 없는지 확인합니다.
테스트 중 모델 냉각 팬, 핫엔드 팬 및 챔버 팬을 임시로 끕니다.
테스트 중 배선이 센서를 잡아당기거나 운동축에 걸리지 않는지 확인합니다.
테스트 진폭 증가: [resonance_tester]에서 accel_per_hz를 기본 75에서 100–150으로 점진적으로 높입니다.
툴보드(USB/CAN)의 가속도계를 사용하는 경우, 통신선이 모터선 또는 히트베드선 근처에 있지 않은지 확인합니다.

가속도계 보정

보정 단계

프린터가 귀환되었는지 확인합니다.
콘솔에서 다음 명령어를 입력하여 X, Y축 자동 보정을 시작합니다:
```
SHAPER_CALIBRATE
```
보정이 완료되면 구성을 저장합니다:
```
SAVE_CONFIG
```

단일 축 보정

단일 축만 보정해야 하는 경우 다음을 사용할 수 있습니다:

SHAPER_CALIBRATE AXIS=X

또는 X를 Y로 바꿉니다.

안전 주의사항

보정 과정에서 프린터가 심한 진동을 발생시킬 수 있습니다. 진동이 너무 심하면 즉시 비상 정지 버튼을 누르거나 M112 명령어를 보내 긴급 중지하세요.

진동 강도 조절

테스트 시 진동이 너무 심하면 accel_per_hz 매개변수 값을 적절히 낮출 수 있습니다(기본 75):

[resonance_tester]
accel_per_hz: 50

설정 및 튜닝 문제: 가속도계 하드웨어는 정상이지만 공진 보상 활성화 후 효과가 좋지 않거나, shaper_freq 설정이 부적절하거나, Pressure Advance와 Input Shaper 간 충돌 등의 문제는 공진 보상 및 압력 전진 설정 문제를 참조하세요.

설명: 위 단계는 대부분의 Klipper 기반 3D 프린터 공진 보상 구성에 적용됩니다. 실제 하드웨어 및 시스템 환경에 맞게 조정하세요.

배선​

참조 구성​

사용 설명서​

종속 패키지 설치​

설치 단계​

가속도계 테스트​

사전 조건​

테스트 명령어​

일반적인 문제 처리​

결과 판단​

공진 테스트 일반적인 오류​

가속도계 보정​

보정 단계​

단일 축 보정​

진동 강도 조절​

배선