Skip to content

Commit 867271c

Browse files
PaulZCPaulZC
authored
Merge pull request #44 from sparkfun/release_candidate
Pulling SENSOR_UNITS.md from release_candidate
2 parents ebd6415 + 0b2feb1 commit 867271c

File tree

2 files changed

+300
-1
lines changed

2 files changed

+300
-1
lines changed

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,8 @@ Documentation
7171
* **[UPGRADE.md](./UPGRADE.md)** - contains full instructions on how to upgrade the firmware on the OLA using the [Artemis Firmware Upload GUI](https://github.com/sparkfun/Artemis-Firmware-Upload-GUI).
7272
* **[CONTRIBUTING.md](./CONTRIBUTING.md)** - guidance on how to contribute to this library.
7373
* **[Installing an Arduino Library Guide](https://learn.sparkfun.com/tutorials/installing-an-arduino-library)** - OLA includes a large number of libraries that will need to be installed before compiling will work.
74-
* **[ADDING_SENSORS.md](./ADDING_SENSORS.md)** - contains _abbreviated_ instructions on how to add a new sensor to the OLA firmware. It's more of an aide-memoire really...
74+
* **[ADDING_SENSORS.md](./ADDING_SENSORS.md)** - contains _abbreviated_ instructions on how to add a new sensor to the OLA firmware. It's more of an aide-memoire really... Sorry about that.
75+
* **[SENSOR_UNITS.md](./SENSOR_UNITS.md)** - contains a summary of the units used for each sensor measurement.
7576

7677
License Information
7778
-------------------

‎SENSOR_UNITS.md‎

Lines changed: 298 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,298 @@
1+
# OpenLog Artemis : Sensor Units
2+
3+
This document summarizes the units used for each sensor measurement.
4+
5+
---
6+
## Index
7+
8+
### Built-in Inertial Measurement Unit:
9+
10+
- [ICM-20948 IMU](#ICM-20948-IMU)
11+
12+
### Global Navigation Satellite System (GNSS) navigation data:
13+
14+
- [u-blox GNSS boards](#u-blox-GNSS-boards)
15+
16+
### Pressure, Altitude, Humidity and Temperature Data:
17+
18+
- [BME280 atmospheric sensor](#BME280-atmospheric-sensor)
19+
- [LPS25HB absolute pressure sensor](#LPS25HB-absolute-pressure-sensor)
20+
- [MS8607 PHT sensor](#MS8607-PHT-sensor)
21+
- [MPR0025PA MicroPressure sensor](#MPR0025PA-MicroPressure-sensor)
22+
- [MS5637 barometric pressure sensor](#MS5637-barometric-pressure-sensor)
23+
- [AHT20 humidity and temperature sensor](#AHT20-humidity-and-temperature-sensor)
24+
- [SHTC3 humidity and temperature sensor](#SHTC3-humidity-and-temperature-sensor)
25+
26+
### Air Quality and Environmental Sensors:
27+
28+
- [CCS811 air quality sensor](#CCS811-air-quality-sensor)
29+
- [VEML6075 UV light sensor](#VEML6075-UV-light-sensor)
30+
- [SGP30 air quality and Volatile Organic Compound (VOC) sensor](#SGP30-air-quality-and-VOC-sensor)
31+
- [SCD30 CO2 humidity and temperature sensor](#SCD30-CO2-humidity-and-temperature-sensor)
32+
- [SN-GCJA5 Particle Sensor](#SN-GCJA5-Particle-Sensor)
33+
34+
### Distance:
35+
36+
- [VL53L1X laser Time of Flight (ToF) sensor](#VL53L1X-laser-ToF-sensor)
37+
- [VCNL4040 proximity sensor](#VCNL4040-proximity-sensor)
38+
39+
### Precision Temperature Sensors:
40+
41+
- [MCP9600 thermocouple amplifier](#MCP9600-thermocouple-amplifier)
42+
- [Qwiic PT100 ADS122C04 platinum resistance sensor](#Qwiic-PT100-ADS122C04-platinum-resistance-sensor)
43+
- [TMP117 precision temperature sensor](#TMP117-precision-temperature-sensor)
44+
45+
### Weight:
46+
47+
- [NAU7802 load cell sensor](#NAU7802-load-cell-sensor)
48+
49+
### ADC:
50+
51+
- [Qwiic PT100 ADS122C04 platinum resistance sensor](#Qwiic-PT100-ADS122C04-platinum-resistance-sensor)
52+
53+
---
54+
## Sensor Units
55+
56+
---
57+
## ICM-20948 IMU
58+
59+
| []() | | |
60+
|---|---|---|
61+
| Accelerometer | aX,aY,aZ | milli g |
62+
| Gyro | gX,gY,gZ | Degrees per Second |
63+
| Magnetometer | mX,mY,mZ | micro Tesla |
64+
| Temperature | imu_degC | Degrees Centigrade |
65+
66+
---
67+
## u-blox GNSS boards
68+
69+
| []() | | |
70+
|---|---|---|
71+
| Date | gps_Date | MM/DD/YYYY or DD/MM/YYYY |
72+
| Time | gps_Time | HH:MM:SS.SSS |
73+
| Lat & Lon | gps_Lat,gps_Long | Degrees<sup>-7</sup> |
74+
| Altitude | gps_Alt | mm |
75+
| Altitude MSL | gps_AltMSL | mm |
76+
| SIV | gps_SIV | Count |
77+
| Fix Type | gps_FixType | 0-5 |
78+
| Carrier Soln. | gps_CarrierSolution | 0-2 |
79+
| Ground Speed | gps_GroundSpeed | mm/s |
80+
| Heading | gps_Heading | Degrees<sup>-5</sup> |
81+
| PDOP | gps_pDOP | m<sup>-2</sup> |
82+
| Time Of Week | gps_iTOW | ms |
83+
84+
Lat = Latitude
85+
Lon = Longitude
86+
MSL = Metres above Sea Level
87+
SIV = Satellites In View
88+
PDOP = Positional Dilution Of Precision
89+
90+
Fix Type:
91+
0: No
92+
1: Dead Reckoning Only
93+
2: 2D
94+
3: 3D
95+
4: GNSS + Dead Reckoning
96+
5: Time Only
97+
98+
Carrier Solution:
99+
0: No
100+
1: Float Solution
101+
2: Fixed Solution
102+
103+
---
104+
## BME280 atmospheric sensor
105+
106+
| []() | | |
107+
|---|---|---|
108+
| Pressure | pressure_Pa | Pascals |
109+
| Humidity | humidity_% | Percent |
110+
| Altitude | altitude_m | m |
111+
| Temperature | temp_degC | Degrees Centigrade |
112+
113+
---
114+
## LPS25HB absolute pressure sensor
115+
116+
| []() | | |
117+
|---|---|---|
118+
| Pressure | pressure_hPa | hectoPascals |
119+
| Temperature | pressure_degC | Degrees Centigrade |
120+
121+
---
122+
## MS8607 PHT sensor
123+
124+
| []() | | |
125+
|---|---|---|
126+
| Humidity | humidity_% | Percent |
127+
| Pressure | hPa | hectoPascals |
128+
| Temperature | degC | Degrees Centigrade |
129+
130+
---
131+
## MPR0025PA MicroPressure sensor
132+
133+
| []() | | |
134+
|---|---|---|
135+
| Pressure (PSI) | PSI | Pounds per Square Inch |
136+
| Pressure (Pa) | Pa | Pascals |
137+
| Pressure (kPa) | kPa | kiloPascals |
138+
| Pressure (torr) | torr | torr |
139+
| Pressure (inHg) | inHg | inches of Mercury |
140+
| Pressure (atm) | atm | atmospheres |
141+
| Pressure (bar) | bar | barometric pressure |
142+
143+
---
144+
## MS5637 barometric pressure sensor
145+
146+
| []() | | |
147+
|---|---|---|
148+
| Pressure | pressure_hPa | hectoPascals |
149+
| Temperature | pressure_degC | Degrees Centigrade |
150+
151+
---
152+
## AHT20 humidity and temperature sensor
153+
154+
| []() | | |
155+
|---|---|---|
156+
| Humidity | humidity_% | Percent |
157+
| Temperature | degC | Degrees Centigrade |
158+
159+
---
160+
## SHTC3 humidity and temperature sensor
161+
162+
| []() | | |
163+
|---|---|---|
164+
| Humidity | humidity_% | Percent |
165+
| Temperature | degC | Degrees Centigrade |
166+
167+
---
168+
## CCS811 air quality sensor
169+
170+
| []() | | |
171+
|---|---|---|
172+
| VOC | tvoc_ppb | Parts Per Billion |
173+
| CO<sub>2</sub> | co2_ppm | Parts Per Million |
174+
175+
VOC = Volatile Organic Compounds
176+
177+
---
178+
## VEML6075 UV light sensor
179+
180+
| []() | | |
181+
|---|---|---|
182+
| UVA | uva | |
183+
| UVB | uvb | |
184+
| UV Index | uvIndex | |
185+
186+
---
187+
## SGP30 air quality and VOC sensor
188+
189+
| []() | | |
190+
|---|---|---|
191+
| Total VOC | tvoc_ppb | Parts Per Billion |
192+
| CO<sub>2</sub> | co2_ppm | Parts Per Million |
193+
| H<sub>2</sub> | H2 | none |
194+
| Ethanol | ethanol | none |
195+
196+
---
197+
## SCD30 CO2 humidity and temperature sensor
198+
199+
| []() | | |
200+
|---|---|---|
201+
| CO<sub>2</sub> | co2_ppm | Parts Per Million |
202+
| Humidity | humidity_% | Percent |
203+
| Temperature | degC | Degrees Centigrade |
204+
205+
---
206+
## SN-GCJA5 Particle Sensor
207+
208+
| []() | | |
209+
|---|---|---|
210+
| Particle Density (1.0µm) | PM1_0 | µg/m<sup>3</sup> |
211+
| Particle Density (2.5µm) | PM2_5 | µg/m<sup>3</sup> |
212+
| Particle Density (10µm) | PM10 | µg/m<sup>3</sup> |
213+
| Particle Count (0.5µm) | PC0_5 | Count |
214+
| Particle Count (1.0µm) | PC1_0 | Count |
215+
| Particle Count (2.5µm) | PC2_5 | Count |
216+
| Particle Count (5.0µm) | PC5_0 | Count |
217+
| Particle Count (7.5µm) | PC7_5 | Count |
218+
| Particle Count (10µm) | PC10 | Count |
219+
| Sensor Status | Sensors | |
220+
| Photodiode Status | PD | 0-3 |
221+
| Laser Diode Status | LD | 0-3 |
222+
| Fan Status | Fan | 0-3 |
223+
224+
Sensor status:
225+
| []() | |
226+
|---|---|
227+
| | PD LD Fan |
228+
| 0 | 0 0 0 |
229+
| 1 | Any 1, nor 2 & 3 |
230+
| 2 | Any 2 |
231+
| 3 | Any 3 nor 2 |
232+
233+
PD status:
234+
0: Normal status
235+
1: Normal status (within -80% against initial value), with S/W correction
236+
2: Abnormal (below -90% against initial value), loss of function
237+
3: Abnormal (below -80% against initial value), with S/W correction
238+
239+
LD operational status:
240+
0: Normal status
241+
1: Normal status (within -70% against initial LOP), with S/W correction
242+
2: Abnormal (below -90% against initial LOP) or no LOP, loss of function
243+
3: Abnormal (below -70% against initial LOP), with S/W correction
244+
245+
Fan operational status:
246+
0: Normal status
247+
1: Normal status (1,000rpm or more), with S/W correction
248+
2: In initial calibration
249+
3: Abnormal (below 1,000rpm), out of control
250+
251+
---
252+
## VL53L1X laser ToF sensor
253+
254+
| []() | | |
255+
|---|---|---|
256+
| Distance | distance_mm | mm |
257+
| Range Status | distance_rangeStatus(0=good) | |
258+
| Signal Rate | distance_signalRate | |
259+
260+
---
261+
## VCNL4040 proximity sensor
262+
263+
| []() | | |
264+
|---|---|---|
265+
| Proximity | prox(no unit) | none |
266+
| Ambient Light | ambient_lux | |
267+
268+
---
269+
## MCP9600 thermocouple amplifier
270+
271+
| []() | | |
272+
|---|---|---|
273+
| Temperature | thermo_degC | Degrees Centigrade |
274+
| Ambient Temperature | thermo_ambientDegC | Degrees Centigrade |
275+
276+
---
277+
## Qwiic PT100 ADS122C04 platinum resistance sensor
278+
279+
| []() | | |
280+
|---|---|---|
281+
| Temperature (C) | degC | Degrees Centigrade |
282+
| Temperature (F) | degF | Degrees Fahrenheit |
283+
| Temperature Internal | degC | Degrees Centigrade |
284+
| Raw Voltage | V*2.048/2^23 | Volts * 2.048 / 2<sup>23</sup> |
285+
286+
---
287+
## TMP117 precision temperature sensor
288+
289+
| []() | | |
290+
|---|---|---|
291+
| Temperature | degC | Degrees Centigrade |
292+
293+
---
294+
## NAU7802 load cell sensor
295+
296+
| []() | | |
297+
|---|---|---|
298+
| Weight | weight(no unit) | none |

0 commit comments

Comments
 (0)