rooty/LibrePilot
1
0
Fork 0
mirror of https://bitbucket.org/librepilot/librepilot.git synced 2025-02-21 11:54:15 +01:00
Code Issues Releases Activity

OP-910: update release notes

Browse Source
This commit is contained in:
Oleg Semyonov 2013-06-04 18:21:46 +03:00
parent 8b94f10107
commit 2656b4505e
1 changed files with 159 additions and 107 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

266
WHATSNEW.txt
View File

@ -1,119 +1,184 @@
Short summary of changes. For a complete list see the git log.
--- RELEASE-13.06 --- Italian Stallion Release --- --- RELEASE-13.06 --- Italian Stallion Release ---
This is the first Revolution software release which also supports CC, CC3D, OPLinkMini and This is the first official OpenPilot Revolution software release. This version
unreleased yet OP OSD boards. This is a major change: from different toolchains and build also supports the CopterControl, CC3D, OPLinkMini and the upcoming OP OSD.
system to the whole source code reformatting according to project style guidelines. The goal There a number of significant backend changes in this version compared to
of this release is to provide CC-style features for new Revo platform + radio using Revo's previous software releases: from new toolchains and build system to a source
internal modem and external OPLinkMini board. All advanced features like Altitude Hold, code reformatting that is inline with our project style guidelines.
Position Hold, Guidance, Return to Home, AutoLanding etc. are not released yet and planned
for following releases.
Some video tutorials: The goal of this release is to provide CC3D-style features for the new
http://wiki.openpilot.org/display/DocDE/OpenPilot+Tutorials Revolution platform (using the Revo's internal modem and external OPLinkMini
board). Advanced features such as Altitude Hold, Position Hold, Guidance,
Return to Home, and AutoLanding are still in development and will be available
in future releases. The availability of those features will depend on how many
people are able to contribute with code, testing and documentation.
Important Release Notes: Remember that the first Revo hardware batch was intended for developers/
bleeding-edge testers, not end users who want a 100% final platform.
- Since this release the packaged distribution does not contain firmware files in a folder. - New bootloaders are REQUIRED for this release to support new features such
They are now integrated into the GCS so always are up to date. To update you must use as erase settings and others. As always, bootloaders can be updated without
either Vehicle Setup Wizard (big green button on the Welcome GCS tab) or new Auto-Update any special programmer hardware using the bootloader updater firmware files.
button on the Firmware tab. - F1 boards (CC, CC3D, OPLinkMini) require bootloader version 4 or higher.
- F4 boards (Revolution, OSD prototype) require bootloader version 5 or higher.
- New Auto-Update feature simplifies all OpenPilot board firmware updates. Just click it - Check the wiki for details of how to update them:
and follow on-screen directions to reflash your board (CC, CC3D, OPLinkMini, Revolution
or OSD prototypes). Internally it is the same as Rescue but uses embedded firmware images,
no need to browse for them anymore.
- New bootloaders are REQUIRED for this release to support some of new features like settings
erase and some others. As always, bootloaders can be updated without any special programmer
hardware using bootloader updaters firmware. Currently F1 boards (CC, CC3D, OPLinkMini)
require bootloader version 4 or higher, and F4 boards (Revolution, OSD prototype) require
bootloader version 5 or higher. Check the wiki for details of how to update them:
http://wiki.openpilot.org/display/BUILDS/Bootloader+update http://wiki.openpilot.org/display/BUILDS/Bootloader+update
- New feature: settings erase option. In the past some special settings erase firmware was Please remember to take a moment to view these important tutorials:
used to erase bad or incompatible settings from CC/CC3D boards. Now it is deprecated, and http://wiki.openpilot.org/display/Doc/OpenPilot+Tutorials
this functionality is now integrated into bootloader and firmware. To erase any board
settings you must have latest bootloader. Then enter DFU (boot) mode (using Halt or Rescue
function) and click "Erase settings" button on the Firmware tab and follow on-screen
instructions. This will NOT work with older bootloader, and the button will be disabled.
- On Linux you should remove OpenPilot package if was installed, then install new one. This What's New / Release Notes
is a known issue and likely be fixed later. --------------------------
- On Windows there is a CDC driver installer option. This is an optional USB virtual serial NEW:
port useful, for example, for updating your GPS configuration using U-Blox u-Center software.
But it is NOT required to configure boards. If not installed, virtual serial port features
will not be available. This driver is not signed by Microsoft, but in fact it uses serial
port drivers from Windows and only driver information INF file is supplied by the OpenPilot.
Hence it is safe to install.
- Due to changes in USB descriptors to support new features, USB drivers on Windows must be - Firmware folders removed.
updated. If after Rescue or Wizard or Auto-Update button the GCS cannot connect to the board, The firmware files folder has been removed in this release. These files
it may be due to this issue. To resolve you should remove old drivers (ones with yellow are now integrated into the GCS so they are always up to date and there is
exclamation mark) and allow Windows to find them again. Here is how: less risk of a firmware mismatch. To update your firmware you must use
either Vehicle Setup Wizard (big green button at the top right on the
Welcome GCS tab) or the new Auto-Update button on the GCS Firmware tab.
- Responsiveness sliders.
To simplify tuning, we have introduced a new Responsiveness slider that
will allow you to modify stick response. For best results, you should
still tune your system with PIDs as tight as possible for better
stabilisation. This will result in better stabilisation, and at the
same time soft or sharp response according to your preferences.
- Auto-Update firmware.
This feature simplifies all OpenPilot board firmware updates. Now all
you have to do is click "Auto-update" on the Firmware tab and follow the
instructions to reflash your OpenPilot board. This is essentially the
same as Rescue but uses the embedded firmware images so there is no need
to browse for them anymore.
- Erase Settings Option.
We previously had a hacky way to delete bad or incompatible settings from
our OpenPilot boards. This old special firmware that did this is now
deprecated and the functionality is now integrated into the latest
bootloaders and firmwares.
To erase settings enter DFU (boot) mode (using Halt or Rescue function)
and click the "Erase settings" button on the Firmware tab and follow the
instructions. This will NOT work with an older bootloader and the "Erase
settings" button will be disabled if an out of date bootloader is detected.
- Language defaults.
GCS now uses the system default language (only French and English are
available currently, please contribute translations). You can change the
language in the GCS Options at any time.
- CDC driver install option (Windows only).
This is an optional USB virtual serial port that is useful, for example,
for updating your GPS configuration using the U-Blox u-Center software.
It is NOT required for normal configuration of OpenPilot boards. If it is
not installed, virtual serial port features will not be available. This
driver is not signed by Microsoft, but in fact it uses serial port drivers
from Windows and only the driver information INF file is supplied by
OpenPilot.
- Lots of help tooltips were added to the GCS. Hovering your mouse over an
option in the GCS will show them, please review for help during tuning/
setting up.
- A large amount of general improvements, code clean ups and minor bugs
resolved.
KNOWN ISSUES:
- On Linux you should remove the OpenPilot package if it was previously
installed, then install this new one. This is a known issue and likely
be fixed later.
- Due to changes in USB descriptors to support new features, USB drivers
on Windows must be updated. If after using Rescue or Wizard or Auto-Update
button the GCS cannot connect to the board, you may be experiencing this
USB issue. To resolve it you should remove the old drivers (ones with
yellow exclamation mark) and allow Windows to find them again.
Here is how to do it:
Windows XP: Windows XP:
- click on the desktop "My Computer" icon and select "Properties"; - Right click on "My Computer" on your desktop and select "Properties".
- select the "Hardware" tab by clicking on it once; - Select the "Hardware" tab.
- select the "Device Manager" tab by clicking on it; - Select the "Device Manager".
- scroll down the list until you see the "Universal Serial Bus Controllers" selection. - Scroll down the list until you see the "Universal Serial Bus Controllers"
Click it to expand the list of USB drivers. Right-click on the driver(s) you wish to selection.
uninstall and select the "Uninstall" function. The driver will be uninstalled. - Click it to expand the list of USB drivers. Right-click on the driver(s)
you wish to uninstall and select "Uninstall".
Windows 7/Vista: Windows 7/Vista:
- on the desktop right-click the "Computer" icon and select "Properties"; - Right click on "My Computer" on your desktop and select "Properties".
- select "Device Manager" in the upper left-hand corner of the window; - Select "Device Manager" in the upper left-hand corner of the window.
- scroll down the list until you see the "Universal Serial Bus Controllers" selection. - Scroll down the list until you see the "Universal Serial Bus Controllers"
Click it once to expand the list of USB drivers. Right-click on the driver(s) you wish selection.
to uninstall and select the "Uninstall" function. The driver will be uninstalled. - Click it to expand the list of USB drivers. Right-click on the driver(s)
you wish to uninstall and select "Uninstall".
Then disconnect the board from USB, wait few seconds and connect it back. Windows should find new Then disconnect the board from USB, wait few seconds and re-connect it to
drivers and install them properly. your computer. Windows should find new drivers and install them properly.
- GCS now uses system default language (only French and English are available yet, please - If GCS crashes when switching to the Flight Data tab, it usually means
contribute). You can choose language using GCS Options dialog if you have existing GCS your PC needs newer video drivers. That tab contains a ModelView widget
configuaration. which uses OpenGL. It is known to crash on some graphics cards with old
and buggy drivers.
- This release provides only CC3D-class features + radio. For example, it does NOT use - Sensor calibration is not final. It will be reworked completely to
magnetometers to correct yaw and uses simple complimentary filter for attitude estimation. increase its accuracy and make it easier to use.
So you should expect from it only CC3D-like performance. More advanced features will be
enabled step by step in the following releases with some help from new contributors,
we hope. Remember that the first Revo hardware batch was inended for developers, not
end users.
- Lots of help tooltips were added to the GCS. Try watching them when tuning. - AltitudeHold mode is enabled, but it is not officially supported. Do
not expect it to work perfectly and be considered production quality.
You may play with it and report your issues and suggestions at your own
risk. If you are not using a case for your Revo, we strongly recommend
covering the barometer sensor with some foam to shield the sensor from
wind and light.
- If GCS crashes when switching to the Flight data tab, it usually means your PC needs newer - Note that throttle stick in AltitudeHold mode is used to control vertical
video drivers. That tab contains ModelView widget which uses OpenGL. It is known to crash velocity, sometimes called vario altitude in other platforms, centre stick
in some cases. means hold altitude and there is a dead band around centre stick.
- Sensor calibration is not final. It will be reworked completely to increase its accuracy - There are currently no configuration options for the Radio module in
and make it easier to use. the Revolution except for Radio enable/disable and output power. This is
intentional because all configuration should be done using its paired
ground OPLink coordinator.
- AltitudeHold mode is enabled, but it is not officially released. Do not expect it to be of How to configure the Revolution to OPLinkMini radio link:
production quality. But you may play with it and report your issues and suggestions. It is
recommended to use some foam to protect baro sensor from wind and light. Also note that
throttle stick in AltitudeHold mode is used to control vertical velocity.
- Tuning your system please set PIDs as tight as possible for better stabilisation. To soften - Make sure you have the newest bootloaders and matching firmwares
the stick response if necessary use new Responsiveness options. This will result in better between the Revolution, GCS and OPLink.
stabilisation, and at the same time soft or sharp response according to your preferences. - Enable the radio in the Revolution, click save and disconnect the board
from USB.
- Power it from external supply to continue.
- Then connect the OPLink board to USB and scroll down in the GCS config
widget to find OPLink icon at the end of list. This icon is only
available when an OPLink is detected.
- To pair the two radios, select the Revolution side radio address in the
list of found boards, select it, click Add to add to the list of paired
radios and click Save. After unplugging the board from the USB and
plugging back your OPLink it should show "Connected", and you can
continue with the configuration.
- There is no configuration options for Radio module in the Revo config except for Radio - Do not set the Revolution modem or OPLinkMini output power to high values
enable/disable and output power. This is intentional because all configuration should be without antenna connected, this can damage the hardware.
done using its paired ground OPLink coordinator. Enable radio in the Revo, save and
disconnect Revo from USB. Power it from external supply to continue. Then connect OPLink
board to USB and scroll down the GCS config widget to find OPLink icon in the end of list.
This icon is only available when OPLink is connected and recognised, this also requires new
bootloader and matching to Revo and GCS firmware on the OPLink board. To pair select the Revo
side Radio address in the list of found boards, select it, click Add to add to the list of
paired radios and click Save. After USB unplugging and plugging back your OPLink should show
"Connected", and you can continue with configuration.
- Don't set Revo modem or OPLinkMini output power to high values without antenna connected, JIRA issues addressed in this release:
this can damage the hardware.
Due to major rework of all code and integration of Revo code into mainline
(next) it is almost impossible to list all corresponding JIRA issues for the
list above. Some of them can be found using this link:
http://progress.openpilot.org/issues/?filter=10860
OP-678, OP-693, OP-719, OP-747, OP-761, OP-769, OP-770, OP-772, OP-792,
OP-807, OP-812, OP-816, OP-817, OP-820, OP-821, OP-843, OP-846, OP-854,
OP-855, OP-856, OP-864, OP-867, OP-871, OP-873, OP-874, OP-875, OP-879,
OP-885, OP-886, OP-888, OP-889, OP-890, OP-891, OP-892, OP-893, OP-894,
OP-895, OP-896, OP-897, OP-898, OP-899, OP-900, OP-903, OP-905, OP-906,
OP-907, OP-910, OP-912, OP-917, OP-920, OP-925, OP-926, OP-928, OP-935,
OP-936, OP-939, OP-952, OP-955, OP-957, OP-968, OP-969, OP-970, OP-977,
OP-980
Short summary of changes. For a complete list see the git log.
Flight code changes: Flight code changes:
- initial version of Revo code; - initial version of Revo code;
@ -207,27 +272,14 @@ Common parts:
- updated Windows driver to support Revolution and use correct board names. - updated Windows driver to support Revolution and use correct board names.
Android GCS: Android GCS:
- not officially released yet; - old and buggy code was removed;
- full rewrite has been started; - full rewrite has been started.
Infrastructure: Infrastructure:
- Bamboo continuous integration server is actively used; - Bamboo continuous integration server is actively used;
- around 10 build agents running 4 different operating systems are set up; - around 10 build agents running 4 different operating systems are set up;
- every push to any branch is now build-tested, and unit tests run are performed; - every push to any branch is now build-tested, and unit tests run are performed;
Due to major rework of all code and integration of Revo code into mainline (next) it is almost
impossible to list all corresponding JIRA issues for the list above. Some of them can be found
using this link:
http://progress.openpilot.org/issues/?filter=10860
OP-678, OP-693, OP-719, OP-747, OP-761, OP-769, OP-770, OP-772, OP-792, OP-807, OP-812, OP-816,
OP-817, OP-820, OP-821, OP-843, OP-846, OP-854, OP-855, OP-856, OP-864, OP-867, OP-871, OP-873,
OP-874, OP-875, OP-879, OP-885, OP-886, OP-888, OP-889, OP-890, OP-891, OP-892, OP-893, OP-894,
OP-895, OP-896, OP-897, OP-898, OP-899, OP-900, OP-903, OP-905, OP-906, OP-907, OP-910, OP-912,
OP-917, OP-920, OP-925, OP-926, OP-928, OP-935, OP-936, OP-939, OP-952, OP-955, OP-957, OP-968,
OP-969, OP-970, OP-977, OP-980
2012-11-17 2012-11-17
Advanced camera stabilization features. Advanced camera stabilization features.
They include optional manual control input filtering (moved from camera stabilization to manual They include optional manual control input filtering (moved from camera stabilization to manual