diff --git a/libraries/uv-sensor/.github/workflows/arduino-lint.yml b/libraries/uv-sensor/.github/workflows/arduino-lint.yml index b2ca058c..8a26f14a 100644 --- a/libraries/uv-sensor/.github/workflows/arduino-lint.yml +++ b/libraries/uv-sensor/.github/workflows/arduino-lint.yml @@ -6,7 +6,7 @@ jobs: lint: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 - uses: arduino/arduino-lint-action@v1 with: library-manager: update diff --git a/libraries/uv-sensor/.github/workflows/arduino_test_runner.yml b/libraries/uv-sensor/.github/workflows/arduino_test_runner.yml index 096b975b..fadfa904 100644 --- a/libraries/uv-sensor/.github/workflows/arduino_test_runner.yml +++ b/libraries/uv-sensor/.github/workflows/arduino_test_runner.yml @@ -8,7 +8,7 @@ jobs: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 - uses: ruby/setup-ruby@v1 with: ruby-version: 2.6 diff --git a/libraries/uv-sensor/.github/workflows/jsoncheck.yml b/libraries/uv-sensor/.github/workflows/jsoncheck.yml index 04603d08..37a11298 100644 --- a/libraries/uv-sensor/.github/workflows/jsoncheck.yml +++ b/libraries/uv-sensor/.github/workflows/jsoncheck.yml @@ -10,7 +10,7 @@ jobs: test: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 - name: json-syntax-check uses: limitusus/json-syntax-check@v1 with: diff --git a/libraries/uv-sensor/CHANGELOG.md b/libraries/uv-sensor/CHANGELOG.md index 36d6a2f8..4fdc0946 100644 --- a/libraries/uv-sensor/CHANGELOG.md +++ b/libraries/uv-sensor/CHANGELOG.md @@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/). +## [0.1.2] - 2023-01-23 +- update GitHub actions +- update license 2023 +- update readme.md + + ## [0.1.1] - 2022-11-26 - Add RP2040 support to build-CI. - Add CHANGELOG.md diff --git a/libraries/uv-sensor/LICENSE b/libraries/uv-sensor/LICENSE index 5777550e..088bbaf1 100644 --- a/libraries/uv-sensor/LICENSE +++ b/libraries/uv-sensor/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2021-2022 Rob Tillaart +Copyright (c) 2021-2023 Rob Tillaart Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/libraries/uv-sensor/README.md b/libraries/uv-sensor/README.md index 6bf172c6..5a7d1ff1 100644 --- a/libraries/uv-sensor/README.md +++ b/libraries/uv-sensor/README.md @@ -21,50 +21,49 @@ This small (type-less) UV-sensor is powered by 3.3 .. 5 V so it can be used by a The sensor has an analogue output that is roughly linear with the UV-index (sunlight assumed, see notes) -| Voltage | UV index | -|:-------:|:--------:| -| <0.050 | 0 | -| 0.227 | 1 | -| 0.318 | 2 | -| 0.408 | 3 | -| 0.503 | 4 | -| 0.606 | 5 | -| 0.696 | 6 | -| 0.795 | 7 | -| 0.881 | 8 | -| 0.976 | 9 | -| 1.079 | 10 | -| 1.170> | 11 | +| Voltage | UV index | risk of harm | Colour | +|:---------:|:----------:|:---------------|:---------:| +| <0.050 | 0 | low | Green | +| 0.227 | 1 | low | Green | +| 0.318 | 2 | low | Green | +| 0.408 | 3 | moderate | Yellow | +| 0.503 | 4 | moderate | Yellow | +| 0.606 | 5 | moderate | Yellow | +| 0.696 | 6 | high | Orange | +| 0.795 | 7 | high | Orange | +| 0.881 | 8 | very high | Red | +| 0.976 | 9 | very high | Red | +| 1.079 | 10 | very high | Red | +| 1.170> | 11 | extreme | Purple | + From this table the formula is derived (spreadsheet) which is pretty linear between UV 1 and 11. -Related to: https://github.com/RobTillaart/AnalogUVSensor +There is an extended library version which has more functionality and documentation. +- https://github.com/RobTillaart/AnalogUVSensor ### Notes -Note: The sensor is not calibrated and the table is indicative for sunlight (assumption!) and therefore not suitable for e.g. medical or industrial usage. +Note: The sensor is not calibrated and the table is indicative for sunlight (assumption!) +and therefore not suitable for e.g. medical or industrial usage. -Note: UV radiation will not go through glass, so inside you will most likely always read zero. This may help to calibrate the zero level of the sensor. +Note: UV radiation will not go through glass, so inside you will most likely always read zero. +This may help to calibrate the zero level of the sensor. Note: depending on the light source used, the table above is incorrect. +#### Sensitivity -### Sensitivity - -The sensor is sensitive for wavelengths from 200 - 370 nm, so mostly in UVB and UVA region and less in the UVC. +The sensor is sensitive for wavelengths from 200 - 370 nm, so mostly in UVB and UVA region and less in the UVC. https://en.wikipedia.org/wiki/Ultraviolet -### Future +## Future + +Future development will be done in the library version only. +- https://github.com/RobTillaart/AnalogUVSensor -- verify vs calibrated sensor. -- investigate angle sensitivity (if the UV light comes from an angle). -- investigate response time to stabilize (e.g. does it react fast on clouds). -- investigate with different light sources (UVled, TL, sunlight). -- allow use of internal / external ADC. -- add a pin to control the power of the sensor (low energy applications). -- diff --git a/libraries/uv-sensor/examples/uv-sensor/uv-sensor.ino b/libraries/uv-sensor/examples/uv-sensor/uv-sensor.ino index a555c04e..e3c97ccc 100644 --- a/libraries/uv-sensor/examples/uv-sensor/uv-sensor.ino +++ b/libraries/uv-sensor/examples/uv-sensor/uv-sensor.ino @@ -1,7 +1,6 @@ // // FILE: UV_sensor.ino // AUTHOR: Rob Tillaart -// VERSION: 0.1.1 // PURPOSE: demo // DATE: 2021-09-21 diff --git a/libraries/uv-sensor/uv-sensor.ino b/libraries/uv-sensor/uv-sensor.ino index a555c04e..e3c97ccc 100644 --- a/libraries/uv-sensor/uv-sensor.ino +++ b/libraries/uv-sensor/uv-sensor.ino @@ -1,7 +1,6 @@ // // FILE: UV_sensor.ino // AUTHOR: Rob Tillaart -// VERSION: 0.1.1 // PURPOSE: demo // DATE: 2021-09-21