Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
wireless_display_units [2020/05/03 03:40] – [Settings for the 4 Day Forecast] werk_agwireless_display_units [2021/03/13 06:03] (current) – [Identify the Touch Panel type] werk_ag
Line 5: Line 5:
 ===== Overview ===== ===== Overview =====
  
-The 4Pro Wireless Display units act like a remote display of the main receiver. All data presented on the receiver screen is sent wirelessly to all 4Pro Wireless Display units.\\ +The 4Pro WiFi Wireless Display units act like a remote display of the main receiver. All data presented on the receiver screen is sent to all 4Pro WiFi Wireless Display units using your LAN network.\\ 
-You can use as many units as you wish, anywhere in the home, garden or any other place, and they always be in sync with your receiver. Range varies from 20 to 100 meters.\\ +You can use as many units as you wish, anywhere in the home, garden or any other place, and they always be in sync with your receiver.\\ 
-Using their built-in WiFi, these units can get a four days weather forecast provided for free by DarkSky.+Using their built-in WiFi, these units can get a forecast for the next twelve hours provided for free by OpenWeather.
  
-  * 4Pro Wireless Display units are supplied fully assembled and ready to work.+  * 4Pro WiFi Wireless Display units are supplied fully assembled and ready to work.
   * Can be upgraded via OTA.   * Can be upgraded via OTA.
   * 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).
Line 23: Line 23:
  
   * ID and password of your WiFi access point   * ID and password of your WiFi access point
-  * location for the four day forecast+  * location for the forecasts
   * 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.
  
Line 36: Line 36:
 {{:wiki:4pro_wd_config_options.jpg?nolink&|4pro_wd_config_options.jpg}} {{:wiki:4pro_wd_config_options.jpg?nolink&|4pro_wd_config_options.jpg}}
  
-===== Settings for the 4 Day Forecast =====+===== Settings for the 12 Hours Forecast =====
  
-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|https://darksky.net/dev]]\\+In order to use the 12 Hours Forecast, you need to have a OpenWeather API key. If you don't have one, get it for free here: [[https://openweathermap.org/api|https://openweathermap.org/api]]\\ 
 +Choose the free 5 day / 3 hour Forecast.\\
 Once you have your API key, insert it in the Credentials.h file: Once you have your API key, insert it in the Credentials.h file:
 <code> <code>
  
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-//   Dark Sky API used for 4 Days Forecast+//   OpenWeather API used for 12 Hours Forecast
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-// Sign up for an account at Dark Sky, change x'to your API key +// Sign up for an account at Open Weather to get your free API Key. 
-const String api_key = "xxxxxxxxxxxx";+const char* OpenWeather_api_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
  
 </code> </code>
  
-Now, in the Config_Options.h you just have to define your location for the 4 Day Forecast. See example below:+Now, in the Config_Options.h you just have to define your location for the Forecast. See example below:
  
 <code> <code>
 // -------------------------------------------------------------------------------------- // --------------------------------------------------------------------------------------
-//   Dark Sky 4 Days Forecast Settings +//   OPEN WEATHER 12 Hours Forecast Settings 
-// -------------------------------------------------------------------------------------- +// --------------------------------------------------------------------------------------                                                    
-// Set the forecast longitude and latitude to at least 4 decimal places +// 
-// Hint: Use the same values set on the WeatherDuino Receiver+//     >>> THIS SETTING IS VERY IMPORTANT! <<< 
 +// 
 +//   The more precise you define your location, the more accurate will be the 12 Hour 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) 
 +//   HINT: Use the same values defined on the receiver
  
-const String latitude  "xx.xxxxx";    // 90.0000 to -90.0000 negative for Southern hemisphere +const char* Latitude   = "XX.XXXXX";  
-const String longitude = "xxx.xxxxx";   // 180.000 to -180.000 negative for West+const char* Longitude  = "-X.XXXXX"; 
  
 </code> </code>
  
  
-===== Identify the Touch Panel type ===== +===== Define the Touch Panel type =====
- +
-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.+
  
 +Your unit may have different types of Touch Panel. When programming you should define the correct type installed in your own unit.\\
 <code> <code>
-// Define type of your TFT Touch Panel 
 // //
  --------------------------------------------------------------------------------------  --------------------------------------------------------------------------------------
-//   TFT Display Touch Panel type+//   TFT Display Type - PAY ATTENTION TO THIS 
 +//   This setting mostly affects how the Touch Panel work 
 +//   For 4Pro Wireless Display units produced after 01 March 2021 use Type 0 FTT
 // //
  --------------------------------------------------------------------------------------  --------------------------------------------------------------------------------------
-#define TOUCH_PANEL_TYPE           // 1= Type 1 (Touch Panel connections at Top Left),  2Type 2 (Touch Panel connections at Bottom Left)+#define DISPLAY_TYPE     // 0= Units produced after Mar 2021, 1= Units produced before Mar 2021,  9Very old TFT'(Touch Panel connections at Bottom Left) 
 </code> </code>
 +
 +===== Compiling the software =====
 +
 +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.
 +
 +===== 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 =====
 +
 +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.
 +
 +===== Optional Enhancements =====
 +
 +**Local Temperature / Humidity sensor**
 +
 +By default, the indoor Temperature / Humidity shown on the display corresponds to the location where the receiver is installed, so its data is broadcast by the receiver to all Wireless Display units. However, it is possible to install a local sensor on each unit to monitor the Temperature / Humidity of the place where the unit is installed. On the back of the unit there is a four pin connector for the additional sensor. Supported sensors are: BME280, HTU21D, SHT21, and SHT31.
 +
 +Selection of the type of sensor is done on the software, always on the User_Config.h
 +<code>
 +
 + --- Define type of Local TH sensor
 +#define INSIDE_TH_SENSOR          // 0= BME280, 1= HTU21D, 2= SHT21, 3= SHT31, 9= Use Main Station TH sensor
 +
 +</code>
 +
 +**Control the TFT Backlight - ON/OFF or Dimming**
 +
 +By default the TFT Backlight is always on, but you can control it. On the back of the unit there is a two pin jumper, by replacing this jumper by a switch, and you can turn the backlight OFF or ON when desired. You can do even more: instead of a switch you can use an 470K Ohm potentiometer and by doing this you can dim the backlight level to any convenient level.
 +
 +<WRAP round tip 75%> **Other Mods / Enhancements**
 +
 +WeatherDuino users are very creative people, always finding ways to improve their devices. Do a search on the [[http://www.meteocercal.info\forum|WeatherDuino support forum]], where you will find lots of ideas, including one that makes these units portable by using an Li-Ion battery and a very small charger. </WRAP>
 +
 +===== 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 =====
 +
 +Currently, the user interface can be set to any of the following languages:
 +
 +  * [[http://www.meteocercal.info/forum/Thread-Pro2-PLUS-New-Wireless-Display|Czech - Translation by Zdenek]]
 +  * Dutch - Translation by Pierrelux
 +  * English - Base Language
 +  * French - Translation by Laulau
 +  * German - Translation by engolling
 +  * Italian - Translation by kraken1881
 +  * Portuguese - Translation by Werk_AG
 +  * Spanish - Translation by Ardummy
 +
 +<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>
 +
 +===== Custom Box for the WiFi Wireless Display units =====
 +
 +{{:wiki:pro2c_newenclosure01.jpg?400x306|pro2compact_case2.jpg}}{{:wiki:pro2c_newenclosure02.jpg?610x306|pro2compact_case.jpg}}
 +
 +A member of the WeatherDuino Team (Jarek from Poland) has designed a custom case for the WeatherDuino Pro2 Compact receiver which can also be used for the WiFi Wireless Display units. \\ 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 at Thingiverse
 +
 +New Version: [[https://www.thingiverse.com/thing:4161865|https://www.thingiverse.com/thing:4161865]]
 +
 +Old Version: [[https://www.thingiverse.com/thing:3210539|https://www.thingiverse.com/thing:3210539]]
 +
 +If you don't have a 3D printer, you can order you case directly from online 3D printing services like [[https://www.3dhubs.com|3Dhubs]].
 +
 +====== Where I can get the WiFi Wireless Display units? ======
 +
 +All information about prices, availability and how to order can be found here: [[https://www.meteocercal.info/forum/Thread-WiFi-WeatherDuino-Wireless-Display-Fully-Assembled|WeatherDuino Wifi Wireless Display units, prices and availability]].
 +
  
 ===== Compiling the software ===== ===== Compiling the software =====
Print/export
QR Code
QR Code wireless_display_units (generated for current page)