Adam Green
Web server based weather station using Sparkfun Weather Meters.
Dependencies: FatFileSystem mbed WeatherMeters SDFileSystem
WeatherMeters.h@0:616601bde9fb, 2012-02-23 (annotated)
- Committer:
- AdamGreen
- Date:
- Thu Feb 23 21:38:39 2012 +0000
- Revision:
- 0:616601bde9fb
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| AdamGreen | 0:616601bde9fb | 1 | /* Copyright 2012 Adam Green (http://mbed.org/users/AdamGreen/) |
| AdamGreen | 0:616601bde9fb | 2 | |
| AdamGreen | 0:616601bde9fb | 3 | Licensed under the Apache License, Version 2.0 (the "License"); |
| AdamGreen | 0:616601bde9fb | 4 | you may not use this file except in compliance with the License. |
| AdamGreen | 0:616601bde9fb | 5 | You may obtain a copy of the License at |
| AdamGreen | 0:616601bde9fb | 6 | |
| AdamGreen | 0:616601bde9fb | 7 | http://www.apache.org/licenses/LICENSE-2.0 |
| AdamGreen | 0:616601bde9fb | 8 | |
| AdamGreen | 0:616601bde9fb | 9 | Unless required by applicable law or agreed to in writing, software |
| AdamGreen | 0:616601bde9fb | 10 | distributed under the License is distributed on an "AS IS" BASIS, |
| AdamGreen | 0:616601bde9fb | 11 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| AdamGreen | 0:616601bde9fb | 12 | See the License for the specific language governing permissions and |
| AdamGreen | 0:616601bde9fb | 13 | limitations under the License. |
| AdamGreen | 0:616601bde9fb | 14 | */ |
| AdamGreen | 0:616601bde9fb | 15 | /* Header file for class to interface with Sparkfun Weather Meters: |
| AdamGreen | 0:616601bde9fb | 16 | http://www.sparkfun.com/products/8942 |
| AdamGreen | 0:616601bde9fb | 17 | */ |
| AdamGreen | 0:616601bde9fb | 18 | #ifndef _WEATHER_METERS_H_ |
| AdamGreen | 0:616601bde9fb | 19 | #define _WEATHER_METERS_H_ |
| AdamGreen | 0:616601bde9fb | 20 | |
| AdamGreen | 0:616601bde9fb | 21 | #include "WindVane.h" |
| AdamGreen | 0:616601bde9fb | 22 | #include "RainGauge.h" |
| AdamGreen | 0:616601bde9fb | 23 | #include "Anemometer.h" |
| AdamGreen | 0:616601bde9fb | 24 | |
| AdamGreen | 0:616601bde9fb | 25 | |
| AdamGreen | 0:616601bde9fb | 26 | namespace AFP |
| AdamGreen | 0:616601bde9fb | 27 | { |
| AdamGreen | 0:616601bde9fb | 28 | |
| AdamGreen | 0:616601bde9fb | 29 | /** A class to interface with the Sparkfun Weather Meters. |
| AdamGreen | 0:616601bde9fb | 30 | http://www.sparkfun.com/products/8942 |
| AdamGreen | 0:616601bde9fb | 31 | |
| AdamGreen | 0:616601bde9fb | 32 | This set of weather meters from Sparkfun includes anemometer (wind speed), |
| AdamGreen | 0:616601bde9fb | 33 | wind vane, and rain gauge. All of the sensors use reed switches so that |
| AdamGreen | 0:616601bde9fb | 34 | the electronics can detect motion/location in the sensor hardware via |
| AdamGreen | 0:616601bde9fb | 35 | magnets placed in the sensors without actually exposing the electonic |
| AdamGreen | 0:616601bde9fb | 36 | switches themselves to the elements. A reed switch closes as the |
| AdamGreen | 0:616601bde9fb | 37 | anemometer spins and the rain gauge empties. The wind vane includes |
| AdamGreen | 0:616601bde9fb | 38 | 8 reed switches, each with a different valued resistor attached so that |
| AdamGreen | 0:616601bde9fb | 39 | the voltage will vary depending on where the magnet in the vane is |
| AdamGreen | 0:616601bde9fb | 40 | located. |
| AdamGreen | 0:616601bde9fb | 41 | * Example: |
| AdamGreen | 0:616601bde9fb | 42 | * @code |
| AdamGreen | 0:616601bde9fb | 43 | #include <mbed.h> |
| AdamGreen | 0:616601bde9fb | 44 | #include "WeatherMeters.h" |
| AdamGreen | 0:616601bde9fb | 45 | |
| AdamGreen | 0:616601bde9fb | 46 | int main() |
| AdamGreen | 0:616601bde9fb | 47 | { |
| AdamGreen | 0:616601bde9fb | 48 | CWeatherMeters WeatherMeters(p9, p10, p15); |
| AdamGreen | 0:616601bde9fb | 49 | for (;;) |
| AdamGreen | 0:616601bde9fb | 50 | { |
| AdamGreen | 0:616601bde9fb | 51 | CWeatherMeters::SMeasurements Measurements; |
| AdamGreen | 0:616601bde9fb | 52 | |
| AdamGreen | 0:616601bde9fb | 53 | WeatherMeters.GetMeasurements(&Measurements); |
| AdamGreen | 0:616601bde9fb | 54 | |
| AdamGreen | 0:616601bde9fb | 55 | printf("Direction: %s\n", Measurements.WindDirectionString); |
| AdamGreen | 0:616601bde9fb | 56 | printf("Depth: %f\n",Measurements.Rainfall); |
| AdamGreen | 0:616601bde9fb | 57 | printf("Current speed: %f\n", Measurements.WindSpeed); |
| AdamGreen | 0:616601bde9fb | 58 | printf("Maximum speed: %f\n", Measurements.MaximumWindSpeed); |
| AdamGreen | 0:616601bde9fb | 59 | |
| AdamGreen | 0:616601bde9fb | 60 | wait(1.0f); |
| AdamGreen | 0:616601bde9fb | 61 | } |
| AdamGreen | 0:616601bde9fb | 62 | } |
| AdamGreen | 0:616601bde9fb | 63 | * @endcode |
| AdamGreen | 0:616601bde9fb | 64 | */ |
| AdamGreen | 0:616601bde9fb | 65 | class CWeatherMeters |
| AdamGreen | 0:616601bde9fb | 66 | { |
| AdamGreen | 0:616601bde9fb | 67 | protected: |
| AdamGreen | 0:616601bde9fb | 68 | CAnemometer m_Anemometer; |
| AdamGreen | 0:616601bde9fb | 69 | CRainGauge m_RainGauge; |
| AdamGreen | 0:616601bde9fb | 70 | CWindVane m_WindVane; |
| AdamGreen | 0:616601bde9fb | 71 | |
| AdamGreen | 0:616601bde9fb | 72 | public: |
| AdamGreen | 0:616601bde9fb | 73 | /** A structure in which the current measurements registered by the weather |
| AdamGreen | 0:616601bde9fb | 74 | meters are returned from the GetMeasurements() method. |
| AdamGreen | 0:616601bde9fb | 75 | */ |
| AdamGreen | 0:616601bde9fb | 76 | struct SMeasurements |
| AdamGreen | 0:616601bde9fb | 77 | { |
| AdamGreen | 0:616601bde9fb | 78 | const char* WindDirectionString; /**< String representing current wind direction. Example: "North" */ |
| AdamGreen | 0:616601bde9fb | 79 | float WindDirectionAngle; /**< Wind direction in degrees from north. */ |
| AdamGreen | 0:616601bde9fb | 80 | float WindSpeed; /**< Current wind speed in km/hour. */ |
| AdamGreen | 0:616601bde9fb | 81 | float MaximumWindSpeed; /**< Maximum wind speed measured since last reset. Measured in km/hour. */ |
| AdamGreen | 0:616601bde9fb | 82 | float Rainfall; /**< Amount of rainfall since last reset. Measured in mm. */ |
| AdamGreen | 0:616601bde9fb | 83 | }; |
| AdamGreen | 0:616601bde9fb | 84 | |
| AdamGreen | 0:616601bde9fb | 85 | /** Create a CWeatherMeters object, binds it to the specified input pins, |
| AdamGreen | 0:616601bde9fb | 86 | and initializes the required interrupt handlers. |
| AdamGreen | 0:616601bde9fb | 87 | |
| AdamGreen | 0:616601bde9fb | 88 | @param AnemometerPin The mbed pin which is connected to the anemometer |
| AdamGreen | 0:616601bde9fb | 89 | sensor. Must be a pin on which the mbed supports InterruptIn. |
| AdamGreen | 0:616601bde9fb | 90 | @param RainGauagePin The mbed pin which is connected to the rain gauge |
| AdamGreen | 0:616601bde9fb | 91 | sensor. Must be a pin on which the mbed supports InterruptIn. |
| AdamGreen | 0:616601bde9fb | 92 | @param WindVanePin The mbed pin which is connected to the wind vane |
| AdamGreen | 0:616601bde9fb | 93 | sensor. Must be a pin on which the mbed supports AnalogIn. |
| AdamGreen | 0:616601bde9fb | 94 | @param WindVaneSeriesResistance The value of the resistance which is |
| AdamGreen | 0:616601bde9fb | 95 | in series with the wind vane sensor and along with the |
| AdamGreen | 0:616601bde9fb | 96 | varying resistance of the wind vane sensor itself, acts as a |
| AdamGreen | 0:616601bde9fb | 97 | voltage divider. |
| AdamGreen | 0:616601bde9fb | 98 | */ |
| AdamGreen | 0:616601bde9fb | 99 | CWeatherMeters(PinName AnemometerPin, |
| AdamGreen | 0:616601bde9fb | 100 | PinName RainGaugePin, |
| AdamGreen | 0:616601bde9fb | 101 | PinName WindVanePin, |
| AdamGreen | 0:616601bde9fb | 102 | float WindVaneSeriesResistance = 10000.0f); |
| AdamGreen | 0:616601bde9fb | 103 | |
| AdamGreen | 0:616601bde9fb | 104 | /** Gets current weather meter measurements. |
| AdamGreen | 0:616601bde9fb | 105 | |
| AdamGreen | 0:616601bde9fb | 106 | NOTE: Should call this method on a regular basis (every 15 minutes or |
| AdamGreen | 0:616601bde9fb | 107 | less) to keep internal timers from overflowing. |
| AdamGreen | 0:616601bde9fb | 108 | |
| AdamGreen | 0:616601bde9fb | 109 | @param pMeasurements points to the measurement structure to be filled in |
| AdamGreen | 0:616601bde9fb | 110 | with the current measurement from the sensors. The historical |
| AdamGreen | 0:616601bde9fb | 111 | values in this structure such as rainfall and maximum wind |
| AdamGreen | 0:616601bde9fb | 112 | speed can be reset by calls to ResetRainfall(), |
| AdamGreen | 0:616601bde9fb | 113 | ResetMaximumWindSpeed(), and Reset(). |
| AdamGreen | 0:616601bde9fb | 114 | */ |
| AdamGreen | 0:616601bde9fb | 115 | void GetMeasurements(SMeasurements* pMeasurements); |
| AdamGreen | 0:616601bde9fb | 116 | |
| AdamGreen | 0:616601bde9fb | 117 | /** Resets all historical measurements: rainfall and maximum wind speed. */ |
| AdamGreen | 0:616601bde9fb | 118 | void Reset(); |
| AdamGreen | 0:616601bde9fb | 119 | |
| AdamGreen | 0:616601bde9fb | 120 | /** Resets the cumulative rainfall measurement. */ |
| AdamGreen | 0:616601bde9fb | 121 | void ResetRainfall(); |
| AdamGreen | 0:616601bde9fb | 122 | |
| AdamGreen | 0:616601bde9fb | 123 | /** Resets the maximum wind speed measurement. */ |
| AdamGreen | 0:616601bde9fb | 124 | void ResetMaximumWindSpeed(); |
| AdamGreen | 0:616601bde9fb | 125 | }; |
| AdamGreen | 0:616601bde9fb | 126 | |
| AdamGreen | 0:616601bde9fb | 127 | } // namespace AFP |
| AdamGreen | 0:616601bde9fb | 128 | using namespace AFP; |
| AdamGreen | 0:616601bde9fb | 129 | |
| AdamGreen | 0:616601bde9fb | 130 | #endif // _WEATHER_METERS_H_ |