CMA3000-D0x Accelerometer

지원 칩, 동작 모드와 버스

이 드라이버는 VTI CMA3000-D0x 3축 가속도계를 지원합니다. 기준 자료는 `CMA3000-D0X Product Family Specification 8281000A.02.pdf`이며 원문은 VTI 웹사이트를 링크합니다. 문서 작성자는 Texas Instruments의 Hemanth V입니다.

각 모드에는 시간과 g 값을 포함하는 임계값을 정의할 수 있습니다. 정확한 범위와 동작은 제품 명세를 참조해야 합니다.

CMA3000은 I2C와 SPI 인터페이스 중 하나를 상호 배타적으로 사용합니다. 현재 이 드라이버는 I2C 통신만 지원합니다. 초기 버스 모드는 비휘발성 메모리에 저장되어 있으며 이후 버스 인터페이스 명령으로 바꿀 수 있습니다.

드라이버는 가속도 데이터를 Linux input subsystem으로 보고합니다. 자유 낙하를 감지하면 값 1의 `ABS_MISC` 이벤트를 생성합니다. 초기 기본값을 위해 platform data를 구성해야 합니다.

CMA3000-D0x Accelerometer
=========================

Supported chips:
* VTI CMA3000-D0x

Datasheet:
  CMA3000-D0X Product Family Specification 8281000A.02.pdf
  <http://www.vti.fi/en/>

:Author: Hemanth V <hemanthv@ti.com>


Description
-----------

CMA3000 Tri-axis accelerometer supports Motion detect, Measurement and
Free fall modes.

Motion Detect Mode:
    Its the low power mode where interrupts are generated only
    when motion exceeds the defined thresholds.

Measurement Mode:
    This mode is used to read the acceleration data on X,Y,Z
    axis and supports 400, 100, 40 Hz sample frequency.

Free fall Mode:
    This mode is intended to save system resources.

Threshold values:
    Chip supports defining threshold values for above modes
    which includes time and g value. Refer product specifications for
    more details.

CMA3000 chip supports mutually exclusive I2C and SPI interfaces for
communication, currently the driver supports I2C based communication only.
Initial configuration for bus mode is set in non volatile memory and can later
be modified through bus interface command.

Driver reports acceleration data through input subsystem. It generates ABS_MISC
event with value 1 when free fall is detected.

Platform data need to be configured for initial default values.

플랫폼 데이터 필드

보드 코드는 다음 platform data 필드로 센서의 초기 기본값을 지정합니다. `fuzz_x`, `fuzz_y`, `fuzz_z`는 각 축 입력의 잡음 허용량이며, 나머지 필드는 g 범위·기본 모드·움직임 및 자유 낙하 임계값을 정합니다.

Platform Data
-------------

fuzz_x:
    Noise on X Axis

fuzz_y:
    Noise on Y Axis

fuzz_z:
    Noise on Z Axis

g_range:
    G range in milli g i.e 2000 or 8000

mode:
    Default Operating mode

mdthr:
    Motion detect g range threshold value

mdfftmr:
    Motion detect and free fall time threshold value

ffthr:
    Free fall g range threshold value

Linux input 인터페이스와 이벤트 범위

input 드라이버 버전은 1.0.0입니다. 장치 ID는 bus `0x18`, vendor `0x0`, product `0x0`, version `0x0`이며 장치 이름은 `cma3000-accelerometer`입니다.

X/Y/Z는 absolute event code 0/1/2로 보고되고 예제 범위는 -8000~8000, fuzz는 200입니다. Misc code 40은 0~1 범위이며 자유 낙하 감지 시 `ABS_MISC=1`을 보고하는 데 사용됩니다.

Input Interface
---------------

Input driver version is 1.0.0
Input device ID: bus 0x18 vendor 0x0 product 0x0 version 0x0
Input device name: "cma3000-accelerometer"

Supported events::

  Event type 0 (Sync)
  Event type 3 (Absolute)
    Event code 0 (X)
      Value     47
      Min    -8000
      Max     8000
      Fuzz     200
    Event code 1 (Y)
      Value    -28
      Min    -8000
      Max     8000
      Fuzz     200
    Event code 2 (Z)
      Value    905
      Min    -8000
      Max     8000
      Fuzz     200
    Event code 40 (Misc)
      Value      0
      Min        0
      Max        1
  Event type 4 (Misc)

레지스터 모드와 임계값 계산

`mode` 4가 기본 Motion Detect이고, 측정 모드는 40/100/400Hz를 각각 값 3/1/2로 선택합니다. 자유 낙하 모드는 100Hz 값 5와 40Hz 값 6을 제공합니다. 임계값을 계산할 때는 선택한 2G 또는 8G 범위와 FFTMR 샘플 주기를 반드시 함께 적용해야 합니다.

Register/Platform parameters Description
----------------------------------------

mode::

        0: power down mode
        1: 100 Hz Measurement mode
        2: 400 Hz Measurement mode
        3: 40 Hz Measurement mode
        4: Motion Detect mode (default)
        5: 100 Hz Free fall mode
        6: 40 Hz Free fall mode
        7: Power off mode

grange::

        2000: 2000 mg or 2G Range
        8000: 8000 mg or 8G Range

mdthr::

        X: X * 71mg (8G Range)
        X: X * 18mg (2G Range)

mdfftmr::

        X: (X & 0x70) * 100 ms (MDTMR)
           (X & 0x0F) * 2.5 ms (FFTMR 400 Hz)
           (X & 0x0F) * 10 ms  (FFTMR 100 Hz)

ffthr::

       X: (X >> 2) * 18mg (2G Range)
       X: (X & 0x0F) * 71 mg (8G Range)