DEV-793 Add MLX90632 skin-temperature decoder (data-block id 9)

Second Phase-C gen-2 sensor. Data block = fixed 16 samples x 4 bytes (object int16 then ambient int16, little-endian centi-degrees C - the firmware applies the chip EEPROM calibration before quantising, and only emits full blocks, partials discarded on stop per hal_slowSensorSampler.c), so it rides the generic fixed-size block path like the ambient light. New SensorMLX90632 mirrors the web SDK's SensorMLX90632.ts: UNCAL = centi-degC counts, CAL = /100 degrees Celsius. Config from payload header byte 32 (bit 0 measType medical/extended, bits 3:1 refresh code 0..7 = 0.5..64 Hz); enable from GEN_CFG_3 bit 4; output rate = refresh / sub-measurements (medical 2, extended 3).

The light-rate refinement is generalised to refineSlowSensorSamplingRateFromBlockTicks(sensorId) and applied to both LIGHT and SKIN_TEMP blocks - the header-derived rates are estimates, inter-block tick spacing is truth. Metadata guard now accepts ids <=7 plus 9; ALGO_HUB (8) and FLICKER (10) still fail loudly (deferred to the new prototypes per DEV-793). CSV config line: 'MLX90632 {Sampling Rate [Configured/Calculated]; Refresh = X Hz; Mode = Medical|Extended; Resolution = 16-bit}'.

Compile-clean, full ASM_PC_00005 suite green (all existing references bit-identical). NOT yet exercised on real data - no skin-temp recording exists; a ~2 min recording with skin temp enabled on any SR61-5/SR68-9 is wanted for the reference test.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: marknolan

ShimmerDriver/src/main/java/com/shimmerresearch/driver/Configuration.java

@@ -2649,6 +2649,8 @@ public class SensorBitmap {
 			public static final int LSM6DSV_MAG				= 1 << (2 + (8*0));
 			/** VD6283TX45 ambient light (second-generation HW); enable is GEN_CFG_3 bit 3. */
 			public static final int VD6283					= 1 << (1 + (8*0));
+			/** MLX90632 skin temperature (second-generation HW); enable is GEN_CFG_3 bit 4. */
+			public static final int MLX90632				= 1 << (0 + (8*0));
 		}
 
 		public class DerivedSensorsBitMask {
@@ -2685,6 +2687,7 @@ public class SENSOR_ID {
 			public static final int LSM6DSV_GYRO			= 2016;
 			public static final int LSM6DSV_MAG				= 2017;
 			public static final int VD6283					= 2018;
+			public static final int MLX90632				= 2019;
 		}
 
 		public enum LABEL_SENSOR_TILE{

ShimmerDriver/src/main/java/com/shimmerresearch/sensors/AbstractSensor.java

@@ -69,6 +69,7 @@ public enum SENSORS{
 		LIS2MDL("LIS2MDL"),
 		LSM6DSV("LSM6DSV"),
 		VD6283("VD6283"),
+		MLX90632("MLX90632"),
 		BMP390("BMP390");
 
 	    private final String text;

ShimmerDriver/src/main/java/com/shimmerresearch/verisense/VerisenseDevice.java

@@ -66,6 +66,7 @@
 import com.shimmerresearch.verisense.sensors.SensorLIS2DW12;
 import com.shimmerresearch.verisense.sensors.SensorLSM6DS3;
 import com.shimmerresearch.verisense.sensors.SensorLSM6DSV;
+import com.shimmerresearch.verisense.sensors.SensorMLX90632;
 import com.shimmerresearch.verisense.sensors.SensorVD6283;
 import com.shimmerresearch.verisense.sensors.SensorMAX86150;
 import com.shimmerresearch.verisense.sensors.SensorMAX86916;
@@ -589,6 +590,7 @@ public void configBytesParse(byte[] configBytes, COMMUNICATION_TYPE commType) {
 			int gen2GenCfg3 = configBytes[PAYLOAD_CONFIG_BYTE_INDEX.GEN_CFG_3] & 0xFF;
 			if((gen2GenCfg3 & (1<<2))!=0) { enabledSensors |= Configuration.Verisense.SensorBitmap.LSM6DSV_MAG; }
 			if((gen2GenCfg3 & (1<<3))!=0) { enabledSensors |= Configuration.Verisense.SensorBitmap.VD6283; }
+			if((gen2GenCfg3 & (1<<4))!=0) { enabledSensors |= Configuration.Verisense.SensorBitmap.MLX90632; }
 		}
 		setEnabledAndDerivedSensorsAndUpdateMaps(enabledSensors, mDerivedSensors, commType);
 
@@ -1084,6 +1086,23 @@ && isSensorEnabled(Configuration.Verisense.SENSOR_ID.VD6283)) {
 			sb.append(SENSOR_CONFIG_STRINGS.RESOLUTION);
 			sb.append("24-bit");
 			sb.append("}");
+		} else if(sensorClassKey==AbstractSensor.SENSORS.MLX90632
+				&& isSensorEnabled(Configuration.Verisense.SENSOR_ID.MLX90632)) {
+			// Second-generation skin temperature.
+			SensorMLX90632 sensorMlx90632 = getSensorMLX90632();
+
+			sb.append(generateCalcSamplingRateConfigStr(sensorClassKey, sensorMlx90632.getRateFreq(), calculatedSamplingRate));
+
+			sb.append("Refresh = ");
+			sb.append(UtilVerisenseDriver.formatDoubleToNdecimalPlaces(sensorMlx90632.getRefreshHz(), 1));
+			sb.append(" ");
+			sb.append(CHANNEL_UNITS.FREQUENCY);
+			sb.append("; Mode = ");
+			sb.append(sensorMlx90632.getMeasTypeString());
+			sb.append("; ");
+			sb.append(SENSOR_CONFIG_STRINGS.RESOLUTION);
+			sb.append("16-bit");
+			sb.append("}");
 		} else if(LIST_OF_PPG_SENSORS.contains(sensorClassKey) && isHwPpgAndAnyMaxChEnabled()) {
 			AbstractSensor abstractSensor = getAbstractSensorPpg();
 			if(abstractSensor!=null) {
@@ -1388,8 +1407,9 @@ public void sensorAndConfigMapsCreate() {
 		if(isPayloadDesignV13orAbove()) {
 			// Second-generation IMU (LSM6DSV accel/gyro + LIS2MDL mag via sensor hub)
 			addSensorClass(SENSORS.LSM6DSV, new SensorLSM6DSV(this));
-			// Second-generation ambient light
+			// Second-generation ambient light + skin temperature
 			addSensorClass(SENSORS.VD6283, new SensorVD6283(this));
+			addSensorClass(SENSORS.MLX90632, new SensorMLX90632(this));
 		} else if(doesHwSupportLsm6ds3()) {
 			addSensorClass(SENSORS.LSM6DS3, new SensorLSM6DS3(this));
 		}
@@ -1606,6 +1626,9 @@ public List<SENSORS> getSensorKeysForDatablockId(DATABLOCK_SENSOR_ID datablockSe
 			case LIGHT:
 				listOfSensorIds.add(SENSORS.VD6283);
 				break;
+			case SKIN_TEMP:
+				listOfSensorIds.add(SENSORS.MLX90632);
+				break;
 			case PPG:
 				SENSORS sensorClassKey = getPpgSensorClassKey();
 				if(sensorClassKey!=null) {
@@ -1632,6 +1655,10 @@ public int calculateFifoBlockSize(SENSORS sensorClassKey) {
 				// NUM_LIGHT_SAMPLES_PER_BLOCK samples (partials are discarded on stop).
 				dataBlockSize = SensorVD6283.BLOCK_DATA_BYTES;
 				break;
+			case MLX90632:
+				// Fixed-size block: full blocks of NUM_TEMP_SAMPLES_PER_BLOCK samples only.
+				dataBlockSize = SensorMLX90632.BLOCK_DATA_BYTES;
+				break;
 			case LSM6DS3:
 				AbstractSensor abstractSensor = getSensorClass(SENSORS.LSM6DS3);
 				if(abstractSensor!=null) {
@@ -1924,7 +1951,9 @@ public DataBlockDetails parseDataBlockMetaData(byte[] byteBuffer, int dataBlockS
 		// without a getSensorKeysForDatablockId()/calculateFifoBlockSize() handler
 		// would corrupt the parse, so they are rejected with the informative
 		// exception below until their decoders are implemented.
-		if(sensorId>0 && sensorId<=DATABLOCK_SENSOR_ID.LIGHT.ordinal()) {
+		// Parse-supported block ids: everything up to LIGHT (7), plus SKIN_TEMP (9).
+		// ALGO_HUB (8) and FLICKER (10) still fail loudly below until their decoders land.
+		if(sensorId>0 && (sensorId<=DATABLOCK_SENSOR_ID.LIGHT.ordinal() || sensorId==DATABLOCK_SENSOR_ID.SKIN_TEMP.ordinal())) {
 			DATABLOCK_SENSOR_ID datablockSensorId = payloadSensorIdValues[sensorId];
 
 			List<SENSORS> listOfSensorClassKeys = getOrCreateListOfSensorClassKeysForDataBlockId(datablockSensorId);
@@ -2374,6 +2403,14 @@ public SensorVD6283 getSensorVD6283() {
 		return null;
 	}
 
+	public SensorMLX90632 getSensorMLX90632() {
+		AbstractSensor abstractSensor = getSensorClass(SENSORS.MLX90632);
+		if(abstractSensor!=null && abstractSensor instanceof SensorMLX90632) {
+			return (SensorMLX90632) abstractSensor;
+		}
+		return null;
+	}
+
 	/**
 	 * @return Null if sensor not supported by current hardware
 	 * @see SensorGSRVerisense

ShimmerDriver/src/main/java/com/shimmerresearch/verisense/payloaddesign/AsmBinaryFileConstants.java

@@ -47,6 +47,9 @@ public class PAYLOAD_CONFIG_BYTE_INDEX {
 		public static final int LIGHT_GAIN_AND_DARK = 26;
 		/** Second-generation only: ambient-light exposure index (abs byte 31). */
 		public static final int LIGHT_EXPOSURE = 27;
+		/** Second-generation only: skin-temp config (abs byte 32) - bit 0 measType
+		 * (0=medical/1=extended), bits 3:1 MLX90632 refresh-rate code. */
+		public static final int SKIN_TEMP_CONFIG = 28;
 	}
 
 	public class BYTE_COUNT {

ShimmerDriver/src/main/java/com/shimmerresearch/verisense/payloaddesign/PayloadContentsDetailsV8orAbove.java

@@ -93,11 +93,13 @@ public void parsePayloadContentsMetaData(int binFileByteIndex) throws IOExceptio
 
 		// --------- End of parsing ------------------
 
-		// The ambient-light sample rate isn't stored in the payload header (only
-		// gain/exposure are) and the achieved rate differs from both the configured
-		// rate and 1/exposure (per-measurement dead time), so refine it from the
-		// data itself before the block timings are back-filled below.
-		refineLightSamplingRateFromBlockTicks();
+		// The slow sensors' achieved sample rates differ from what the payload
+		// header can tell us (the light rate isn't stored at all and the chip adds
+		// per-measurement dead time; the skin-temp output cadence is refresh-code
+		// derived but similarly approximate), so refine them from the data itself
+		// before the block timings are back-filled below.
+		refineSlowSensorSamplingRateFromBlockTicks(DATABLOCK_SENSOR_ID.LIGHT);
+		refineSlowSensorSamplingRateFromBlockTicks(DATABLOCK_SENSOR_ID.SKIN_TEMP);
 
 		// Up to, and including, payload design v10, the real-world clock time that was
 		// stored in the payload footer was the real-world time at the end of the
@@ -314,19 +316,20 @@ private boolean isParserAtEndOfBuffer(int bufferLength, int currentByteIndex) {
 	}
 
 	/**
-	 * Derive the achieved ambient-light sample period from the spacing of
-	 * consecutive light-block end ticks and apply it to the light blocks' sampling
-	 * rate before their timings are back-filled. The light sample rate cannot be
-	 * read from the stored payload header (see SensorVD6283.getRateFreq), and each
-	 * light block holds a fixed number of samples, so
+	 * Derive a slow sensor's (ambient light / skin temp) achieved sample period
+	 * from the spacing of consecutive same-sensor block end ticks and apply it to
+	 * those blocks' sampling rate before their timings are back-filled. The
+	 * header-derived rates are only estimates (the light rate isn't stored at all
+	 * - see SensorVD6283.getRateFreq - and the skin-temp cadence is refresh-code
+	 * derived), and each block holds a fixed number of samples, so
 	 * {@code inter-block ticks / samples-per-block} is the exact per-sample period.
-	 * With fewer than two light blocks in the payload the exposure-limited
-	 * estimate the blocks were created with is left in place.
+	 * With fewer than two blocks in the payload the header-derived estimate the
+	 * blocks were created with is left in place.
 	 */
-	private void refineLightSamplingRateFromBlockTicks() {
+	private void refineSlowSensorSamplingRateFromBlockTicks(DATABLOCK_SENSOR_ID slowSensorId) {
 		List<DataBlockDetails> lightBlocks = new ArrayList<DataBlockDetails>();
 		for(DataBlockDetails dataBlockDetails:listOfDataBlocksInOrder) {
-			if(dataBlockDetails.datablockSensorId==DATABLOCK_SENSOR_ID.LIGHT) {
+			if(dataBlockDetails.datablockSensorId==slowSensorId) {
 				lightBlocks.add(dataBlockDetails);
 			}
 		}