wildernesslabs / clima Goto Github PK

Climate Station App

License: Apache License 2.0

C# 100.00%

clima's Introduction

Clima is a solar-powered, custom embedded-IoT solution that tracks climate from a suite of sensors, saves data locally for access via Bluetooth, uses a RESTful Web API, and synchronizes data to the cloud.

Clima Pro
Assembly Instructions
Getting Started
Hardware Specifications
Support

Clima

With this kit, it includes the complete package of sensors, PCB enclosure and mount to place this outdoors. You'll be able to measure wind speed/direction, rain volume, atmospheric conditions like temperature, pressure, humidity, CO2 levels and GPS Coordinates.

Assembly Instructions

A complete kit of Clima.Pro can be found on the Wilderness Labs Store and the Instructions for assembly can be found here.

The store version is 100% kit complete, including the option to upgrade the PCB, Enclosure and Battery only, if you include a previous version of the kit.

You can also source all of the components yourself. For a list of components see the Clima Pro Bill of Material (BoM)

Getting Started

To simplify the way to use this Meadow-powered reference IoT product, we've created a NuGet package that instantiates and encapsulates the onboard hardware into a Clima class.

Add the ProjectLab Nuget package your project:
- dotnet add package Meadow.Clima, or
- Meadow.Clima Nuget Package
Change the App type on your MeadowApp class to ClimaAppBase and initialize Clima's MainController passing the Hardware and a INetworkAdapter such as your WiFi adapter onboard the Meadow Core Compute Module:

public class ClimaApp : ClimaAppBase
{
    public override Task Initialize()
    {
        Resolver.Log.Info($"Initialize...");

        var mainController = new MainController();

        var wifi = Hardware.ComputeModule.NetworkAdapters.Primary<IWiFiNetworkAdapter>();

        mainController.Initialize(
            hardware: Hardware,
            networkAdapter: wifi);
            .
            .
            .

Run the Clima_Demo project that does periodic readings of all its sensors and sends them to Meadow.Cloud if you have a Wilderness Labs account and have provisioned your device.

Hardware Specifications

You can find the schematics and other design files in the Hardware_Design folder.

Support

Having trouble building/running these projects?

File an issue with a repro case to investigate, and/or
Join our public Slack, where we have an awesome community helping, sharing and building amazing things using Meadow.

clima's People

Contributors

Stargazers

Watchers

Forkers

devbox10 houstonhaynes summersk aholmes jpansarasa eddiegarmon doingnz

clima's Issues

Need to add a known issues re network stability

Project won't build

I'm getting Secrets and ConnectionStatus issues that confound me - I'm not sure why either is occurring as secrets are populated and present and the namespacing matches up.

Hardware/Feature Requests for vNext (v5?)

For the next version of Clima, I propose the following features:

A fan relay.
We're using a temp sensor of the board, and having that in the enclosure that could be in the sun could yield data that isn't great. Adding a small 30mm case fan could help.
Screw terminals for an external thermistor
For the reason above, the option of an external wired thermistor would be good
A light sensor and light pipe
Being able to determine if we're in daylight/direct sun may also assist with #1 above
A battery-backed RTC
When the device boots it may or may not have a network connection. If it starts logging data before an NTP time comes in, we need to do math to back-correct those data points, which is not fun.
Remove the GPS
It's used for locating the device, but typically there are fixed-mount so it seems like a lot of BOM cost for a one-time data point that could be achieved in another way
4-pin header for an SSD1306 I2C display
The ability to optionally plug in a small I2C display is extremely helpful for development and testing.

Add RGB LED to Clima Pro's PCB as a status indicator

It's hard to tell if Meadow App is running properly once deployed out in the field with no visible indication that the app is running, or the system is turned on.

Wind direction is uncalibrated

The wind direction from the wind vane reports a 0-360 value, presumably from some fixed point on the hardware. It bears no relation to the actual installed orientation to true north, so the reported direction is only going to be right by accident of install. The app needs to support a calibration offset and there needs to be some way to set/update that offset after the hardware is installed.

Send Data From Meadow to an ASP .NET Server via WiFi Out of Date

For my first practice project I chose the sample project Send Data From Meadow to an ASP .NET Server via WiFi after the Hello, LED project. The coding portion in the linked directions cannot be followed to complete the project. Copying the sample project on GitHub probably will allow me to complete the project.

Recommendation to add section or badge marking out of date or previous version to links providing directions that will not allow you to complete a project. Label is probably most useful for guiding first time users to their first project.

Wind speed should be sampled and averaged

Like wind direction, wind speed is read once per minute. It should be sampled more frequently and return both a mean (wind speed) and max (gust speed)

meadow.core not found in local repository (also Meadow.Foundation not found when present)

Looks like the Clima project has a dependency on Meadow.Core.

PS C:\repo\Clima\Source\Clima> dotnet restore Clima.sln C:\Program Files\dotnet\sdk\5.0.200-preview.21079.7\NuGet.targets(290,5): error MSB3202: The project file "C:\repo\Meadow.Core\source\Meadow.Units\Meadow.Units.csproj" was not found. [C:\repo\Clima\Source\Clima\Clima.sln]

I'm also seeing this error which I assume is because the restore is failing.

'C:\repo\Meadow.Foundation\Source\Meadow.Foundation.Peripherals\Sensors.Weather.WindVane\Driver\Sensors.Weather.WindVane\Sensors.Weather.WindVane.csproj'. If you are using Visual Studio, this may be because the project is unloaded or not part of the current solution so run a restore from the command-line. Otherwise, the project file may be invalid or missing targets required for restore. WilderenessLabs.Clima.Meadow.Pro.HardwareDiagnostics C:\repo\Clima\Source\Clima\WilderenessLabs.Clima.Meadow.Pro.HardwareDiagnostics\WilderenessLabs.Clima.Meadow.Pro.HardwareDiagnostics.csproj'

Is there a place where I can get Meadow.Core? I can't seem to lay my eyes on it here in your public repo.

Add rain sensor logic

Wind direction should be sampled and report the median

Right now the Clima samples wind direction periodically (one a minute) and reports direction. Physically I see it moving a whole lot, so that number is going to be poor for accuracy. We should probably sample more frequently and return a something more like a rolling-median average of direction.

Add solar intensity logic

Potential problem/improvement for rain cover?

I'm no expert, so this is just a hunch on my part, but I feel like the rain cover would work better if the "covers" had some "overhang" with respect to the gaps rather than being "flush" with them. Currently it seems like it wouldn't take much for a raindrop with some force to get some upward momentum and sneak right in if it hit just below a gap.

I've drawn some pink lines in an attempt to illustrate what I think the problem could be: