Skip to content

Commit a12ece7

Browse files
committed
Update copyrights, fix example docs and release
Signed-off-by: Sara Damiano <sdamiano@stroudcenter.org>
1 parent baab5ad commit a12ece7

File tree

22 files changed

+217
-117
lines changed

22 files changed

+217
-117
lines changed

.github/workflows/prepare_release.yaml

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -130,10 +130,9 @@ jobs:
130130
id: changelog_reader
131131
uses: mindsers/changelog-reader-action@v2
132132
with:
133-
validation_depth: 10
134-
# NOTE: Need to add the refs/tags to work with the generate notes action
135-
version: ${{ format('refs/tags/{0}', env.VERSION) }}
136133
path: ./CHANGELOG.md
134+
version: ${{ env.VERSION }}
135+
validation_depth: 10
137136

138137
# I use the first line of the change log entry as the name, so read it here
139138
# - name: Get release name
@@ -149,9 +148,9 @@ jobs:
149148
env:
150149
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
151150
with:
152-
tag_name: ${{ env.VERSION }}
153-
# name: ${{ format('{0} - {1}', env.VERSION, steps.get_release_name.outputs.release_name) }}
154-
name: ${{ env.VERSION }}
151+
tag_name: ${{ format('v{0}',env.VERSION) }}
152+
# name: ${{ format('v{0} - {1}', env.VERSION, steps.get_release_name.outputs.release_name) }}
153+
name: ${{ format('v{0}',env.VERSION) }}
155154
draft: ${{ steps.changelog_reader.outputs.status == 'unreleased' }}
156155
prerelease: ${{ steps.changelog_reader.outputs.status == 'prereleased' }}
157156
body: ${{ steps.changelog_reader.outputs.changes }}

CHANGELOG.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
99

1010
## [Unreleased]
1111

12-
## [0.32.0] - 2021-11-18
12+
## [0.32.0] - 2021-11-19
1313
Reinstate support for AOSong DHT
1414

1515
### Changed
1616
- **Documentation:** Restructured the changelog
17+
- **Documentation:** Restyled and corrected documentation links for new and renamed DRWI examples
1718
- **Continuous Integration:** Updated changelog reader and automated releaser
1819

1920
### Added
@@ -32,6 +33,9 @@ Fix build without AOSong DHT
3233
## [0.31.0] - 2021-11-02
3334
Remove support for AOSong DHT
3435

36+
### Added
37+
- **Examples:** Added a new example for the DRWI site using the new EnviroDIY bee based on the SIMCOM SIM7080G
38+
3539
### Removed
3640
- **Breaking:** Temporarily **_REMOVED_** support for AOSong DHT sensor.
3741
- Intend to restore this after updating to support newest Adafruit DHT library

VERSION

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
v0.32.0
1+
0.32.0

docs/documentExamples.py

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,9 @@
1313
"../examples/baro_rho_correction/ReadMe.md",
1414
"../examples/data_saving/ReadMe.md",
1515
"../examples/double_logger/ReadMe.md",
16-
"../examples/DRWI_CitSci/ReadMe.md",
17-
"../examples/DRWI_LTE/ReadMe.md",
16+
"../examples/DRWI_2G/ReadMe.md",
17+
"../examples/DRWI_DigiLTE/ReadMe.md",
18+
"../examples/DRWI_SIM7080LTE/ReadMe.md",
1819
"../examples/DRWI_NoCellular/ReadMe.md",
1920
"../examples/logging_to_MMW/ReadMe.md",
2021
"../examples/logging_to_ThingSpeak/ReadMe.md",

examples/DRWI_2G/DRWI_2G.ino

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
/** =========================================================================
2-
* @file DRWI_CitSci.ino
2+
* @file DRWI_2G.ino
33
* @brief Example for DRWI CitSci 2G sites.
44
*
55
* @author Sara Geleskie Damiano <sdamiano@stroudcenter.org>
6-
* @copyright (c) 2017-2020 Stroud Water Research Center (SWRC)
6+
* @copyright (c) 2017-2021 Stroud Water Research Center (SWRC)
77
* and the EnviroDIY Development Team
88
* This example is published under the BSD-3 license.
99
*

examples/DRWI_2G/ReadMe.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,6 @@ _______
131131

132132
[//]: # ( @section example_drwi_2g_pio_config PlatformIO Configuration )
133133

134-
[//]: # ( @include{lineno} DRWI_CitSci/platformio.ini )
134+
[//]: # ( @include{lineno} DRWI_2G/platformio.ini )
135135

136136
[//]: # ( @section example_drwi_2g_code The Complete Code )

examples/DRWI_DigiLTE/DRWI_DigiLTE.ino

Lines changed: 43 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
* @brief Example for DRWI CitSci LTE sites.
44
*
55
* @author Sara Geleskie Damiano <sdamiano@stroudcenter.org>
6-
* @copyright (c) 2017-2020 Stroud Water Research Center (SWRC)
6+
* @copyright (c) 2017-2021 Stroud Water Research Center (SWRC)
77
* and the EnviroDIY Development Team
88
* This example is published under the BSD-3 license.
99
*
@@ -62,10 +62,10 @@ const int8_t timeZone = -5; // Eastern Standard Time
6262
// Set the input and output pins for the logger
6363
// NOTE: Use -1 for pins that do not apply
6464
const int32_t serialBaud = 57600; // Baud rate for debugging
65-
const int8_t greenLED = 8; // Pin for the green LED
66-
const int8_t redLED = 9; // Pin for the red LED
67-
const int8_t buttonPin = 21; // Pin for debugging mode (ie, button pin)
68-
const int8_t wakePin = 31; // MCU interrupt/alarm pin to wake from sleep
65+
const int8_t greenLED = 8; // Pin for the green LED
66+
const int8_t redLED = 9; // Pin for the red LED
67+
const int8_t buttonPin = 21; // Pin for debugging mode (ie, button pin)
68+
const int8_t wakePin = 31; // MCU interrupt/alarm pin to wake from sleep
6969
// Mayfly 0.x D31 = A7
7070
// Set the wake pin to -1 if you do not want the main processor to sleep.
7171
// In a SAMD system where you are using the built-in rtc, set wakePin to 1
@@ -197,8 +197,10 @@ Variable* variableList[] = {
197197
new Modem_SignalPercent(&modem),
198198
};
199199

200-
// All UUID's, device registration, and sampling feature information can be pasted directly from Monitor My Watershed.
201-
//To get the list, click the "View token UUID list" button on the upper right of the site page.
200+
// All UUID's, device registration, and sampling feature information can be
201+
// pasted directly from Monitor My Watershed.
202+
// To get the list, click the "View token UUID list" button on the upper right
203+
// of the site page.
202204

203205
// *** CAUTION --- CAUTION --- CAUTION --- CAUTION --- CAUTION ***
204206
// Check the order of your variables in the variable list!!!
@@ -207,27 +209,40 @@ Variable* variableList[] = {
207209
// Do not change the order of the variables in the section below.
208210
// *** CAUTION --- CAUTION --- CAUTION --- CAUTION --- CAUTION ***
209211

210-
// Replace all of the text in the following section with the UUID array from MonitorMyWatershed
211-
212-
// --------------------- Beginning of Token UUID List ---------------------------------------
213-
214-
215-
const char* UUIDs[] = // UUID array for device sensors
216-
{
217-
"12345678-abcd-1234-ef00-1234567890ab", // Specific conductance (Meter_Hydros21_Cond)
218-
"12345678-abcd-1234-ef00-1234567890ab", // Water depth (Meter_Hydros21_Depth)
219-
"12345678-abcd-1234-ef00-1234567890ab", // Temperature (Meter_Hydros21_Temp)
220-
"12345678-abcd-1234-ef00-1234567890ab", // Turbidity (Campbell_OBS3_Turb) (Low)
221-
"12345678-abcd-1234-ef00-1234567890ab", // Turbidity (Campbell_OBS3_Turb) (High)
222-
"12345678-abcd-1234-ef00-1234567890ab", // Battery voltage (EnviroDIY_Mayfly_Batt)
223-
"12345678-abcd-1234-ef00-1234567890ab", // Temperature (Maxim_DS3231_Temp)
224-
"12345678-abcd-1234-ef00-1234567890ab", // Percent full scale (Digi_Cellular_SignalPercent)
212+
// Replace all of the text in the following section with the UUID array from
213+
// MonitorMyWatershed
214+
215+
// --------------------- Beginning of Token UUID List
216+
// ---------------------------------------
217+
218+
219+
const char* UUIDs[] = // UUID array for device sensors
220+
{
221+
"12345678-abcd-1234-ef00-1234567890ab", // Specific conductance
222+
// (Meter_Hydros21_Cond)
223+
"12345678-abcd-1234-ef00-1234567890ab", // Water depth
224+
// (Meter_Hydros21_Depth)
225+
"12345678-abcd-1234-ef00-1234567890ab", // Temperature
226+
// (Meter_Hydros21_Temp)
227+
"12345678-abcd-1234-ef00-1234567890ab", // Turbidity
228+
// (Campbell_OBS3_Turb) (Low)
229+
"12345678-abcd-1234-ef00-1234567890ab", // Turbidity
230+
// (Campbell_OBS3_Turb) (High)
231+
"12345678-abcd-1234-ef00-1234567890ab", // Battery voltage
232+
// (EnviroDIY_Mayfly_Batt)
233+
"12345678-abcd-1234-ef00-1234567890ab", // Temperature
234+
// (Maxim_DS3231_Temp)
235+
"12345678-abcd-1234-ef00-1234567890ab", // Percent full scale
236+
// (Digi_Cellular_SignalPercent)
225237
};
226-
const char* registrationToken = "12345678-abcd-1234-ef00-1234567890ab"; // Device registration token
227-
const char* samplingFeature = "12345678-abcd-1234-ef00-1234567890ab"; // Sampling feature UUID
238+
const char* registrationToken =
239+
"12345678-abcd-1234-ef00-1234567890ab"; // Device registration token
240+
const char* samplingFeature =
241+
"12345678-abcd-1234-ef00-1234567890ab"; // Sampling feature UUID
228242

229243

230-
// ----------------------- End of Token UUID List ------------------------------------------
244+
// ----------------------- End of Token UUID List
245+
// ------------------------------------------
231246

232247
// Count up the number of pointers in the array
233248
int variableCount = sizeof(variableList) / sizeof(variableList[0]);
@@ -314,8 +329,9 @@ void setup() {
314329
// Blink the LEDs to show the board is on and starting up
315330
greenredflash();
316331

317-
pinMode(20, OUTPUT); //for proper operation of the onboard flash memory chip's ChipSelect (Mayfly v1.0 and later)
318-
332+
pinMode(20, OUTPUT); // for proper operation of the onboard flash memory
333+
// chip's ChipSelect (Mayfly v1.0 and later)
334+
319335
// Set the timezones for the logger/data and the RTC
320336
// Logging in the given time zone
321337
Logger::setLoggerTimeZone(timeZone);

examples/DRWI_DigiLTE/ReadMe.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
[//]: # ( @page example_drwi_lte DRWI CitSci LTE Sites )
2-
# Example using the Modular Sensors Library for DRWI Sites
1+
[//]: # ( @page example_drwi_digilte DRWI CitSci Digi LTE Sites )
2+
# Example using the Modular Sensors Library for DRWI Digi LTE Sites
33

44
This is the code example that should be used for all groups working with the Stroud Water Research Center within the Delaware River Watershed Initiative.
55
This should be used at all sites with cellular LTE service.
@@ -12,8 +12,8 @@ _______
1212
[//]: # ( @tableofcontents )
1313

1414
[//]: # ( Start GitHub Only )
15-
- [Example using the Modular Sensors Library for DRWI Sites](#example-using-the-modular-sensors-library-for-drwi-sites)
16-
- [Unique Features of the DRWI LTE Example](#unique-features-of-the-drwi-lte-example)
15+
- [Example using the Modular Sensors Library for DRWI Digi LTE Sites](#example-using-the-modular-sensors-library-for-drwi-digi-lte-sites)
16+
- [Unique Features of the DRWI Digi LTE Example](#unique-features-of-the-drwi-digi-lte-example)
1717
- [To Use this Example:](#to-use-this-example)
1818
- [Prepare and set up PlatformIO](#prepare-and-set-up-platformio)
1919
- [Set the logger ID](#set-the-logger-id)
@@ -25,15 +25,15 @@ _______
2525

2626
_______
2727

28-
[//]: # ( @section example_drwi_lte_unique Unique Features of the DRWI LTE Example )
29-
# Unique Features of the DRWI LTE Example
28+
[//]: # ( @section example_drwi_digilte_unique Unique Features of the DRWI Digi LTE Example )
29+
# Unique Features of the DRWI Digi LTE Example
3030
- Specifically for sites within the Delaware River Watershed Initiative.
3131
- Uses a Digi XBee3 LTE-M for live data.
3232

33-
[//]: # ( @section example_drwi_lte_using To Use this Example: )
33+
[//]: # ( @section example_drwi_digilte_using To Use this Example: )
3434
# To Use this Example:
3535

36-
[//]: # ( @subsection example_drwi_lte_pio Prepare and set up PlatformIO )
36+
[//]: # ( @subsection example_drwi_digilte_pio Prepare and set up PlatformIO )
3737
## Prepare and set up PlatformIO
3838
- Register a site and sensors at the Monitor My Watershed/EnviroDIY data portal (http://monitormywatershed.org/)
3939
- Create a new PlatformIO project
@@ -45,7 +45,7 @@ _______
4545
- Move it into the src directory of your project.
4646
- Delete main.cpp in that folder.
4747

48-
[//]: # ( @subsection example_drwi_lte_logger_id Set the logger ID )
48+
[//]: # ( @subsection example_drwi_digilte_logger_id Set the logger ID )
4949
## Set the logger ID
5050
- Change the "XXXX" in this section of code to the loggerID assigned by Stroud:
5151

@@ -54,7 +54,7 @@ _______
5454
const char *LoggerID = "XXXX";
5555
```
5656

57-
[//]: # ( @subsection example_drwi_lte_obs3_calibration Set the calibration coefficients for the Campbell OBS3+ )
57+
[//]: # ( @subsection example_drwi_digilte_obs3_calibration Set the calibration coefficients for the Campbell OBS3+ )
5858
## Set the calibration coefficients for the Campbell OBS3+
5959
- The OBS3+ ships with a calibration certificate; you need this sheet!
6060
- Change _**all**_ of the the `0.000E+00` and `1.000E+00` values in this section of code to the values on that calibration sheet.
@@ -84,7 +84,7 @@ const float OBSHigh_C = 0.000E+00; // "C" value [*high* range]
8484
CampbellOBS3 osb3high(OBS3Power, OBSHighADSChannel, OBSHigh_A, OBSHigh_B, OBSHigh_C, ADSi2c_addr, OBS3numberReadings);
8585
```
8686
87-
[//]: # ( @subsection example_drwi_lte_uuids Set the universally universal identifiers (UUID) for each variable )
87+
[//]: # ( @subsection example_drwi_digilte_uuids Set the universally universal identifiers (UUID) for each variable )
8888
## Set the universally universal identifiers (UUID) for each variable
8989
- Go back to the web page for your site at the Monitor My Watershed/EnviroDIY data portal (http://monitormywatershed.org/)
9090
- Find and click the white "View Token UUID List" button above the small map on your site page
@@ -122,15 +122,15 @@ const char* samplingFeature = "12345678-abcd-1234-ef00-1234567890ab"; // Sampli
122122

123123
```
124124

125-
[//]: # ( @subsection example_drwi_lte_upload Upload! )
125+
[//]: # ( @subsection example_drwi_digilte_upload Upload! )
126126
## Upload!
127127
- Test everything at home **before** deploying out in the wild!
128128

129129
_______
130130

131131

132-
[//]: # ( @section example_drwi_lte_pio_config PlatformIO Configuration )
132+
[//]: # ( @section example_drwi_digilte_pio_config PlatformIO Configuration )
133133

134-
[//]: # ( @include{lineno} DRWI_LTE/platformio.ini )
134+
[//]: # ( @include{lineno} DRWI_DigiLTE/platformio.ini )
135135

136-
[//]: # ( @section example_drwi_lte_code The Complete Code )
136+
[//]: # ( @section example_drwi_digilte_code The Complete Code )

examples/DRWI_DigiLTE/platformio.ini

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
; http://docs.platformio.org/page/projectconf.html
1010

1111
[platformio]
12-
description = ModularSensors example intended for DRWI users with CTD, turbidity, and LTE signal
12+
description = ModularSensors example intended for DRWI users with CTD, turbidity, and a Digi brand LTE modem
1313

1414
[env:mayfly]
1515
monitor_speed = 57600

examples/DRWI_NoCellular/DRWI_NoCellular.ino

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
* @brief Example for DRWI CitSci without cellular service.
44
*
55
* @author Sara Geleskie Damiano <sdamiano@stroudcenter.org>
6-
* @copyright (c) 2017-2020 Stroud Water Research Center (SWRC)
6+
* @copyright (c) 2017-2021 Stroud Water Research Center (SWRC)
77
* and the EnviroDIY Development Team
88
* This example is published under the BSD-3 license.
99
*

0 commit comments

Comments
 (0)