readAcceleration

Read one acceleration data sample from LSM9DS1 sensor

Since R2021a

Syntax

[accelReadings,timestamp] = readAcceleration(sensor)

Description

[accelReadings,timestamp] = readAcceleration(sensor) returns one sample of the acceleration data from the LSM9DS1 IMU sensor. The acceleration sample is returned as a 3-by-1 vector in m/s² along the X, Y, and Z axes. The function also returns the timestamp at which MATLAB^® receives the acceleration data from the LSM9DS1 sensor. The timestamp output is optional.

Examples

Read Acceleration Data from LSM9DS1 Sensor

Read the acceleration data from the LSM9DS1 IMU sensor on the X, Y, and Z axes.

Create a connection from MATLAB to the Raspberry Pi^® hardware board.

mypi = raspi;

mypi = 

  Raspi with Properties:

           DeviceAddress: 'raspberrypi-hysdu8X38o'
                    Port: 18734
               BoardName: 'Raspberry Pi 3 Model B+'
           AvailableLEDs: {'led0'}
    AvailableDigitalPins: [4,5,6,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27]
    AvailableSPIChannels: {‘CE0’,’CE1’}
       AvailableI2CBuses: {'i2c-1'}
             I2CBusSpeed: 100000
        AvailabelWebCams: mmal service 16.1 (platform:bcm2835-v4l2)

Create an lsm9ds1 sensor object on the I2C bus 'i2c-1' on addresses '0x6A' and '0x1C'.

sensor = lsm9ds1(r,'Bus','i2c-1','I2CAddress',{'0x6A','0x1C'});

sensor = 

  lsm9ds1 with properties:

                         I2CAddress: 106 ("0x6A")
                                   : 28 ("0x1C")
                                Bus: i2c-1 

Return one sample of acceleration data read from the LSM9DS1 sensor on the X, Y, and Z axes.

[accelReadings,timestamp] = readAcceleration(sensor);

accelReadings =

  data

    0.1712   -0.7095    9.5843


timestamp = 

  datetime

   9-Dec-2020 16:11:59.074

Since the timestamp output is optional, you can obtain only the acceleration data from the LSM9DS1 sensor.

[accelReadings] = readAcceleration(sensor);

accelReadings =

  data

    0.1712   -0.7095    9.5843

Input Arguments

sensor — LSM9DS1 sensor object

lsm9ds1 object

LSM9DS1 sensor object connection to the Raspberry Pi hardware board specified as a lsm9ds1 object.

Example: sensor = lsm9ds1(mypi) creates a connection to the LSM9DS1 sensor on the Raspberry Pi object mypi.

Output Arguments

accelReadings — Acceleration values read from LSM9DS1 sensor

3-by-1 vector acceleration data

Read the acceleration data from the LSM9DS1 sensor on the X, Y, and Z axes.

timestamp — Timestamp of acceleration values read from LSM9DS1 sensor

datetime

Read the date and time at which MATLAB receives the acceleration sample value from the LSM9DS1 sensor, specified as a datetime.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

• Timestamp value is always returned in seconds.

• When you create an lsm9ds1 sensor object and do not specify the I2C address in the name-value pair, the default I2C address is considered by the LSM9DS1 sensor. For the LSM9DS1 sensor, the default I2C address is {'0x6B','0x1E'}.

Version History

Introduced in R2021a