samples/shields/x_nucleo_iks02a1/standard/README.html · samples/shields/x_nucleo_iks02a1/standard/README.rst 공식 원문 ↗

Zephyr 3.7.0 · Samples · Shields · Sensors

X-NUCLEO-IKS02A1 Standard Mode

Mode 1에서 magnetic field, temperature, acceleration과 gyroscope를 2초마다 표시합니다.

Official pathsamples/shields/x_nucleo_iks02a1/standard/README.html
Source filesamples/shields/x_nucleo_iks02a1/standard/README.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

Arduino I2C source path, multiple-instance 제한과 exact dashboard를 보존합니다.

Magnetic

IIS2MDC

Motion

IIS2DLPC · ISM330DHCX

Mode

Standard 1

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 9DFB30E93E04BF164AA55A6B73AB83450938D58CD04E94CB6CAC3906FCF476BE
.. zephyr:code-sample:: x-nucleo-iks02a1-std
   :name: X-NUCLEO-IKS02A1 shield - Standard (Mode 1)
   :relevant-api: sensor_interface

   Interact with all the sensors of an X-NUCLEO-IKS02A1 shield using Standard mode.

Overview
********
This sample is provided as an example to test the X-NUCLEO-IKS02A1 shield
configured in Standard mode (Mode 1).
Please refer to :ref:`x-nucleo-iks02a1` for more info on this configuration.

This sample enables all sensors of a X-NUCLEO-IKS02A1 shield, and then
periodically reads and displays data from the shield sensors:

- IIS2MDC 3-Axis magnetic field intensity
- IIS2DLPC 3-Axis acceleration
- ISM330DHCX 6-Axis acceleration and angular velocity

Requirements
************

This sample communicates over I2C with the X-NUCLEO-IKS02A1 shield
stacked on a board with an Arduino connector. The board's I2C must be
configured for the I2C Arduino connector (both for pin muxing
and devicetree). See for example the :ref:`nucleo_f401re_board` board
source code:

- :file:`$ZEPHYR_BASE/boards/arm/nucleo_f401re/nucleo_f401re.dts`
- :file:`$ZEPHYR_BASE/boards/arm/nucleo_f401re/pinmux.c`

Please note that this sample can't be used with boards already supporting
one of the sensors available on the shield (such as disco_l475_iot1)
as sensors multiple instances are not supported.

References
**********

- X-NUCLEO-IKS02A1: https://www.st.com/en/ecosystems/x-nucleo-iks02a1.html

Building and Running
********************

This sample runs with X-NUCLEO-IKS02A1 stacked on any board with a matching
Arduino connector. For this example, we use a :ref:`nucleo_f401re_board` board.

.. zephyr-app-commands::
   :zephyr-app: samples/shields/x_nucleo_iks02a1/standard/
   :host-os: unix
   :board: nucleo_f401re
   :goals: build
   :compact:

Sample Output
=============

 .. code-block:: console

    X-NUCLEO-IKS02A1 sensor Mode 1 dashboard

    IIS2DLPC: Accel (m.s-2): x: 0.000, y: 0.000, z: 9.342
    IIS2MDC: Magn (gauss): x: -0.120, y: -0.095, z: -0.338
    IIS2MDC: Temperature: 25.1 C
    ISM330DHCX: Accel (m.s-2): x: 0.182, y: -0.306, z: 9.753
    ISM330DHCX: GYro (dps): x: 0.005, y: 0.001, z: -0.004
    5:: iis2dlpc trig 809
    5:: ism330dhcx acc trig 3332
    5:: ism330dhcx gyr trig 1666

    <updated endlessly every 2 seconds>

Part 3

한국어 전문 번역

개요

X-NUCLEO-IKS02A1 shield를 Standard mode(Mode 1)로 구성해 모든 sensor를 독립적으로 읽는 sample입니다.

  • IIS2MDC: 3-axis magnetic field intensity
  • IIS2DLPC: 3-axis acceleration
  • ISM330DHCX: 6-axis acceleration과 angular velocity

요구 사항

Arduino connector가 있는 board 위 shield와 I2C로 통신하며, Arduino I2C용 pin muxing과 devicetree를 모두 구성해야 합니다. 원문의 예제 source path는 $ZEPHYR_BASE/boards/arm/nucleo_f401re/nucleo_f401re.dts와 $ZEPHYR_BASE/boards/arm/nucleo_f401re/pinmux.c입니다.

Sensor multiple instance가 지원되지 않으므로 disco_l475_iot1처럼 동일 sensor를 이미 지원하는 board에서는 사용할 수 없습니다.

참고 자료

빌드 및 실행

Matching Arduino connector가 있는 board에서 실행할 수 있으며, Unix host의 nucleo_f401re build 예는 다음과 같습니다.

west build -b nucleo_f401re samples/shields/x_nucleo_iks02a1/standard/

출력 예

X-NUCLEO-IKS02A1 sensor Mode 1 dashboard

IIS2DLPC: Accel (m.s-2): x: 0.000, y: 0.000, z: 9.342
IIS2MDC: Magn (gauss): x: -0.120, y: -0.095, z: -0.338
IIS2MDC: Temperature: 25.1 C
ISM330DHCX: Accel (m.s-2): x: 0.182, y: -0.306, z: 9.753
ISM330DHCX: GYro (dps): x: 0.005, y: 0.001, z: -0.004
5:: iis2dlpc trig 809
5:: ism330dhcx acc trig 3332
5:: ism330dhcx gyr trig 1666

<updated endlessly every 2 seconds>

Mode 1 dashboard에는 IIS2DLPC acceleration, IIS2MDC magnetic field·temperature, ISM330DHCX acceleration·gyroscope와 trigger count가 표시되며 2초마다 갱신됩니다. GYro 표기는 exact source 보존 원칙에 따라 유지했습니다.

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.