Skip to main content

Sensors

Found under GUI on the device's panel list.

Microphone

Live view of the onboard microphone: its raw waveform, its frequency spectrum, and a scrolling spectrogram of the same spectrum over time. It can also record a short clip and play it back.

The screen

"Microphone" is shown top left, with an LED next to it that lights while a loud sound is detected. Below that, two plots share the top half of the screen, each with its own caption drawn in the trace's own color: a green "Waveform 8kHz" caption over the raw waveform on the left, and a magenta "FFT 0-4kHz" caption over the frequency spectrum on the right. The bottom half is a magenta-captioned "Spectrogram 0-4kHz" waterfall, a scrolling view fed by the same spectrum data as the FFT plot above it.

The waveform plot traces the raw microphone signal rescaled to 0-100, with 50 as silence - this is what the sound looks like over time. The FFT plot and the waterfall both cover the same 127 frequency bins, roughly 31 Hz to 3970 Hz (0-4 kHz) in steps of about 31 Hz, low frequency on the left - this is the same sound broken down by pitch instead of by time. The FFT plot's height is also an arbitrary 0-100 scale, not a physical loudness unit.

In the waterfall, each new row lands on top and older rows scroll down, about 31 rows a second, showing how that pitch breakdown has been changing over the last several seconds. Color there shows how far a bin's energy is above its own recent average, not its absolute loudness: dark blue is at or below that average, brightening through blue, then red-orange, orange and bright orange/yellow the further a bin rises above its own recent history.

Controls

ButtonAction
Yellowrec 5s - record a clip
GreenPlay back the most recent recording, if one exists
GraySwitch to the Sensors screen (motion, field and environment readings)
PAGEAlso switches to the Sensors screen
CancelThis help page

Blue carries no label and does nothing here. HOME leaves the screen, as it does everywhere else in the menu.

Recording

Yellow records a clip about five seconds long. Its label changes to "recording" for the duration, with a progress bar filling alongside it; pressing Yellow again while a recording is already running or queued does nothing. Afterward the label reverts to "rec 5s", or shows "rec failed" if the clip could not be written - for example, if there is no SD card. A successful recording is saved under /record on the SD card, named from the current date and time.

Playback

Green plays back the most recently recorded clip, whether it was made here or elsewhere in the firmware. It needs the Audio power zone (3), which is not the zone this app declares, so pressing Green switches that rail on itself, without asking, and then plays.

Sensors

Live readings from the onboard motion, magnetic field and environment sensors, one page at a time, each with its own trace.

The screen

"Sensors" is shown top left, with a status line to its right naming the current page and, if a sensor it needs is missing, saying so. A plot fills most of the screen, and four numbers run along the bottom. Their colors change with the page: whichever ones have a matching trace are drawn in that trace's color, so the readouts double as the plot's legend.

Controls

ButtonAction
GrayCycle to the next page; the label names the page it goes to
Yellowrtry - retry detecting any sensor currently reported missing
Greenclr - clear the plot; on the Field page this also resets the magnetic-field calibration
Bluemic - go to the Microphone screen
PAGEAlso goes to the Microphone screen
CancelThis help page

Red carries no label here and does nothing. HOME leaves the screen from here, as it does everywhere else in the menu.

Accel

X, Y and Z acceleration in g, in magenta/green/cyan, plus MOVING or still in white. Each axis number turns white while that axis is currently moving, and reverts to its normal color once it settles. The plot covers plus or minus 2 g.

Gyro

X, Y and Z angular rate in degrees per second, in orange/yellow/pale blue, with "dps" in white. The plot covers plus or minus 400 degrees per second.

Field

X, Y and Z calibrated magnetic field in microtesla (uT), in red/green/ blue, with the compass heading in degrees in white. The plot covers plus or minus 100 uT. Green resets the magnetic-field calibration on this page only.

Environ

Temperature in Celsius, temperature in Fahrenheit, relative humidity as a percent, and illuminance in lux. Only the last two are plotted, and only those two are colored to match their trace - humidity light blue, lux yellow; the temperature readouts are not on the plot and stay white. If the temperature/humidity sensor is missing, the status line shows "SHT40?"; if the light sensor is missing, it shows "OPT?". The plot carries two traces: illuminance on a log scale (0.1 lux at the bottom, 100000 lux at the top, so normal indoor light does not pin to the floor) and humidity plotted directly as a percent.

Orient

Roll, pitch and yaw in degrees, fused from the motion and field sensors, in magenta/green/cyan, with the compass heading in degrees in white. The plot covers plus or minus 180 degrees.

Missing sensors

Yellow retries detecting whichever sensor - motion, field, or the temperature/humidity/light pair - is currently reported missing, no matter which page is showing. A reading that stays missing after a retry usually means the part is not present on this board, not a loose connection.

Power

The app declares the Sensors power zone (1), shared with the Microphone screen since the requirement is per app, not per panel. Opening either screen switches zone 1 on if it was off, without asking, and holds it for as long as the screen stays open; readings show as absent until the rail is up. Zone 1 is on by default and is also switched from Power Devices. It powers the BMI323 IMU, BMM350 magnetometer, SHT40 humidity sensor and OPT4001 light sensor these pages read from. The microphone array's own supply rail is not called out separately in the hardware reference, so this requirement does not cover it; playback and recording on the Microphone screen check the Audio zone (3) on their own, only when they are actually used.