Skip to main content

Acceleration sensor module

Description

The "accelerometer" module produces the acceleration values from the LIS3DH 3-axis acceleration sensor acceleration sensor, which is located on the smartRAIL systems. In addition, the module calculates three further series from the measured values produced, consisting of the local maximum, local minimum and the quadratic mean and produces these aggregation aggregation values in additional channels for each axis.

The standard designation of the axes corresponds to the axis designations specified by the system (can be derived either from the imprint on the housing or from the data sheet).

The measuring frequency and measuring range of the sensor can be adjusted via the JSON configuration of the module. See Sensor configuration JSON

The names of the axes can be manually overwritten by the "channelnames" field of the JSON configuration to adjust the names of the axes after installation, depending on the alignment of the system. after assembly. The "channelprefix" field allows you to overwrite the default prefix ( corresponds to the module name specified in the config) with a user-defined prefix.

Interfaces & protocols used

  • I2C

JSON configuration

Minimum configuration

{
"module": "accelerometer",
"factory": "accelerometer",
"config": {
}
}

Explanation of the minimum configuration

Preset values (can be derived from the parameter description table):

  • 10Hz Signal rate
  • 2g Measuring range
  • 1000ms RMS interval

Produces the raw values of all three axes, as well as the local extremes and an RMS transformation according to the following scheme, for all three axes.

Example for the X-axis:

  • "accelerometer.x"
  • "accelerometer.x.rms"
  • "accelerometer.x.max"
  • "accelerometer.x.min"

Maximum configuration

{
"module": "accelerometer",
"factory": "accelerometer",
"config": {
"sensor": {
"rate": 400,
"range": "4g"
},
"channelnames": {
"xaxis": "acceleration.y",
"yaxis": "acceleration.z",
"zaxis": "acceleration.x"
},
"rmsInterval": 100,
"extremeInterval": 10000
}
}

Parameter description

Parameter nameRequiredData typeValid value rangeDefaultDescription
channelPrefixNoStringAnyName of the modulePrefix to be added to all channels of this module *
rmsIntervalNoInteger[50,100,500,1000]1000Interval length of the root mean square [ms] **
extremeIntervalNoInteger[100,1000,10000,60000]1000Interval length of the aggregation to the maximum and minimum
sensorNoJSON Object-see belowFields for sensor configuration
channelnamesNoJSON Object-see belowOverwrite channel names

* If both the channelprefix and channelnames fields are specified in a config, the value in the channelprefix value in channelprefix` is ignored for any axis for which a specific channel name has been specified.

** To guarantee that a meaningful quadratic mean is calculated, the module resets itself to the module resets itself to the 1000ms value if the combination of signal rate and RMS interval length would result in would result in less than 2 measured values being used for the calculation.

i.e.:
sensor.rate = 10hz
rmsInterval = 100ms

Sensor configuration structure

Parameter nameRequiredData typeValid value rangeDefaultDescription
rateNoInteger[1,10,100,200,400]10Signal frequency of the three axes [Hz]
rangeNoString["2g", "4g", "8g"]"2g"Measuring range of the three axes

Overwrite the channel names

Parameter NameRequiredData TypeValid Value RangeDefaultDescription
xaxisNoStringAny"accelerometer.x"
yaxisNoStringAny"accelerometer.y"
zaxisNoStringAny"accelerometer.z"

The channel names of the transformations are created from the above-mentioned parameters and the suffixes ".rms", ".rms" and ".rms". suffixes ".rms", " .min", ".max" respectively.

i.e.
For "channelnames.xaxis = acc.z" =>
acc.z // Raw values
acc.z.min
acc.z.max
acc.z.rms

Module Information

InformationValue
AuthoroptiMEAS Measurement and Automation Systems GmbH
since smartCORE-
Module TypeProducer
Dependencies