sgp_read_cmd(9)

✨ sgp_read_cmd(9) — Kernel API Manual 💖

okay so this page is from the Kernel API Manual, and it’s giving “sensor readback core lore” 🫶. Stay for the lock warning, bestie — it’s important.

🌸 NAME 🌸

sgp_read_cmd — reads data from the sensor after issuing a command. The caller must hold data->data_lock for the duration of the call. no cap, that lock is not optional 💅.

⚠️ bestie, the caller must hold data->data_lock for the duration of the call. like, the whole call. do not let go early 🙈.

✨ SYNOPSIS ✨

int sgp_read_cmd (struct sgp_data *data , enum sgp_cmd cmd , union
       sgp_reading *buf , size_t word_count , unsigned long duration_us );

🎀 ARGUMENTS 🎀

• data — SGP data. the main character struct, periodt 👑.
• cmd — SGP Command to issue. like, the command we’re sending before the read happens.
• buf — Raw data buffer to use. this is where the raw data lands 🍓.
• word_count — Num words to read, excluding CRC bytes. yes, CRC bytes are not included in this count, bestie 💀.
• duration_us — Time taken to sensor to take a reading and data to be ready. the sensor-reading + data-ready time situation 🧚.

🔥 RETURN 🔥

Returns 0 on success, negative error otherwise. zero = slay ✨, negative = something went sideways 😭.

🦋 SEE ALSO 🦋

Kernel file ./drivers/iio/chemical/sgp30.c, plus sgp_verify_buffer(9) and sgp_measure_iaq(9). go read those if you want the full friend-group lore 🌈.

and finally, mwah 💋: this page’s source/version situation is ./drivers/iio/chemical, and it’s dated October 2026. that’s the sign-off, bestie — now go hold that lock 🫶✨