Readme for SoarPilot 4.0.0
For installation and operating details see the online manual at:
http://www.soaringpilot.org/dokuwiki

Changes for 4.0.2 - April 2008

  * Fix - Waypoint Sector screen now zooms in and out correctly.


Changes for 4.0.1 - March 2008

  * Fix - When flying an AAT, changing the target point in the next area could corrupt the distance and TOT calculations. This is now fixed.
  * Fix - Helps to avoid connection timeouts when using LX/Filser loggers.
  * Fix - Corrected a problem that could lead to some configurations settings being lost.


Changes for 4.0.0 - February 2008

Warning: If you have not been using the latest beta versions as they have been
released, this version will reset your configuration data.  You should back it up
prior to loading.

These and all previous changes are listed on the Detailed Change History page:
http://www.soaringpilot.org/dokuwiki/doku.php/soarpilot:detailed_change_history 
on the SoarPilot manual.  Please consult that for previous changes, fixes and enhancements.

  * New Feature - Default Task Rules can now be set in the Task Settings screen. New tasks will inherit these rules, and they can also be applied to existing tasks
  * New Feature - Automatic Sending SMS messages from Treo phones.  To be used for both to live tracking servers and for information to other people.
  * New Feature - In the SUA List, any items will current warnings will be sorted to the top of the list.
  * New Feature - Addition of a **Map** button on the [[soarpilot:creating_a_task#task_list|Task List]] screen. This allows you to see the whole task on the map screen.
  * New Feature - When editing Task Waypoints the max area radius can be changed with the **//Page-Up//** and **//Page-Down//** buttons. In addition the **//Memo//** button saves the changes to the waypoint. Note: You still need to re-activate the task to out these changes into the active task. (This can also be done with the **//Memo//** button from the [[soarpilot:creating_a_task#task_editor|Task Editor]] or [[soarpilot:creating_a_task#task_list|Task List]] screens)
  * New Feature - It is now possible to manually start a task in flight, or manually go to the next waypoint in a task, and for the task speeds and estimated times to be calculated correctly.
  * New Feature - Post flights task statistics are now available by reviewing task in the [[soarpilot:flight_task_info#flight_display_buttons|Flight Info screen]] by tapping the **Task** button. Statistics available are:- Time at each turnpoint, time between each turnpoint, speed on each task leg, confirmation of correct sector entry at each turnpoint.
  * New Feature - The Memo key can now be used to go to the [[soarpilot:sua_item_list#the_sua_item_edit_screen|SUA item edit]] from the [[soarpilot:sua_item_list|SUA List]].
  * New Feature - On the [[soarpilot:creating_a_task#task_editor|Task Editor]] screen a drop down list appears next to the total task distance labelled "AAT". This is visibile only with tasks containing AREA type waypoints, and allows you to immediately move all target points to the Max distance, Min distance, or the centre of the areas. Note: any previous changes are overwritten.
  * New Feature - A wind direction indicator is now visible on the [[soarpilot:final_glide_screen|Final Glide]] screen, shown as a small circle with a line pointing to the centre of the current waypoint direction arrow.
  * New Feature - The line to the next waypoint now appears on the [[soarpilot:planning_an_assigned_area_task#waypoint_sector_screen|Waypoint Sector]] screen.
  * New Feature - The average glide angle is now available on the [[soarpilot:movingmap_basics|Moving Map]] screen below the final glide arrows.
  * New Feature - The Speed To Fly (or Required Ground Speed) and altitude values are now shown on the Moving Map screen with no waypoint selected. When no waypoint is selected, the Speed To Fly is based on the current direction of flight and the altitude values bases on the distance manually set from the Final Glide screen using the **//Page-Up//** and **//Page-Down//** buttons.
  * New Feature - When flying tasks with Areas, the current target point (represented by a circle with a cross in it) and the point of maximum penetration into the area(shown by an open diamond) are now displayed on the Moving Map as well as the Waypoint Sector screens.
  * New Feature - The dialogs boxes for OK/Cancel or Yes/No questions, along with others likely to appear in flight, have been improved to include bigger buttons, and now the background processing for logging, airspace warnings, etc continues. (The Palm standard dialog boxes freeze all other processing) In addition these dialog boxes will now auto dismiss, with a default answer (shown underlined), in the same way as airspace warnings. 
  * New Feature - The **//Memo//** key can now be used to go to the [[soarpilot:sua_item_list#the_sua_item_edit_screen|SUA item edit]] from the [[soarpilot:sua_item_list|SUA List]]. Also, the **//Memo//** key will save the SUA item in the [[soarpilot:sua_item_list#the_sua_item_edit_screen|SUA item edit]] screen.
  * New Feature - Support for the new EW Micro Recorder - Will be able to fully configure the device as well send a task declaration to the device on the fly.  The device also outputs a normal GPS data stream as well as pressure altitude.  So the recorder can be used to drive SP as well.
  * New Feature - The "Goto Start" warnings have been implemented. When this option is selected on the Task Rules screen, the program displays a countdown, shown as "mins:secs" to the time when you need to turn towards the start to arrive exactly at the start time via the shortest route the the start. It assumes your speed will be the speed to fly based on the current MC value. When the countdown reaches zero a warning will popup alerting the pilot to turn towards the start. If you are predicted to be late to reach the start the countdown is shown as "(mins:secs)". Once the start time is passed, the display changes to "Start!". The countdown is shown on the Final Glide screen above the waypoint arrow, and at the top of the Moving Map screen. In addtion on the Moving Map screen the speed required to reach the start on-time is displayed next to the count down.
  * New Feature - The task rules for the active task can now been added to the screen order list, and accessed directly from the Flight menu. If the active task rules are accessed in this manner, any changes are automatically copied to the active task, and you will continue with the same log file.
  * New Feature - If you have set a minimum task time in the task rules, you will now see a display above the waypoint arrow on the Final Glide screen and at the top of the Moving Map screen that shows your estimated Time On Task vs. the minimum time set. For example, if you are over the task time by 10 mins the display shows "TOT+10", conversely if you are going to be early by 10 mins the display shows "TOT-10". This number is also shown on the Flight Info and Waypoint Sector screens next to the TOT value.
  * New Feature - Configuation option to change the behaviour of the Left button on the 5-way navigator. This is set by editting the configuration file directly by changing the line "LEFTACTION". The allowed values are: 0 - Do nothing, 1 - Home button (as current), 2 - Move backwards in the screen order continously, 3 - Move backwards in the screen order but stop at either end of the list. With LEFTACTION = 3 holding the left or right buttons will continue to move in the chain until you reach the end. The current action of the right button remains to move forward in the screen order.
  * New Feature - New option "Auto Start after 1st Wpt" on the SUA/Warnings screen. If this option is un-checked the task will not automatically re-start if you happen to enter the start zone after you have already reached the first waypoint in the task. The Re-Start dialog will still appear, but will not dismiss until the Pilot confirms to re-start or not.
  * New Feature - In the Screen Order settings you can now select a screen (using the checkbox on the left) and use the **//Page-Up//** and **//Page-Down//** keys to move the selected screen up and down the order.
  * New Feature - On the Logger Setting screen there is now a option to decide if you want to declare tasks to the external logger attached to SoarPilot or not. If this option is off, you will never be asked to declare a task to the external logger.
  * New Feature - On the Task Settings / Default Rules screen there is now an option to glide to the max start height. If this option is set, and a max start height is set in the Task Rules, and the Task Rules are active, your final glide calculations to the start will be based on the start waypoint elevation plus the max start height. The waypoint name will change to "Start Height". Note: due to this change, the default rules are always in-active, and require them to be activated in each task.
  * New Feature - The distance and bearing calculations to line starts or finishes has been improved to take the shortest distance to the line, not the distance to the mid-point. This is controlled by a new option called "Exact" on the Settings / Units screen.
  * New Feature - If any changes are made to the active task, and you leave the Task Editor without re-activating the task, a confirm box will popup reminding you to re-activate the changes or cancel the changes.  Also am additional confirmation box will popup if you try to turn the task rules off. If you cancel any changes will be lost.
  * New Feature - There is a new button assignment on the Active Task Screen. Selecting a waypoint from the Active Task and pressing the **//To Do//** hardware button will ask you if you want to change the active waypoint in the active task. This will accomplish all waypoints before the selected one, and start the task if required.
  * New Feature - If you try to turn the Task Rules off for the active task, you will be asked to confirm this change.
  * New Feature - On the Map Settings Lines screen you can now choose the colour and weight (bold or not) of the waypoint direction line.
  * New Feature - Support for the Borgelt B500 pressure altitude data.
  * New Feature - On the Final Glide Setting screen, there is now an option to control how many thermal turns are required for the thermal to be included in the average calculation for updating the MC value, and on the thermal history screen.
  * New Feature - Support for UTM coordinate formats using a WGS84 datum.
  * New Feature - Colouring of the track on the moving map screen can now be based on netto lift ie: actual airmass movement, removing the sink due to the glider polar curve at various speeds.
  * New - Additional waypoint direction line, to guide the pilot to the target or maximum point in an area, during an AAT task. (Hi-res Palms only)

  * Change - The on-screen buttons for alerts for task re-start, SUA warnings etc are now larger, making it easier to tap them in flight.
  * Change - Improved ETA and Time on Task calculations taking into account the correct speed to fly and wind on each task leg.
  * Change - The **View** button on the [[soarpilot:creating_a_task#editting_a_task_waypoint|Task Waypoint]] screen to view the waypoint sector has been renamed to **Sector**.
  * Change - On the Final Glide screen in the [[soarpilot:final_glide_screen#lift_sink_table|Lift / Sink table]] with metric units for lift (m/s) the number range is changed from 0 to 2.5 or 0 to 5 m/s. This gives a much more useful range of MC values.
  * Change - The buttons on the [[soarpilot:creating_a_task#task_editor|Task Edit]] screen have been changed to simplify the job of entering and editting waypoints. The buttons now are "Edit", "Add", "Up", "Down", "List". The "Rev" button has gone, as this was little used. The Edit button now take you directly to editting the currently selected waypoint without the popup dialog. To delete a waypoint, first you edit it, and the "Delete" button is there on the individual task waypoint screen. This is consistent with the waypoint list and edit screen. The popup dialog box is still available if you tap the "Calc" silk screen button.
  * Change - On the [[soarpilot:selecting_a_waypoint#with_a_task_active|Waypoint Select]] dialog with a task active, the **Add Wpt** button has been renamed to **Insert Wpt** to be more logical, as this actually inserts a waypoint in front of your current active waypoint in the task.
  * Change - For an active waypoint, the [[soarpilot:planning_an_assigned_area_task#waypoint_sector_screen|Waypoint Sector]] screen now changes the map orientation to and from the thermal mode map orientation set on the [[soarpilot:map_display_settings|Map Settings]] screen. If you are not viewing the active task, or active waypoint, the screen defaults to a North-Up orientation.
  * Change - On the Task Rules screen the buttons now change the Start Time and Min Task Time by +/- 5 mins.
  * Change - The buttons on the dialog for invalid starts (too early or above max start height) have been changed to "Start" and "Cancel" to be more logical. Also the default action is to start the task.
  * Change - The calculation for the required glide angle on the Flight Info screen now includes the safety altitude.
  * Change - When using the Moving Map screen to review a flight log or preview a task there is now a "Back" button to return you to the previous screen. In addition, the top right corner will show if you are viewing a "Log" or a "Task" and the top left corner shows if the map is in panning mode, or for an active task in [[soarpilot:creating_a_task#previewing_a_task_on_the_moving_map|preview]] "Flying the Task" mode.
  * Change - When viewing the active task (after it has been activated) you can switch between the normal panning mode, and "Fly" mode by tapping the top left corner. When in "Fly" mode you can move down each task leg with the up/down arrows, and change waypoints with the left/right buttons.
  * Change - The **List** button on the Task Editor screen has been replaced with a **Del** button allowing you to delete waypoints from the task without the need to edit the waypoint. If you editted the task from the Task List, pressing the Home button will return you to the Task List. You can also get to the tasks you have setup by paging up and down from the active task, and if required activate or edit another task.
  * Change - The thermal profile when shown on the moving map display now shows a solid vertical line to show the current average thermal lift achieved in the current thermal. This is in addition to the dotted line showing the current MC value.
  * Change - The Task List acreen is now available on the Settings / Screen Order screen.
  * Change - The glider symbol is now centered on the screen when the map is in thermal mode.
  * Change - On the Flight Info screen, if the task is on hold (because you have selected a temporary waypoint) the finish time and TOT fields show "On  Hold". Tapping either of these two fields will resume the task.
  * Change - If you access the Waypoint List from the menu or the screen chain with a task active, the far right button will say "TEMP" indicating that you are selecting a temporary waypoint which will put the task on hold.
  * Change - If you have a temporary waypoint selected during a task, "Temp" will be shown at the top of the Moving Map and above the waypoint direction arrow on the Final Glide screen. 
  * Change - Improvements to the Polar List to be more consistent with the other lists and how they function.
  * Change - Instead of showing the characters "BL" when the backlight is on, a small sun icon is shown.
  * Change - The size of the buttons to change the MC scale and the altitude reference (A.Alt, R.Alt, D.Alt) are now bigger. Tapping anywhere in the MC scale or in the altitude column is now possible.
  * Change - The warning tone for loss of GPS data will play for ~5 secs only, then repeat every ~45 secs
  * Change - Significant increase in map drawing speed
  * Change - The SUA List now shows "Y", "D" and "N" in the ACT column. This is to show the difference between fully active items (Y), items which display only, without warnings (D), and inactive items, no display or warning (N).

  * Fix - The task re-start alert no longer happens if the active task has been completed
  * Fix - Fixed a bug that could cause the program to crash on the Flight Info screen.
  * Fix - Correction to the [[soarpilot:final_glide_settings#show_req_d_ground_speed|Required Ground Speed (RGS)]] calculations.
  * Fix - Corrected the display of the thermal profile when using fpm/fps for the lift units.
  * Fix - The Time On Task value no longer changes after the task has been completed. Note: the ETA value on the Waypoint Sector screen will still continue to show your expected arrival time at the selected waypoint.
  * Fix - Selecting a waypoint from the waypoint list, accessed from the menu directly (rather than tapping the CSE: button on the Final Glide or Moving Map screens), now works correctly.
  * Fix - When you add a waypoint from the Moving Map screen the waypoint elevation is now the terrain elevation rather than your current altitude.
  * Fix - You could exit from SoarPilot with the power button / backlight if the menu was open. This has now been fixed.
  * Fix - Task declaration for LX/Colibri loggers now works when [[soarpilot:using_control_points|control points]] are included in the task. (Thanks to Zoltan for fixing this)
  * Fix - Fixed a problem in the 3.5.0 beta versions causing problems with repeating "Connecting" dialogs and problems downloading flights for C302 and GPSNAV loggers.
  * Fix - Certain combinations of AREA and Cylinder turnpoints in a task caused the task distance calculations to be wrong. This has now been fixed.
  * Fix - It was possible to set your No Data Timeout and Off Timeout values on the Settings/Logger screen to very low numbers. This would cause the flight log to be stopped (along with any active task) after a very short time if the GPS lock was lost or the glider was stationary (can happen in high winds). These now have a minimum setting of 60 seconds.
  * Fix - The flight database is now updated regularly in flight to possibly avoid data loss due GPS data failure or a low battery.
  * Fix - It was possible to put the task on hold, thereby "freezing" the task statistics on the Flight Info page without actually selecting a temporary waypoint. This is now fixed.
  * Fix - It was possible by using the waypoint list directly from the menu, or in the screen change to have the task on hold but no temporary waypoint selected. This would prevent SoarPilot sequencing to the next waypoint in the task. This has now been fixed.
  * Fix - Some SUA data files would not load all the SUA data items consistently. This has now been fixed.
  * Fix - In some cases the latest beta version would run very slowly. This was linked to the "Set PDA Time from GPS" option on the Settings / Units screen. This has now been fixed.
  * Fix - On Garmin iQues and other DIA capable devices the bottom 2 buttons would disappear after a popup question or warning. This has now been fixed.
  * Fix - Using long names (>12 letters) caused problems with the task database. This is now fixed.
  * Fix - The Waypoint List could get corrupted after inserting a waypoint into an active task inflight. This is now fixed.
  * Fix - When the "SFC" altitude reference was used in the SUA data file, sometimes the altitude was not correctly calculated. This is now fixed.
  * Fix - If "New Flight" was selected when declaring a task inflight, the previous task data would not store in the log file correctly. This is now fixed.
  * Fix - Some files downloaded from Filser / LX logger would not validate correctly. This has been fixed, but the correct computer type on the NMEA/Port settings screen must be used. Use "Filser" for LX20, LX21, DX50 and LX5000. Use "LX" for Colibri and LX7000.
  * Fix - SUA data and waypoints would not be displayed in the bottom half of the screen of a DIA Palm with no bottom labels selected. This is now fixed.
  * Fix - Data files (eg: SUA data) with trailing spaces or tabs at the end of a line would cause errors in parsing the file. This is now fixed.

  * Plus a few other minor fixes and improvements.
