Add calculated sensors (#127)

* Replicate AmbientWeather & Home Assistant calculated values.
Fixes #125

* Add LAST_RAIN

* Add heat index, wind chill, and feels like calculations

* Add more stuff

* Add dewpoint

* Bug fixing

* Clean up code comment

* Clean up code comments again

* Initial mocha test framework

* Add feels like unit tests, fix bugs

* Add comments and last unit test

* Update comment

* Add test running to PR build

* Address code review feedback

* Fix lastRain and add unit tests for it

* Add missing °

.github/workflows/pr.yml

@@ -0,0 +1,49 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+name: Node.js CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Use Node.js 14.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 14.x
+          cache: "npm"
+          cache-dependency-path: "package-lock.json"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build --if-present
+
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Use Node.js 14.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 14.x
+          cache: "npm"
+          cache-dependency-path: "package-lock.json"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Test
+        run: npm run test

.mocharc.jsonc

@@ -0,0 +1,8 @@
+{
+  "extensions": ["ts"],
+  "spec": "test/**/*.spec.*",
+  "node-option": [
+    "experimental-specifier-resolution=node",
+    "loader=ts-node/esm"
+  ]
+}

.vscode/settings.json

@@ -65,5 +65,11 @@
     "windgustmph",
     "windspeedmph"
   ],
-  "markdown.extension.toc.levels": "2..6"
-}
+  "markdown.extension.toc.levels": "2..6",
+  "mochaExplorer.logpanel": true,
+  "mochaExplorer.configFile": ".mocharc.jsonc",
+  "mochaExplorer.nodeArgv": [
+    "--loader=ts-node/esm",
+    "--no-warnings=ExperimentalWarning",
+    "--experimental-specifier-resolution=node"
+  ]}

README.md

@@ -12,6 +12,7 @@ The following Ambient Weather station models are confirmed to work: WS-2902C.
 - [Troubleshooting](#troubleshooting)
 - [Advanced settings](#advanced-settings)
 - [Supported sensors](#supported-sensors)
+- [Calculated sensors](#calculated-sensors)
 
 ## Installation and configuration
 
@@ -157,3 +158,16 @@ The following sensors are supported. Note that weather stations will only report
 | pm_in_temp_aqin               | Indoor temperature                                                  | Yes                                                 | No                  | °F      |
 | co2_in_aqin                   | Indoor CO2 meter reading                                            | Yes                                                 | No                  | ppm     |
 | co2_in_24h_aqin               | Indoor CO2 meter reading 24 hour average                            | Yes                                                 | No                  | ppm     |
+
+## Calculated sensors
+
+The following sensors are calculated using values from the weather station. Note that these will only be sent if the underlying values used for the calculation are available.
+
+| Name              | Description                                                    | Ambient Weather | Weather Underground | Unit      |
+| ----------------- | -------------------------------------------------------------- | --------------- | ------------------- | --------- |
+| dewpoint          | Outdoor dewpoint temperature                                   | Yes             | No                  | °F        |
+| dewpoint1..10     | Outdoor dewpoint temperature for sensors 1 through 10          | Yes             | Yes                 | °F        |
+| feelsLike         | Windchill, heat index, or temperature                          | Yes             | Yes                 | °F        |
+| feelsLike1..10    | Windchill, heat index, or temperature for sensors 1 through 10 | Yes             | Yes                 | °F        |
+| lastRain          | Last time hourlyRain was > 0                                   | Yes             | Yes                 | timestamp |
+| solarRadiationLux | Solar radiation (in lux)                                       | Yes             | Yes                 | lx        |