docs

Author: gfwilliams

libs/banglejs/jswrap_bangle.c

@@ -2720,8 +2720,7 @@ call `E.kickWatchdog()` from your code or the watch will reset after ~5 seconds.
 * `hrmGreenAdjust` - (Bangle.js 2, 2v19+) if false (default is true) the green LED intensity won't be adjusted to get the HRM sensor 'exposure' correct. This is reset when the HRM is initialised with `Bangle.setHRMPower`.
 * `hrmWearDetect` - (Bangle.js 2, 2v19+) if false (default is true) HRM readings won't be turned off if the watch isn't on your arm (based on HRM proximity sensor). This is reset when the HRM is initialised with `Bangle.setHRMPower`.
 * `hrmPushEnv` - (Bangle.js 2, 2v19+) if true (default is false) HRM environment readings will be produced as `Bangle.on(`HRM-env`, ...)` events. This is reset when the HRM is initialised with `Bangle.setHRMPower`.
-* `seaLevelPressure` (Bangle.js 2) Normally 1013.25 millibars - this is used for
-  calculating altitude with the pressure sensor
+* `seaLevelPressure` (Bangle.js 2) Default 1013.25 millibars - this is used when calculating altitude from pressure sensor values from `Bangle.getPressure`/`pressure` events.
 * `lcdBufferPtr` (Bangle.js 2 2v21+) Return a pointer to the first pixel of the 3 bit graphics buffer used by Bangle.js for the screen (stride = 178 bytes)
 * `lcdDoubleRefresh` (Bangle.js 2 2v22+) If enabled, pulses EXTCOMIN twice per poll interval (avoids off-axis flicker)
 
@@ -5171,13 +5170,15 @@ void jswrap_banglejs_ioWr(JsVarInt mask, bool on) {
     "typescript" : "getPressure(): Promise<PressureData> | undefined;"
 }
 Read temperature, pressure and altitude data. A promise is returned which will
-be resolved with `{temperature, pressure, altitude}`.
+be resolved with `{temperature (C), pressure (hPa), altitude (meters)}`.
 
 If the Barometer has been turned on with `Bangle.setBarometerPower` then this
 will return with the *next* reading as of 2v21 (or the existing reading on 2v20 or earlier). If the Barometer is off,
 conversions take between 500-750ms.
 
-Altitude assumes a sea-level pressure of 1013.25 hPa
+Altitude assumes a sea-level pressure of 1013.25 hPa, but this cal be adjusted with
+a call to `Bangle.setOptions({ seaLevelPressure : 1013.25 })` - the Bangle.js Settings
+app contains a tool to adjust it.
 
 If there's no pressure device (for example, the emulator),
 this returns `undefined`, rather than a Promise.