Part Two: Here is the original picture of the finished product:
This is the second part of a 2-part series on 'How to build a High-Definition FPV UAV using a Raspberry PI with HD camera, using a high speed WiFi link.
In my first post on the subject (located here), I discussed the parts I used, and how to install them into a Hobby King Go-Discover FPV model.
In this post, I will discuss installing the Raspberry PI and the PI camera in the Go-Discover gimbals, and the software configuration for both the Raspberry PI and the ground station PC.
From the previous post, step 3 was completed by installing the Ubiquity Rocket M5 in the model. Now onto step 4:
Step 4: Install the Raspberry PI and PI Camera
Here is a photo of the position of the PI in the Go-Discover model:
The PI fits nicely just behind the camera gimbals, with the USB and HDMI ports on top. In the right side you can see the Cat5 network cable attached. This cable connects to the ethernet switch, which is also connected to the Rocket M5 input port.
The two cables shown on top are the servo control wires for the gimbals, which I have directly connected to channel 4 and 5 on my radio. I am using channel 4 (normally the rudder stick on my radio. Since there is no rudder on a flying wing, this is a convenient channel to use to move left and right with the camera. I have not (yet) moved to a head tracker, but if you already have that setup, just assign the channels accordingly.
To install the PI camera, remove the stock plate from the gimbals (for a GoPro), and mount the PI camera as shown in this photo:
The PI camera case fits very nicely into the slot, and again I used a small piece of velcro to hold it down. You could use a couple of small screws instead if you want a more secure hold. The two gimbals servos are also shown here. They are simple to install, just follow the Go-Discover instructions.
Here is a front view of the PI camera installed:
Here is the block diagram describing all the connections:
Some comments on my previous post suggested that it is possible to eliminate the ethernet switch and serial-to-ethernet converter using the Raspberry PI and a serial port on the PI. I believe this post describes how to talk to the PI via the NavLink, but in this case, I want to use the PI to bridge the connection from the ground station to the APM/PixHawk. Somebody please comment on this if you know more about it. I believe it would require a TCP/IP to serial link from the PI to the telemetry port on the APM, and some software on the PI to act as the bridge. The main connection to the ground station is via the Rocket M5 and TCP/IP, not through a telemetry link (900 Mhz or Zigbee like I used on my other models).
Step 5: Getting it all to work with software configuration (the really fun part starts now).
Check out this post on what others have done with streaming and the PI. My experiments showed that using GStreamer on both the PI and on Windows gives really good results with very low latency, if you use the right parameters.
Get GStreamer on the PI by following this blog. This is the same version of GStreamer that I am using on my setup.
Make sure your PI camera works ok by plugging in the PI to a standard monitor using the HDMI port and follow the instructions on the Raspberry PI website on how to get the camera up and running (without GStreamer). Once you have a working PI and camera, you can then proceed to stream things over the network.
Note: It is suggested that you first get the PI streaming video by plugging it directly into your local network where you can also connect your ground station PC with the correct IP addresses (without the Rocket M5). For my PI, I picked 192.168.1.2, and for the ground station, 192.168.1.1. Make sure you can ping the PI from your PC and the PC from the PI.
For streaming, you will also have to make sure all the ports you intent to use are open on the firewall (described later).
For the ground station PC, you can download GStreamer here. Make sure when you install, select to install everything , or full installation (not the default).
Here is the command I use for the PI to pipe the camera output to GStreamer:
raspivid -t 0 -w 1280 -h 720 -fps 30 -b 1700000 -o - | gst-launch1.0 -v fdsrc ! h264parse config-interval=1 ! rtph264pay ! udpsink host = 192.168.1.1 port= 9000
The command is explained as follows:
raspivid is the command to start the camera capture on the PI. The -w switch is for the width in pixels, and the -h switch is for the height. In this case, I am using 1280 X 720, but you can try any combination that fits your needs.
The -b switch is the bit rate for the sampling. In this case I chose 1.7mbs to send over the stream. Again you can experiment with higher or lower values. This settings seems to work good for me, and the latency is almost unnoticeable.
the "-o - |" is piping the output to gstreamer. Make sure you include the dash before the pipe "|" symbol.
For the GStreamer command, all the filters are separated with an exclamation point "!", as these are individual drivers that are part of GStreamer. Since the PI has hardware accelerated video, the output is in a format called "H264", which is a highly-compressed stream. The GStreamer filters are configured to transport the output via a UDP socket connection to the target PC. Notice the 'udpsink' element which specifies the host - in this case your ground station, and the UDP port. I am using port 9000, but you can use any open port on your system, but be sure to open the firewall or it won't work! You can also use TCP instead of UDP, but for such a data stream, I chose to use UDP since dropouts are certainly possible, and with UDP this is ok, but with TCP, you could have socket problems and higher latency.
Note: to get the PI to execute this command on boot, make a shell script with the above command and add it to your local.rc boot sequence. That way when the PI boots, you get the stream without having to log into the PI remotely.
For the ground station PC, once you have installed GStreamer and opened the correct ports, use this command (from the command prompt) to view the stream:
c:\gstreamer\1.0\x86_64\bin\gst-launch-1.0 udpsrc port=9000 ! application/x-rtp,encoding-name=H264,payload=96 ! rtph264depay ! avdec_h264 ! videoconvert ! autovideosink
If all goes well, you should see the PI camera output on your PC screen in a popup window. For those of you what want to use FPV goggles, you can connect to the HDMI port on your PC to display the output if your goggles support HDMI.
I have this command in a batch file (with a PAUSE) statement at the end to keep the window open.
WHEW! If you got this far, you are amazing.
The last step to complete the build is to connect to the APM from mission planner. The method I used to connect was to install a utility that converts a TCP connection to a virtual serial port, but I also think that directly connecting the mission planner to the TCP port will also work, however I have not tried it. I will post back later after trying it.
Here is the link to setup the serial to ethernet device to have an IP address and port.
Here is the link to the configuration utility for installing the virtual serial port.
Once you have a serial connection over TCP/IP working to the APM, you should be able to connect with Mission Planner. On the maiden flight, it worked perfectly, and I didn't see a single drop in the telemetry data or anything noticeable in the video transmission, however my first flight was limited to 2km.
The last step is to connect the Rocket M5 to the Nano M5 and test everything using the OTA (over the air) connection. If all is well, you are ready to fly! But be careful on your maiden, you just spent $700.
Finally, here is a photo of my Antenna Tracker with the Nano M5 attached. My next update will include a video of a longer flight.
Happy Flying!
Comments
@ Patrick, i finally received my new motor so i will be able to resume flight test. But at mid throttle i can pull only 140watt from it (4S battery + 11x5.5 prop), it sounds low i think. Can you tell me if it is the same for you ?
I bought the motor advised in Part1 : Turnigy SK3 - 700Kv
I tried the 48fps 6mbs setting, but found that the pixelation got much worse on my system, which is exactly the opposite of what the blog says. I think my ground station PC couldn't handle the bitrate, so I will try again on a higher horsepower machine to see if I can reproduce the results.
Holy cow that is a great blog.
see this blog for latency test with different bitrate and framerate http://goo.gl/HE4JQ4
@Dan, I think some of the problem with measuring latency is because of the compression algorithms (H264) that makes it 'non-static'. You get different results with different inputs as Bob pointed out. When I did actual measurements using the changing numbers, the overall scene was not changing, and the latency was hovering around 120ms. Moving the camera at the same time seems to increase the delay.
For the price of this system, my experience is good. I am not sure how much more we can squeeze out of it.
i tried to use vstab setting but look like it is not active yet.
Just found that http://pelicanimaging.com/parallax/ , never seen that tech before.
@Patrick well as a data point, I am running 1080p over LTE at just less than 200ms - so it is definitely possible!
@bocorps, I have a spare A+ so let me try and get back with you. It should work in theory. I am using the micro USB port to power mine since it's not used in my setup.
@Bob, Something is fishy about that blog, as I have tested both the direct gstreamer solution, and the Qt-based plugin separately, and could not measure any difference in latency. I have studied the Qt code extensively as I wrote a HUD for it, and it already uses the HW acceleration and the Open GL api to take advantage of the hardware. The Qt plugin virtually has no overhead, other than a queue. I just cannot see where the 'cheat' is going on. I think this is bogus, as the blog concludes that they got these results using 640x480 and lower resolutions.
I have not done much testing on full HD 1080p since my FPV setup only has 720p resolution, so my tests are mainly with 720p on the PI, so I think your numbers are correct, around 200ms average. There is definately a tradeoff between latency and resolution/field of view. Unfortunately, you can't have your cake and eat it too. You have to pick which is more important.
@Bob yeah it fooled me at first too! 300ms is more inline with what I saw when I played with one, it seems JUST a tad slower that then gstreamer solution I've been using.