nn::hid::CTR::AccelerometerReader Class

class AccelerometerReader : private ADLFireWall::NonCopyable

Class for loading sampling data from the accelerometer.

Sampling Rate

The accelerometer is sampled an average of every 10 milliseconds. Use the nn::hid::CTR::Accelerometer class to know when sampling occurs, allowing you to accurately monitor sampling timing.

No sampling is done right after generating a class instance or right after recovering from sleep, so calls to the nn::hid::CTR::AccelerometerReader::Read or nn::hid::CTR::AccelerometerReader::ReadLatest functions might not have any effect. To avoid this, Nintendo recommends calling the nn::hid::CTR::Accelerometer::WaitSampling function right after generating a class instance or when recovering from sleep to wait until results have been sampled at least once. This wait time is the same as the sampling frequency, up to a maximum of approximately 10 milliseconds.

Conditions to Start Sampling

Accelerometer sampling halts in two cases: when the system is in Sleep Mode, and when there are no instances of the AccelerometerReader class. You must destroy all instances to explicitly stop sampling.

Output Value Processing Features

This class includes the following features to process output values.

Acceleration Variation Tolerance	You can apply a correction to control any major variation in acceleration during continuous sampling.
Offset Correction	Outputs after subtracting the specified value from sampling results.
Axial Rotation	Outputs sampling results multiplied by an optional rotation matrix. Allows for the output of values as if the accelerometer were on an incline.

All processing features are disabled by default. Configure and enable them as needed. For details, see the various function references.

Axis Orientation

The default accelerometer sensors are as follows.

X+	The direction indicated by Left on the +Control Pad
Y+	The direction normal to and outward from the Touch Screen
Z+	The direction indicated by Up on the +Control Pad

ADLFireWall::NonCopyable
  nn::hid::CTR::AccelerometerReader

2010/12/06

Added explanation of conditions under which sampling stops.

2010/01/07

Initial version.