Skip to main content

Sensor Reference

Detailed documentation for each sensor available in mindLAMP. Every page covers data fields and JSON schema, platform support, sampling behavior, Cortex features, and configuration options.

Every sensor has a unique SensorSpec identifier used in the API and data events. For the general event structure shared by all sensors, see Sensor Data Format.

Device Sensorsโ€‹

SensorSensorSpecPlatformSamplingCortex
GPSlamp.gpsiOS, AndroidDiscrete (1 Hz)Yes
Accelerometerlamp.accelerometeriOS, AndroidDiscrete (5 Hz)Yes
Device Motionlamp.device_motioniOS, AndroidDiscreteRaw only
Device Statelamp.device_stateiOS, AndroidContinuousYes
Stepslamp.stepsiOS, AndroidIntervalYes
Nearby Deviceslamp.nearby_deviceiOS, AndroidDiscreteYes
Telephonylamp.telephonyiOS, AndroidContinuousYes
Analyticslamp.analyticsiOS, Android, WebContinuousYes
Activity Recognitionlamp.activity_recognitioniOS, AndroidContinuousโ€”

Health Platform Sensorsโ€‹

These sensors read from Apple HealthKit (iOS) or Google Health Connect (Android) and typically require a connected wearable device.

SensorSensorSpecCortex
Sleeplamp.sleepYes
Heart Ratelamp.heart_rateโ€”
Heart Rate Variabilitylamp.heartratevariability_sdnnโ€”
Respiratory Ratelamp.respiratory_rateโ€”
Blood Pressurelamp.blood_pressureโ€”
Blood Glucoselamp.blood_glucoseโ€”
Oxygen Saturationlamp.oxygen_saturationโ€”
Body Temperaturelamp.body_temperatureโ€”
Workoutslamp.segmentโ€”
Nutritionlamp.nutritionโ€”

iOS SensorKitโ€‹

On enrolled iOS research devices, Apple's SensorKit framework provides additional data streams โ€” including app usage, phone call metadata, text message metadata, and location visit categories. These are not standard mindLAMP sensors (they have no lamp.* SensorSpec) but are consumed by Cortex as raw features and feed into several secondary features (e.g., screen_unlocks, app_time, text_number, visit_time). SensorKit requires explicit enrollment approval from Apple.