Servers by jDrones

Baseline information concerning release v2.43


(Thomas J Coyle III) #1

This is a major new release with a lot of improvements, especially in the area of more precise steering and navigation. Highlights include:

Adoption of L1 navigation code from APM:Plane
New more precise steering controller
Support for the new Pixhawk autopilot
conversion to centimetre level precision throughout the code

I’ll only be able to give a rough summary of the changes here as we have had more than 1500 changes in total go into the git tree since the last release. Only some of those were related exclusively to the rover code, but a lot of them do affect rover.

The most significant change is in the navigation controller. Earlier this year the APM:Plane code adopted a new L1 navigation system. That was highly successful, and led to the fixed-wing plane code improving its navigation performance enormously, with much smoother and more accurate turns, and much better handling of wind, along with simpler tuning.

Since then Tom and I have been working to bring the same benefits to the Rover code. It was a bit of a rocky start, with initial attempts not working well on real rovers. With a single set of tuning values we were able to get good results either on straight driving or in tight turns, but not in both with the same settings.

We finally made progress when we wrote a new STEER2SRV steering controller that takes the output of the L1 navigation code (as a demanded lateral acceleration) and produces the steering controls. The new controller was based initially on the fixed-wing plane roll controller, but adapted to the physics of wheeled vehicles. That controller replaces the old classic PID based steering controller in the rover code, and provides much smoother and more adaptable steering. After we got the tuning for it right we are now delighted to report that steering on both of our rovers is now much better than it has been previously.

The new steering code has been so successful in fact that I have now ported it back for use in APM:Plane to control the ground steering on planes when taxiing and in automatic takeoff and landing. It has really helped with one of my planes that tends to be difficult to control during takeoff. So APM:Rover and APM:Plane now use the same ground steering code, just with different tuning parameters.

The next big change that you may notice in this release is the internal move to 32 bit integer positions instead of 32 bit floating point positions. The reason is that 32 bit floats that represent a global latitude/longitude only have a precision of a bit over 1 meter in some parts of the world. On a plane flying at 60 knots this isn’t a problem, as 1m accuracy is great, but for a rover it is not good. Switching to 32 bit integers gives us a precision of about 1cm, which is a good level for a rover. This lowers the amount of weaving of the rover as it no longer tends to jump across 1m boundaries.

That change to 1cm accuracy had impacts in a lot of different parts of the code. For example, the code which takes account of GPS lag to predict the actual position of the rover needs to do its math carefully to avoid ending up with floating point rounding errors, and the NMEA GPS driver needed to be modified quite a lot to read the floating point numbers in the NMEA protocol in a way that preserves centimetre level precision.

The centimetre precision change don’t mean that every rover will now navigate with cm precision. The rover will still be limited by the precision of its GPS and how good its steering linkages are, but if you have a good (expensive!) GPS and good hardware them APM:Rover should be able to get much better results with this release than it could previously.

Support for the new Pixhawk autopilot is another major feature of this release. Most of my testing for this release has been done with a Pixhawk and it has worked very well. We still support the APM1, APM2 and PX4 of course, it is just nice to also work with the latest hardware. We also are working on supporting APM:Rover on embedded Linux boards like the BeagleBone black, and Mike McCauley is working on a port to the Flymaple board.

For this release you will need to read the new navigation tuning guide for APM:Rover as quite a few parameters have changed. The full parameter list is also useful as a reference.

There have been a lot of other smaller changes in this release. Here is a partial list of the more important ones:

Added new AP_BattMonitor library for common battery handling with copter and plane
Use GPS projected position based on estimated GPS lag for more precise waypoint turns
Changed STEERING more to allow for throttle nudging
Added RCMAP support for mapping RC channels in any order
Switched to using new AP_Scheduler scheduling
Enabled RELAY support
Added LEARN_CH parameter for setting which channel triggers waypoint learning
Support camera stabilization and camera mount controls
Adopted new AP_Notify system for controlling LEDs on different boards
Lowered default accel/gyro filter frequency to cope with rough surfaces (eg. grass)

Tom and I wish you a lot of happy rovering with this release!

Cheers, Tridge