Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
pro2_compact_receiver [2018/12/28 00:44]
werk_ag [Installing and Configuring the software]
pro2_compact_receiver [2019/05/05 20:11] (current)
werk_ag [Custom Box for the WeatherDuino Pro2 Compact receiver]
Line 12: Line 12:
 The Pro2 Compact uses a 32-bit Tensilica L106 microcontroller running at 80Mhz, which makes it the fastest of all the WeatherDuino receivers.\\ The Pro2 Compact uses a 32-bit Tensilica L106 microcontroller running at 80Mhz, which makes it the fastest of all the WeatherDuino receivers.\\
 Navigation through the several data screens is simply achieved using the touch screen. A touch on the right-hand side advances to the next data screen; a touch on the left-hand side returns to the previous data screen. There is also a menu screen which allows direct and quick navigation to any of the other data screens.\\ Navigation through the several data screens is simply achieved using the touch screen. A touch on the right-hand side advances to the next data screen; a touch on the left-hand side returns to the previous data screen. There is also a menu screen which allows direct and quick navigation to any of the other data screens.\\
 +\\
 You can see it in action on the short video below. Notice how fast it refreshes the data screens! You can see it in action on the short video below. Notice how fast it refreshes the data screens!
  
-{{http://​www.meteocercal.info/​forum/​videos/​Pro2_Compact_Video01.mp4}}+{{https://​www.meteocercal.info/​forum/​videos/​Pro2_Compact_Video01.mp4|}} 
 +\\ 
 +NOTE: This video was done from an unit running an older software, current software uses smooth fonts and new icons giving a much better look to all data screens. 
  
 ===== Principal characteristics of the Pro2 Compact receiver ===== ===== Principal characteristics of the Pro2 Compact receiver =====
Line 64: Line 68:
 //         ​WeatherDuino Pro2 Compact RF Receiver //         ​WeatherDuino Pro2 Compact RF Receiver
 //             ​Personal Credentials File //             ​Personal Credentials File
 +//
 + ​--------------------------------------------------------------------------------------
 +
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
 +//   WiFi Credentials ​
 +// --------------------------------------------------------------------------------------
 +#define WIFI_SSID ​       "​xxxxxxxxxxxx" ​             // WiFi Name
 +#define WIFI_PASSWORD ​   "​xxxxxxxxxxxx" ​             // WiFi Password
 +
 +
 +// --------------------------------------------------------------------------------------
 +//   OTA Settings ​
 +// --------------------------------------------------------------------------------------
 +const char* OTA_DEVICE_ID ​ = "​Pro2C-RX"; ​  // Define a unique ID for each Pro2 Compact RX (used to identify unit for OTA upload)
 +const uint16_t OTA_port ​   = 8266;         // This is the default port used for OTA. Once set, don't change.
 +
  
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-//   WiFi Credentials+//   Dark Sky API used for 4 Days Forecast
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-#define WIFI_SSID ​       "​My_WiFi_Station_ID"​ +// Sign up for an account at Dark Sky, change x's to your API key 
-#define WIFI_PASSWORD ​   ​"My_WiFi Password"+const String api_key = "xxxxxxxxxxxx";
  
-const char* OTA_DEVICE_ID ​ = "​Pro2C_RX"; ​   // Define a unique ID for each Pro2 Compact RX (used to identify unit for OTA upload) 
-const uint16_t OTA_port ​   = 8266;          // This is the port used for OTA. Once set, don't change. 
  
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-//   WU Credentials+//   WU Credentials ​
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-#define WUNDERGROUND_STATION_ID "xxxxxxxxxx" ​        // WU Station ID +#define WUNDERGROUND_STATION_ID "xxxxxxxxxxxx" ​        // WU Station ID 
-#define WUNDERGROUND_PWD ​       "xxxxxxxxxx" ​        // WU Station Key (It's more secure use Station Key than your WU account passw)+#define WUNDERGROUND_PWD ​       "xxxxxxxxxxxx" ​        // WU Station Key (It's more secure use Station Key than your WU account passw) 
 +//#define WUNDERGROUND_PWD ​     "​xxxxxxxxxxxx" ​        // Weather Underground password
  
-const String ​ WUNDERGROUND_API_KEY ​   = "​xxxxxxxxxxxxxxxxxx"; ​   // Required for the 4 Days forecast function. Getting an WU API key is free. 
 </​code>​ </​code>​
  
Line 88: Line 105:
  
 <WRAP round info 75%> A note for those accustomed to using other WeatherDuino receivers: \\ Unlike all other WeatherDuino Pro2 receivers, the Pro2 Compact receiver doesn'​t have the PROGRAM / RUN switch. \\ Programming / upgrading is normally done via OTA, and in most cases it can be done without having to stop the Weather Software (tested with CumulusMX running on a RaspBerry Pi). </​WRAP>​ <WRAP round info 75%> A note for those accustomed to using other WeatherDuino receivers: \\ Unlike all other WeatherDuino Pro2 receivers, the Pro2 Compact receiver doesn'​t have the PROGRAM / RUN switch. \\ Programming / upgrading is normally done via OTA, and in most cases it can be done without having to stop the Weather Software (tested with CumulusMX running on a RaspBerry Pi). </​WRAP>​
- 
  
 ===== Settings for the 4 Day Forecast ===== ===== Settings for the 4 Day Forecast =====
  
-In order to use the 4 Day Forecast, you need to have a valid Wunderground ​API key. +In order to use the 4 Day Forecast, you need to have a Dark Sky API key. If you don't have one, get it for free here: https://​darksky.net/​dev 
- +\\ 
-Once you have your WU API key, insert it in the Credentials.h file:+Once you have your API key, insert it in the Credentials.h file:
  
 <​code>​ <​code>​
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-//   WU Credentials+//   Dark Sky API used for 4 Days Forecast
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-const String ​ ​WUNDERGROUND_API_KEY ​   ​= "xxxxxxxxxxxxxxxxxxx";+// Sign up for an account at Dark Sky, change x's to your API key 
 +const String ​api_key ​= "xxxxxxxxxxxx";
 </​code>​ </​code>​
  
-Now, on the Config_Options.h tab, define some settings as the location ​for the 4 Day Forecast, language and units usedSee example below:+There is no need to set anything else to get the correct 4 days forecast for your location.\\ 
 +Just make sure you have correctly placed your location ​on the Config_Option.h\\
  
 <​code>​ <​code>​
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-//   WU Forecast ​Settings+//   Define your Weather Station location 
 +// 
 +//     >>>​ THIS SETTING IS VERY IMPORTANT! <<<​ 
 +// 
 +//   The more precise you define your location, the more accurate will be the 4 Days Forecast
 +//   Use decimal format for Latitude and Longitude, with at least 4 decimal places (preferably 5) 
 +//   ​LATITUDE: ​ 90.00000 to -90.00000 (negative for Southern hemisphere) 
 +//   ​LONGITUDE:​ 180.000 to -180.000 (negative for West) 
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-#​define ​FORECAST_MODE ​       1                           // 0= Get from a defined location1= Get from a defined WU Personal Weather ​Station (PWS)+#​define ​LATITUDE ​     39.22350 ​   ​// Put here your Station Latitude (up to 5 decimal placesdon't use less than 4 decimal places) 
 +#define LONGITUDE ​    ​-8.99650 ​   // Put here your Station ​Longitude ​(up to 5 decimal places, don't use less than 4 decimal places) 
 +#define ELEVATION ​    ​124 ​        // Put here your Station height above sea level in Meters (no decimal places) 
 +</​code>​
  
-// Used by Forecast Method 0 
-const String ​ WUNDERGROUND_COUNTRY ​   = "​PO";​ 
-const String ​ WUNDERGROUND_CITY ​      = "​ALCOENTRE";​ 
  
-// Used by Forecast Method 1 
-const String ​ WUNDERGROUND_PWS ​       = "​ICERCALC2";​ 
  
-const String ​ WUNDERGROUND_LANGUAGE ​  "​PT"; ​           // Language used on the 4 Days Forecastdefault is English languageCheck WU language codes here: https://www.wunderground.com/​weather/​api/​d/​docs?d=language-support +===== USB Programing ===== 
-const boolean IS_METRIC ​              = true;            // Metric or Imperial units in Forecast + 
-const boolean USE_PM ​                 = false; ​          // Keep this value at "​false"​ +When you are to program a new unit, or when the software upgrade requires updating the files stored ​on the SPIFFS memoryprograming should be done by USB.\\ 
-</​code>​+For more info about how to upload files to the SPIFFS memory see here: [[:programming_weatherduino_devices#​lolin_wemos_d1_r2_mini_how_to_upload_files_to_the_spiffs_memory|LOLIN (WeMos) D1 R2 & miniHow to upload files to the SPIFFS memory]]\\
  
-===== Over The Air Programing =====+===== Over The Air (OTA) Programing =====
  
-The WeatherDuino Pro2 Compact ​receiver ​can be upgraded / programmed by OTA. \\ For checking the requirements for this to work, please refer to this article: [[:​programming_weatherduino_devices#​ota_programming|OTA programming]]+On first use, the WeatherDuino Pro2 Compact ​receivert should be programmed using the USB cable, after that it can be upgraded / programmed by OTA, unless the upgrade requires updating files stored on the SPIFFS memory (which can only be done by USB connection). This info is given on each software version.\\ 
 +For checking the requirements for OTA to work, please refer to this article: [[:​programming_weatherduino_devices#​ota_programming|OTA programming]]
  
 When upgrading software by OTA, instead of choosing a COM port, choose the IP address of the device you want to upgrade / program. When upgrading software by OTA, instead of choosing a COM port, choose the IP address of the device you want to upgrade / program.
Line 135: Line 159:
 In the middle of the initialization,​ screen, you will see three letters (**T-W-R**) that will change from Red to Green once the corresponding data packet has been received. In the middle of the initialization,​ screen, you will see three letters (**T-W-R**) that will change from Red to Green once the corresponding data packet has been received.
  
-From the above, it is evident that if you don't have a Transmitter unit already working and transmitting data, the receiver will stay forever in the initialization sequence. This is why we recommend to anyone that is starting to build a WeatherDuino weather station, to always start by assembling the Transmitter unit first.+From the above, it is evident that if you don't have a Transmitter unit already working and transmitting data, the receiver will stay forever in the initialization sequence.\\ 
 +This is why we recommend to anyone that is starting to build a WeatherDuino weather station, to always start by assembling the Transmitter unit first.
  
 On subsequent restarts, the receiver also will remain in the initialization screen, until it receives data from the three main sensors referred above.\\ On subsequent restarts, the receiver also will remain in the initialization screen, until it receives data from the three main sensors referred above.\\
-Once the initialization sequence completes, the system is ready to communicate with your preferred weather software.+Once the initialization sequence completes, the system is ready to communicate with your preferred weather software.\\
  
  
-===== Custom Box for the WeatherDuino Pro2 Compact receiver ​=====+===== Accessing ​the internal webpage ​=====
  
-{{:wiki:​pro2compact_case2.jpg?400}}{{:wiki:​pro2compact_case.jpg?​400}}+If the webserver is enabled in Config_Options,​ just open your browser and type the IP address of the receiver followed by/weather.\\ 
 +ExampleIP_Address/​weather"​
  
-A member of the WeatherDuino Team (Jarek from Poland) has designed a custom case for the WeatherDuino Pro2 Compact receiver.\\ 
-Anyone with a 3D printer can print it at home, or order it through any of the several 3D print services available online.\\ 
-The required files are freely available here: https://​www.thingiverse.com/​thing:​3210539 
  
 +===== Navigating between data screens =====
  
 +All Weatherduino devices equipped with a 2.8" TTF screen use the same navigational scheme.\\
 +The order of each of the data screen can be defined by the user on the Config_Options\\
 +\\
 +{{:​wiki:​navigation.jpg?​nolink|}}
 ===== User Interface - List of available languages ===== ===== User Interface - List of available languages =====
  
Line 166: Line 194:
 <WRAP round help 75%> Is your language not on the list? \\ If so, maybe you could contribute to the project with a translation. It will not take more than an hour of your time, and a whole country will thank you. \\ </​WRAP>​ <WRAP round help 75%> Is your language not on the list? \\ If so, maybe you could contribute to the project with a translation. It will not take more than an hour of your time, and a whole country will thank you. \\ </​WRAP>​
  
-====== Where I can get the WeatherDuino Pro2 Compact? ====== 
  
-All information about prices, availability and how to order can be found here: [[http://​www.meteocercal.info/​forum/​Thread-Fully-Assembled-WeaterDuino-Pro2-Compact|WeatherDuino Pro2 Compact, prices and availability]].+===== Custom Box for the WeatherDuino Pro2 Compact ​receiver =====
  
-\\+{{:​wiki:​pro2compact_case2.jpg?​400|pro2compact_case2.jpg}}{{:​wiki:​pro2compact_case.jpg?​400|pro2compact_case.jpg}}
  
 +A member of the WeatherDuino Team (Jarek from Poland) has designed a custom case for the WeatherDuino Pro2 Compact receiver.\\
 +Anyone with access to a 3D printer can print it, or alternatively order it through any of the several 3D print services available online\\
 +The required files are freely available here: [[https://​www.thingiverse.com/​thing:​3210539|https://​www.thingiverse.com/​thing:​3210539]]
 +
 +If you don't have a 3D printer, you can order your case directly from online 3D printing services like [[https://​www.3dhubs.com|3Dhubs]].
 +
 +
 +====== Where I can get the WeatherDuino Pro2 Compact? ======
 +
 +All information about prices, availability and how to order can be found here: [[http://​www.meteocercal.info/​forum/​Thread-Fully-Assembled-WeaterDuino-Pro2-Compact|WeatherDuino Pro2 Compact, prices and availability]].
  
Print/export
QR Code
QR Code pro2_compact_receiver (generated for current page)