readAcceleration

Read acceleration measured by the Accelerometer along x, y, and z axes

Syntax

Acceleration = readAcceleration(mysh)

[Acceleration,Ts]= readAcceleration(mysh)

accelerationRaw = readAcceleration(mysh,'raw')

[accelerationRaw,Ts]= readAcceleration(mysh,'raw')

Description

Acceleration = readAcceleration(mysh) returns the acceleration measured by the Accelerometer along the x, y, and the z axis.

The unit of measurement for the Accelerometer data is meter per second square (m/s²)

[Acceleration,Ts]= readAcceleration(mysh) returns the acceleration measured by the Accelerometer along the x, y, and the z axis with timestamp.

accelerationRaw = readAcceleration(mysh,'raw') returns the acceleration measured by the Accelerometer along the x, y, and the z axis. The ‘raw’ argument is to specify that the output should be uncalibrated raw data.

[accelerationRaw,Ts]= readAcceleration(mysh,'raw') returns the acceleration measured by the Accelerometer along the x, y, and the z axis with timestamp. The ‘raw’ argument is to specify that the output should be uncalibrated raw data.

The full scale range for the Accelerometer is +/- 2g

Sense HAT IMU sensor axis information is shown below.

Note

To generate C/C++ code for this function, you must have an Embedded Coder^® license.

Examples

Read Acceleration

You can read acceleration from the Accelerometer of Sense HAT.

acceleration = readAcceleration(mysh) 

acceleration =  

      -0.3045    0.2769   10.0417 

Read the acceleration from the Accelerometer along the x, y, and the z axis.

Read Acceleration with Timestamp

You can read acceleration and the timestamp from the Accelerometer of Sense HAT.

[acceleration, ts] = readAcceleration(mysensehat)  

acceleration = 

 -0.3045    0.2769   10.0417 

ts =  
  09-Aug-2016 15:37:19 

Read the acceleration from the Accelerometer along the x, y, and the z axes with the timestamp.

Read Raw Uncalibrated Acceleration

You can read raw uncalibrated acceleration value from the Accelerometer of Sense HAT

accelerationRaw = readAcceleration(mysh,'raw') 

accelerationRaw = 

   1.0e+05 * 

    0.0105    0.0204    1.6333 

Read the raw uncalibrated acceleration value from the Accelerometer along the x, y, and the z axis.

Read Raw Uncalibrated Acceleration with Timestamp

You can read raw uncalibrated acceleration value from the Accelerometer of Sense HAT along with the timestamp.

[accelerationRaw, ts ]= readAcceleration(mysh,'raw') 

accelerationRaw = 

   1.0e+05 * 

    0.0105    0.0204    1.6333 

ts = 

  09-Aug-2016 15:37:19 

Read the raw uncalibrated acceleration value from the Accelerometer along the x, y, and the z axis with the timestamp.

Input Arguments

mysh — Connection to SenseHAT

sense HAT object

Connection to a SenseHAT board, specified as a sensehat object.

Output Arguments

Acceleration — Acceleration measured along the x,y, and z axes

scalar

The acceleration measured by the Accelerometer along the x,y, and z axes. This is a 1x3 double data. The unit of measurement for the Accelerometer data is meter per second square (m/s²).

accelerationRaw — Argument to specify the output type

string | char

Argument to specify that the output should be uncalibrated raw data.

Ts — Timestamp

scalar

Time at which the data is read.

Extended Capabilities

C/C++ Code Generation

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

• You can deploy readAcceleration on the Raspberry Pi^® hardware in MATLAB^® Online™.

• To generate C/C++ code for this function, you must have an Embedded Coder license. For more information on selecting the right product stack according to your development goals, see Product Stack for Raspberry Pi Blockset.

Version History

Introduced in R2016b