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
wireless_display_units [2018/12/28 00:48]
werk_ag [Compiling the software]
wireless_display_units [2019/03/18 02:25] (current)
werk_ag [Overview]
Line 13: Line 13:
   * Powered by any 5V 500mA micro-USB power supply (almost any phone charger will work).   * Powered by any 5V 500mA micro-USB power supply (almost any phone charger will work).
  
-^{{  :​wiki:​weatherduino_4pro_wd_esp8266_04_web.jpg?​nolink&​400x267 ​ |ASCII}}^{{ ​ :wiki:weatherduino_4pro_wd_esp8266_05_web.jpg?​nolink&​400x267 ​ ​|ASCII}}|+^{{  :​wiki:​screenshot_2019_3_18_1_38_21.png?​nolink&​330x250 ​ |ASCII}}^{{  :​wiki:​weatherduino_4pro_wd_esp8266_04_web.jpg?​nolink&​400x267 ​ |ASCII}}^{{ ​ :wiki:screenshot_2019_3_18_1_40_7.png?​nolink&​330x250 ​ ​|ASCII}}| 
 + 
 +\\ 
  
 ===== Installing and Configuring the software ===== ===== Installing and Configuring the software =====
Line 23: Line 26:
   * some other details, such as the ID of the your existing weather station.   * some other details, such as the ID of the your existing weather station.
  
-Out of the box the unit doesn'​t have a working WiFi connection, so initially you should use the USB connection. Later software upgrades can be done via OTA. \\ If you haven'​t done it yetdownload ​the latest software from the [[http://​www.meteocercal.info/​forum|WeatherDuino support forum]]. \\+If you haven'​t done it yet, download the latest software from the [[http://​www.meteocercal.info/​forum|WeatherDuino support forum]].\\ 
 +Out of the box the unit doesn'​t have a working WiFi connection, so initially, to program it, you should use the USB connection.\\ 
 +Later software upgrades can be done via 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.\\ 
 In common with all WeatherDuino devices, programming is done using the Arduino IDE. In common with all WeatherDuino devices, programming is done using the Arduino IDE.
  
Line 32: Line 38:
 ===== Settings for the 4 Day Forecast ===== ===== Settings for the 4 Day Forecast =====
  
-In order to use the 4Day Forecast you need to have a valid Wunderground ​API key. +In order to use the 4 Day Forecastyou 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+Once you have your API key, insert it in the Credentials.h ​file:
  
 <​code>​ <​code>​
-// +// -------------------------------------------------------------------------------------- 
- -------------------------------------------------------------------------------------- +//   Dark Sky API used for 4 Days Forecast 
-//   WU Credentials +// -------------------------------------------------------------------------------------- 
-// +// Sign up for an account at Dark Sky, change x's to your API key 
- -------------------------------------------------------------------------------------- +const String ​api_key ​= "xxxxxxxxxxxx";
-const String ​ ​WUNDERGROUND_API_KEY ​   ​= "xxxxxxxxxxxxxxxxxxx";+
 </​code>​ </​code>​
  
-Now, in the Config_Options.h you just have to define ​some settings as the location for the 4 Day Forecast, language and units used. See example below:+Now, in the Config_Options.h you just have to define ​your location for the 4 Day Forecast. See example below:
  
 <​code>​ <​code>​
-// +// -------------------------------------------------------------------------------------- 
- -------------------------------------------------------------------------------------- +//   Dark Sky 4 Days Forecast Settings 
-//   WU Forecast Settings +// -------------------------------------------------------------------------------------- ​                                                  ​ 
-// +// Set the forecast longitude and latitude to at least 4 decimal places 
- -------------------------------------------------------------------------------------- +// Hint: Use the same values set on the WeatherDuino Receiver
-#define FORECAST_MODE ​       1                           // 0= Get from a defined location, 1= Get from a defined WU Personal Weather Station (PWS) +
- +
-// 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 Forecast, default is English languageCheck WU language codes here: https://www.wunderground.com/​weather/​api/​d/​docs?​d=language-support +const String ​latitude =  "​xx.xxxxx"; ​   // 90.0000 to -90.0000 negative for Southern hemisphere 
-const boolean IS_METRIC ​              true           // Metric or Imperial units in Forecast +const String longitude ​"​xxx.xxxxx"​  ​// 180.000 to -180.000 negative for West
-const boolean USE_PM ​                 = false; ​          // Keep this value at "​false"​+
 </​code>​ </​code>​
  
Line 70: Line 66:
  
 Your unit may have one of two different types of Touch Panel. When programming you should define the correct type installed in your own unit. \\ Identifying the type of Touch Panel is very easy: look on the front side of the screen, if the touch panel connections are on the top left, it is type 1, if they are on the bottom left then it is type 2 (e.g. The touch panel shown in the pictures on this page is type 2) Your unit may have one of two different types of Touch Panel. When programming you should define the correct type installed in your own unit. \\ Identifying the type of Touch Panel is very easy: look on the front side of the screen, if the touch panel connections are on the top left, it is type 1, if they are on the bottom left then it is type 2 (e.g. The touch panel shown in the pictures on this page is type 2)
 +Usually, units are supplied with a touch panel of type 1.
  
 <​code>​ <​code>​
Line 85: Line 82:
 Check if the LOLIN (WeMos) D1 R2 & mini is available in your list of boards (Arduino IDE Tools > Boards). If it isn't, then follow these instructions:​ [[:​programming_weatherduino_devices#​wemos_d1_r2_mini_isn_t_listed_in_my_list_of_available_boards_how_to_add_it|LOLIN (WeMos) D1 R2 & mini isn't listed in my list of available boards. How to add it]]? \\ Check if the LOLIN (WeMos) D1 R2 & mini is available in your list of boards (Arduino IDE Tools > Boards). If it isn't, then follow these instructions:​ [[:​programming_weatherduino_devices#​wemos_d1_r2_mini_isn_t_listed_in_my_list_of_available_boards_how_to_add_it|LOLIN (WeMos) D1 R2 & mini isn't listed in my list of available boards. How to add it]]? \\
 Once you have the WeMos D1 R2 & mini in the list of boards, select it and choose the COM port. Compile the code and upload, that's all. Once you have the WeMos D1 R2 & mini in the list of boards, select it and choose the COM port. Compile the code and upload, that's all.
 +
 +===== USB Programing =====
 +
 +When you are to program a new unit, or when the software upgrade requires updating the files stored on the SPIFFS memory, programing should be done by USB.\\
 +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 & mini. How to upload files to the SPIFFS memory]]? \\
  
 ===== Over The Air (OTA) Programing ===== ===== Over The Air (OTA) Programing =====
  
-On first use, the WeatherDuino 4Pro Wireless Display unit should be programmed using the USB cable, after that it 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 4Pro Wireless Display unit 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 this 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.
Print/export
QR Code
QR Code wireless_display_units (generated for current page)