readAcceleration

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

Add-On Required: This feature requires the MATLAB Support Package for Raspberry Pi Hardware add-on.

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.

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 also deploy readAcceleration on the Raspberry Pi^® hardware in MATLAB^® Online™.

Version History

Introduced in R2016b