PaparazziUAV - User contributions [en]

File:Swd.JPG

2014-11-15T15:28:06Z

Evandersman:

Lisa/S/Tutorial/Nano Quadcopter

2014-11-15T15:26:51Z

Evandersman:

<div style="float: right; width: 20%">__TOC__</div>

So you've received your Lisa/S Nano Quadcopter kit, what do you do next...

The following is an example set of instructions on how to put together your new Lisa/S Nano Quadcopter kit. As with all things open source there's always more than one way to do it. So feel free to deviate from the instructions where you feel the need. Of course if you see errors or improvement please feel free to update them.

{{#ev:youtube|7lLxFDNiywM|400}}

== Step 1 - Check the parts and tools ==

First we need to check that we have everything that we need.

The kit contains:
* 1 x Lisa/S
* 1 x Superbit USBRF Dongle
* 2 x CyRF Modules (one mounted on Lisa/S, and one mounted on USBRF dongle)
* 2 x 2.4GHz U.FL whip antennas
* 1 x Cortex JTAG connector to 4 pin SWD connector adapter
* 1 x TTL level UART adapter
* 1 x motor connector adapter kit with battery pigtail
* 2 x 0.05" pitch 10 pin headers
* 1 x 0.05" pitch 4 pin header
* 1 x 120mm class quadcopter frame (brushed motors and propellers included)
* 1 x set of replacement propellers
* 1 x 1S LiPo 230mAh battery
* 1 x battery charger with USB cable
* 1 x 10mm x 10mm GPS patch antenna (optional, only included in the "With GPS Antenna" variant)
* 1 x Black Magic Probe with JTAG and Serial cables (optional, only included in the "With Black Magic Probe" variant)

Other tools:
* A small phillips head screw driver
* A fine tipped soldering iron and solder, flux, etc... (Required if you selected the some soldering required option)
* A multimeter

Useful tools
* A desk vice
* Some 2 mm diameter round toothpicks sanded down to tightly fit the mounting holes of the Lisa/S

== Step 2 - Soldering ==

If you selected the Some Soldering Required option now we need to do that soldering.

* The 4 x 2 pin Molex PicoBlade connectors to the motor adaptor kit PCB
* The battery pig tale to the motor adaptor kit PCB [[File:Soldering.JPG|thumb|none|Soldering]]
* Using the multimeter check that there is '''<u>no</u>''' continuity between the pins of the battery and motor connectors. If there is then you have a solder bridge causing a short which needs to be fixed.
* Check that there is continuity between the positive (red) lead of the battery and the outside pin of the connectors.
* Wash off any flux with flux wash
* Place a tiny amount of solder on the pads on the bottom of the motor adaptor opt PCB where it connects to the Lisa/S. Tip use a solder sucker to suck most of the solder off again. You just want the pads tinned.
* Solder one of the 0.05" pitch 10 pin headers to the Lisa/S CAN, UART, SWD pads
* Alight the motor adaptor PCB with the Lisa/S PCB using the 2 mm toothpicks and solder the 6 pads [[File:Solder_Adaptor_to_LisaS.jpg|thumb|none|Soldering the motor adaptor to the Lisa/S]]
* Wash off any flux with flux wash
* Inspect the PCB to ensuring that all solder joints are wet and no drops of solder have be been left on the board causing shorts.
* Dry the PCB thoroughly with your wife/girlfriends hair dryer while she's out. Remember to put it back as you found it so she doesn't suspect a thing.

Now that you've got this far sit back and bask in the glory of soldering the tiny little joint. You might like to ponder as I did on your decision to opt for the pre soldered kit...

== Step 3 - Assemble the aircraft ==

Now that the fiddly bit has been completed, lets put everything together

* Place a small square of double sided tape on the back of the GPS antenna. [[File:Double_sided_tape.JPG|thumb|none|Double sided tape on the back of the GPS antenna]]
* Attach the GPS antenna to the GPS antenna connector on the Lisa/S
* Attach the CYRF antenna to the CYRF antenna connector [[File:ConnectAntennas.JPG|thumb|none|Antennas connected]]
* Stick the GPS antenna to the back of the CYRF radio PCB [[File:GPS_antenna_stuck_to_CYRF_back.JPG|thumb|none|GPS fixed]]
* Unscrew the 4 screws on the body of the airframe [[File:Airframe_pre-assembly.jpeg|thumb|none|Airframe disassembled]] [[File:LisaS_NanoQ_Assembly_Legend.jpg|thumb|none|Assembly Legend]]
* Insert the 4 arms with attached motors to the body
* Place the Lisa/S on the rubber mounts on the body in your desired orientation and secure with the 4 screws [[File:LisaS_mounted.jpeg|thumb|none|Lisa/S mounted]]
* Connect the 4 motors to the connectors [[File:Motors_connected.jpeg|thumb|none|Motors connected]]

== Step 4 - Install Paparazzi and other tools ==

If you don't already have [http://www.paparazziuav.org/ Paparazzi] installed on a computer now is the time to do so.

Follow the instructions at http://wiki.paparazziuav.org/wiki/Installation.

Tip: If you are installing on Mac OS X we recommend installing using the Source installation method instead of the basic. Some packages in the binary installer might be outdated and cause problems if you decide to use the Basic installation route. With Source installation you guarantee to have the newest packages that are much more likely to work on your version of Mac OS X and XCode.

== Step 5 - Flash the USBRF ==

The superbitrf firmware source code is hosted on Github. Additional information regarding the flashing firmware instructions can be found on the wiki page https://github.com/esden/superbitrf-firmware/wiki.
The flashing firmware instructions are the following:
* Open the terminal
* Clone the superbitrf-firmware repository by typing <code>git clone https://github.com/esden/superbitrf-firmware.git</code>
* Change directory into the superbitrf-firmware directory
* run <code>git submodule</code> init to initialize the libopencm3 submodule
* run <code>git submodule update</code> to download the libopencm3 submodule
* run <code>make</code>
* plug in your Superbit USBRF dongle while holding "the button" on the Superbit USBRF dongle, into your laptop (you should see the red and yellow LED blink alternating, indicating that the bootloader is active)
* run <code>make flash</code>

== Step 6 - Build and upload the Lisa/S firmware ==

While we go through the initial process it would be a good idea to charge the flight battery. You can do this with the [[Lisa/S_Nano_Quadcopter_Kit/BatteryCharger|supplied charger]] or your own battery charger.

Now lets get to building the firmware for the Quadcopter.

* Start Paparazzi Centre by running <code>./paparazzi</code> from a terminal window
* From the A/C menu select <code>LadyLisa</code>
* In the Airframe section check that you have the <code>ladybird_lisa_s.xml</code> airframe file
* In the <code>Target</code> drop down list select <code>ap</code>
* Click the <code>Build</code> button. If everything goes to plan the code will be built and there will not be any errors shown.
* Plug the <code>Serial Wire Debug</code> board into the ribbon cable
* Plug the other end of the ribbon cable into the BlackMagic board
* Plug the USB cable into the BlackMagic board
* Plug the <code>Serial Wire Debug</code> board into the Lisa/S SWD pins
* Plug the other end of the USB cable into a vacant USB port on the computer.
* Connect a fully charged battery to the Lisa/S
* From the <code>Flash mode</code> drop down list select <code>BlackMagic Probe (SWD)</code>
* Click the <code>Upload</code> button. You should see the LEDs of the Lisa/S go out and only the Power LED remains lit while the upload takes place. Once complete the other LEDs will light.

If using the Black Magic Probe use the [http://1bitsquared.com/collections/all-products/products/jtag-idc-cable "JTAG SWD Cable"] with [http://1bitsquared.com/collections/all-products/products/jtag-swd-adapter "JTAG SWD Adapter] and connect to the 4pin SWD header on the [http://1bitsquared.com/collections/autopilots/products/lisa-s Lisa/S] with the adapter facing away from the Lisa/S. [[File:swd.JPG|thumb|none|Connect the 4pin SWD header with the Lisa/S]]

If you are using Mac OS-X, then you have to create a symbolic link for the BlackMagic to be seen as <code>ttyACM0</code>. Plug your BlackMagic board into a USB port on the computer and write " ls -l /dev/*usb* /dev/*USB* " command in a terminal window in order to see the device name. Use the first appearing name which should be something like /dev/cu.usbmodemE3BBA8B7. Then create a sym link with "sudo ln -s /dev/cu.usbmodemE3BBA8B7 /dev/ttyACM0 " command. Check the sym link by "ls -l /dev/ttyACM0 " command. Now the flashing should work.

== Step 7 - Binding your transmitter to the Superbit USBRF dongle ==

*Plug in the Superbit USBRF dongle into your computer
*Press "the button" on the Superbit USBRF dongle (the orange led should light up)
*Turn on your transmitter while holding the bind button. (for more information how to turn on your transmitter in bind mode refer to your transmitters documentation. This varies a lot depending on the version and maker of the transmitter. Spektrum DX6I and Orange RX transmitters you just hold the Trainer switch while you power it on. Others have a dedicated bind button on the back of the transmitter that you hold while turning on your transmitter.)
*If binding was successful the orange led will turn off
*Release the bind button on the transmitter
*After few seconds another led will light up indicating that the dongle is seeing/receiving packets from the transmitter
Tip: sometimes the binding is not successful on the first try, you might need to turn off and on (while still holding the bind button) your transmitter several times before the dongle recognizes your transmitter and the orange LED turns off

== Step 8 - Binding your transmitter to Lisa/S ==

*Power on the Lisa/S autopilot while holding the bind button on the board
*The Radio LED should be blinking in short blinks once a second
*Turn on your transmitter while holding the bind button
*The Radio LED should stop blinking
*Now you will have to press the bind button again and the transmitter should get recognized and the data should be received

[[Category:Lisa]] [[Category:User_Documentation]] [[Category:Tutorial]]

Lisa/S/Tutorial/Nano Quadcopter

2014-11-14T18:43:28Z

Evandersman:

<div style="float: right; width: 20%">__TOC__</div>

So you've received your Lisa/S Nano Quadcopter kit, what do you do next...

The following is an example set of instructions on how to put together your new Lisa/S Nano Quadcopter kit. As with all things open source there's always more than one way to do it. So feel free to deviate from the instructions where you feel the need. Of course if you see errors or improvement please feel free to update them.

{{#ev:youtube|7lLxFDNiywM|400}}

== Step 1 - Check the parts and tools ==

First we need to check that we have everything that we need.

The kit contains:
* 1 x Lisa/S
* 1 x Superbit USBRF Dongle
* 2 x CyRF Modules (one mounted on Lisa/S, and one mounted on USBRF dongle)
* 2 x 2.4GHz U.FL whip antennas
* 1 x Cortex JTAG connector to 4 pin SWD connector adapter
* 1 x TTL level UART adapter
* 1 x motor connector adapter kit with battery pigtail
* 2 x 0.05" pitch 10 pin headers
* 1 x 0.05" pitch 4 pin header
* 1 x 120mm class quadcopter frame (brushed motors and propellers included)
* 1 x set of replacement propellers
* 1 x 1S LiPo 230mAh battery
* 1 x battery charger with USB cable
* 1 x 10mm x 10mm GPS patch antenna (optional, only included in the "With GPS Antenna" variant)
* 1 x Black Magic Probe with JTAG and Serial cables (optional, only included in the "With Black Magic Probe" variant)

Other tools:
* A small phillips head screw driver
* A fine tipped soldering iron and solder, flux, etc... (Required if you selected the some soldering required option)
* A multimeter

Useful tools
* A desk vice
* Some 2 mm diameter round toothpicks sanded down to tightly fit the mounting holes of the Lisa/S

== Step 2 - Soldering ==

If you selected the Some Soldering Required option now we need to do that soldering.

* The 4 x 2 pin Molex PicoBlade connectors to the motor adaptor kit PCB
* The battery pig tale to the motor adaptor kit PCB [[File:Soldering.JPG|thumb|none|Soldering]]
* Using the multimeter check that there is '''<u>no</u>''' continuity between the pins of the battery and motor connectors. If there is then you have a solder bridge causing a short which needs to be fixed.
* Check that there is continuity between the positive (red) lead of the battery and the outside pin of the connectors.
* Wash off any flux with flux wash
* Place a tiny amount of solder on the pads on the bottom of the motor adaptor opt PCB where it connects to the Lisa/S. Tip use a solder sucker to suck most of the solder off again. You just want the pads tinned.
* Solder one of the 0.05" pitch 10 pin headers to the Lisa/S CAN, UART, SWD pads
* Alight the motor adaptor PCB with the Lisa/S PCB using the 2 mm toothpicks and solder the 6 pads [[File:Solder_Adaptor_to_LisaS.jpg|thumb|none|Soldering the motor adaptor to the Lisa/S]]
* Wash off any flux with flux wash
* Inspect the PCB to ensuring that all solder joints are wet and no drops of solder have be been left on the board causing shorts.
* Dry the PCB thoroughly with your wife/girlfriends hair dryer while she's out. Remember to put it back as you found it so she doesn't suspect a thing.

Now that you've got this far sit back and bask in the glory of soldering the tiny little joint. You might like to ponder as I did on your decision to opt for the pre soldered kit...

== Step 3 - Assemble the aircraft ==

Now that the fiddly bit has been completed, lets put everything together

* Place a small square of double sided tape on the back of the GPS antenna. [[File:Double_sided_tape.JPG|thumb|none|Double sided tape on the back of the GPS antenna]]
* Attach the GPS antenna to the GPS antenna connector on the Lisa/S
* Attach the CYRF antenna to the CYRF antenna connector [[File:ConnectAntennas.JPG|thumb|none|Antennas connected]]
* Stick the GPS antenna to the back of the CYRF radio PCB [[File:GPS_antenna_stuck_to_CYRF_back.JPG|thumb|none|GPS fixed]]
* Unscrew the 4 screws on the body of the airframe [[File:Airframe_pre-assembly.jpeg|thumb|none|Airframe disassembled]] [[File:LisaS_NanoQ_Assembly_Legend.jpg|thumb|none|Assembly Legend]]
* Insert the 4 arms with attached motors to the body
* Place the Lisa/S on the rubber mounts on the body in your desired orientation and secure with the 4 screws [[File:LisaS_mounted.jpeg|thumb|none|Lisa/S mounted]]
* Connect the 4 motors to the connectors [[File:Motors_connected.jpeg|thumb|none|Motors connected]]

== Step 4 - Install Paparazzi and other tools ==

If you don't already have [http://www.paparazziuav.org/ Paparazzi] installed on a computer now is the time to do so.

Follow the instructions at http://wiki.paparazziuav.org/wiki/Installation.

Tip: If you are installing on Mac OS X we recommend installing using the Source installation method instead of the basic. Some packages in the binary installer might be outdated and cause problems if you decide to use the Basic installation route. With Source installation you guarantee to have the newest packages that are much more likely to work on your version of Mac OS X and XCode.

== Step 5 - Flash the USBRF ==

The superbitrf firmware source code is hosted on Github. Additional information regarding the flashing firmware instructions can be found on the wiki page https://github.com/esden/superbitrf-firmware/wiki.
The flashing firmware instructions are the following:
* Open the terminal
* Clone the superbitrf-firmware repository by typing <code>git clone https://github.com/esden/superbitrf-firmware.git</code>
* Change directory into the superbitrf-firmware directory
* run <code>git submodule</code> init to initialize the libopencm3 submodule
* run <code>git submodule update</code> to download the libopencm3 submodule
* run <code>make</code>
* plug in your Superbit USBRF dongle while holding "the button" on the Superbit USBRF dongle, into your laptop (you should see the red and yellow LED blink alternating, indicating that the bootloader is active)
* run <code>make flash</code>

== Step 6 - Build and upload the Lisa/S firmware ==

While we go through the initial process it would be a good idea to charge the flight battery. You can do this with the [[Lisa/S_Nano_Quadcopter_Kit/BatteryCharger|supplied charger]] or your own battery charger.

Now lets get to building the firmware for the Quadcopter.

* Start Paparazzi Centre by running <code>./paparazzi</code> from a terminal window
* From the A/C menu select <code>LadyLisa</code>
* In the Airframe section check that you have the <code>ladybird_lisa_s.xml</code> airframe file
* In the <code>Target</code> drop down list select <code>ap</code>
* Click the <code>Build</code> button. If everything goes to plan the code will be built and there will not be any errors shown.
* Plug the <code>Serial Wire Debug</code> board into the ribbon cable
* Plug the other end of the ribbon cable into the BlackMagic board
* Plug the USB cable into the BlackMagic board
* Plug the <code>Serial Wire Debug</code> board into the Lisa/S SWD pins
* Plug the other end of the USB cable into a vacant USB port on the computer.
* Connect a fully charged battery to the Lisa/S
* From the <code>Flash mode</code> drop down list select <code>BlackMagic Probe (SWD)</code>
* Click the <code>Upload</code> button. You should see the LEDs of the Lisa/S go out and only the Power LED remains lit while the upload takes place. Once complete the other LEDs will light.

If using the Black Magic Probe use the [http://1bitsquared.com/collections/all-products/products/jtag-idc-cable "JTAG SWD Cable"] with [http://1bitsquared.com/collections/all-products/products/jtag-swd-adapter "JTAG SWD Adapter] and connect to the 4pin SWD header on the [http://1bitsquared.com/collections/autopilots/products/lisa-s Lisa/S] with the adapter facing away from the Lisa/S.

If you are using Mac OS-X, then you have to create a symbolic link for the BlackMagic to be seen as <code>ttyACM0</code>. Plug your BlackMagic board into a USB port on the computer and write " ls -l /dev/*usb* /dev/*USB* " command in a terminal window in order to see the device name. Use the first appearing name which should be something like /dev/cu.usbmodemE3BBA8B7. Then create a sym link with "sudo ln -s /dev/cu.usbmodemE3BBA8B7 /dev/ttyACM0 " command. Check the sym link by "ls -l /dev/ttyACM0 " command. Now the flashing should work.

== Step 7 - Binding your transmitter to the Superbit USBRF dongle ==

*Plug in the Superbit USBRF dongle into your computer
*Press "the button" on the Superbit USBRF dongle (the orange led should light up)
*Turn on your transmitter while holding the bind button. (for more information how to turn on your transmitter in bind mode refer to your transmitters documentation. This varies a lot depending on the version and maker of the transmitter. Spektrum DX6I and Orange RX transmitters you just hold the Trainer switch while you power it on. Others have a dedicated bind button on the back of the transmitter that you hold while turning on your transmitter.)
*If binding was successful the orange led will turn off
*Release the bind button on the transmitter
*After few seconds another led will light up indicating that the dongle is seeing/receiving packets from the transmitter
Tip: sometimes the binding is not successful on the first try, you might need to turn off and on (while still holding the bind button) your transmitter several times before the dongle recognizes your transmitter and the orange LED turns off

== Step 8 - Binding your transmitter to Lisa/S ==

*Power on the Lisa/S autopilot while holding the bind button on the board
*The Radio LED should be blinking in short blinks once a second
*Turn on your transmitter while holding the bind button
*The Radio LED should stop blinking
*Now you will have to press the bind button again and the transmitter should get recognized and the data should be received

[[Category:Lisa]] [[Category:User_Documentation]] [[Category:Tutorial]]

Tutorials

2014-11-14T18:36:04Z

Evandersman: /* Other */

__TOC__

Various tutorials in all kinds.

== Piotr Esden-Tempski @ Hak5 ==

Piotr gave a series of interviews at Hack5 in which he walks through most steps setting up a Quadrotor with the LisaMv2.<br/>
The [https://github.com/paparazzi/paparazzi/blob/master/conf/airframes/examples/bumblebee_quad.xml bumblebee_quad.xml] airframe file is included in the default installation of paparazzi, and can be easily found in the default airframe paparazzi center dropdown as "Bumblebee_Quad".<br/>
This may be very helpful for beginners since a lot of important (but not all for a beginner required) paparazzi related stuff is explained. <br/>
The videos also contain some additional stuff which has nothing to do with paparazzi.

{{#ev:youtube|wBW7XXn_Bok|200|left}}
[https://www.youtube.com/watch?v=wBW7XXn_Bok Open Source Drones and Android SDR, Hak5 1611]
* Introduction to the terms Drones, UAV and UAS.
* Mechanical difference between quadcopter and helicopter, why the quadcopter is more common on hobbyists.
* Possible uses of UAV/UAS (non military).
* Safety guidelines (use your brain!, airports, other people...).

<br style="clear:both">

{{#ev:youtube|YZTPIS6mUjM|200|left}}
[https://www.youtube.com/watch?v=YZTPIS6mUjM Drone Basics and Open Source Ship Tracking, Hak5 1612]
* Quad, hexa and optocopters, which are the different benefits?
* Which parameters influence the propellers thrust(pitch, kV, V)?
* Short talks about brushed/brushless motors, frames, in this build used radio system and LiPo battery.
* Why a quadcopter can't be controled directly ba a human.

<br style="clear:both">

{{#ev:youtube|4wTGoogBvp8|200|left}}
[https://www.youtube.com/watch?v=4wTGoogBvp8 Drones 101: Flight Controllers + Tracking Aircraft 5000 miles away! Hak5 1615]
* How does an autopilot work in principle and which are the minimum requirements for stabilisation e.g..
* MEMS; Gyroscope, Accelerometer & Magnetometer, Barometer, what they can measure and what the autopilot can do with these measurements .
* Different Flight controller; Paparazzi, DJI Naza, Ardupilot, Multiwii.
* Paparazzi over the time, which controller has been used in the past (AVR -> LPC -> STM32).

<br style="clear:both">

{{#ev:youtube|f9AFSDn2AZU|200|left}}
[https://www.youtube.com/watch?v=f9AFSDn2AZU Drones 101: Open Source Autopilot, Hak5 1616]
* LisaMv2 with Aspirinv2.2 small overview.
* Paparazzi center walkthough, from (left to right) the code parts, to compiling and uploading.
* How paparazzi is released on github (stable and cutting edge).
* What do the Airframe, Flight Plan, Settings, Radio and Telemetry xml files do?
* Build the firmware with gcc and upload it to LisaMv2.
* LisaMv2's Bootloader mode.
* GCS walkthough with the basic components.
* Connect LisaMv2 via [[Programming_adapter#FLOSS_JTAG|Floss JTAG's]] uart port to the GCS.

<br style="clear:both">

{{#ev:youtube|fZbZTGCS4t8|200|left}}
[https://www.youtube.com/watch?v=fZbZTGCS4t8 Drone Assembly and Trunked Radio Systems, Hak5 1617]
* Assembling the Bumblebee carbon fiber airframe.
* Zip tie down the ESC cables and mounting the LisaMv2.

<br style="clear:both">

{{#ev:youtube|CQ6kD48WMxc|200|left}}
[https://www.youtube.com/watch?v=CQ6kD48WMxc Drone Wiring And Moving On From TrueCrypt With LUKS, Hak5 1618]
* Connecting peripherals on the quadrocopter (BEC, redundant Spektrum, telemetry modem, gps receiver).
* Connect to a power source (limited power supply / LiPo).
* Binding the Spektrum satelites with a bind plug over the LisaMv2.

<br style="clear:both">

{{#ev:youtube|ZwvRYLuXi0w|200|left}}
[https://www.youtube.com/watch?v=ZwvRYLuXi0w Finalizing The Drone and Text Obfuscation With FauxCrypt, Hak5 1619]
* Connect quadcopter with GCS
* Intro to Messages, Real-time Plotter.
* Calibrating the accelerometer and magnetometer.
* Maiden flight.

<br style="clear:both">

== Other ==
[[Lisa/S/Tutorial/Nano_Quadcopter]]

[[Lisa/M/Tutorial/FixedWing]]

[[Lisa/M/Tutorial/RotorCraft]]

[[User/LisaL/Tutorial/Quadrocopter]]

[[Lisa_Asctec_Bringup]]

Lisa/S/Tutorial/Nano Quadcopter

2014-11-14T18:34:57Z

Evandersman:

So you've received your Lisa/S Nano Quadcopter kit, what do you do next...

The following is an example set of instructions on how to put together your new Lisa/S Nano Quadcopter kit. As with all things open source there's always more than one way to do it. So feel free to deviate from the instructions where you feel the need. Of course if you see errors or improvement please feel free to update them.

== Step 1 - Check the parts and tools ==

First we need to check that we have everything that we need.

The kit contains:
* 1 x Lisa/S
* 1 x Superbit USBRF Dongle
* 2 x CyRF Modules (one mounted on Lisa/S, and one mounted on USBRF dongle)
* 2 x 2.4GHz U.FL whip antennas
* 1 x Cortex JTAG connector to 4 pin SWD connector adapter
* 1 x TTL level UART adapter
* 1 x motor connector adapter kit with battery pigtail
* 2 x 0.05" pitch 10 pin headers
* 1 x 0.05" pitch 4 pin header
* 1 x 120mm class quadcopter frame (brushed motors and propellers included)
* 1 x set of replacement propellers
* 1 x 1S LiPo 230mAh battery
* 1 x battery charger with USB cable
* 1 x 10mm x 10mm GPS patch antenna (optional, only included in the "With GPS Antenna" variant)
* 1 x Black Magic Probe with JTAG and Serial cables (optional, only included in the "With Black Magic Probe" variant)

Other tools:
* A small phillips head screw driver
* A fine tipped soldering iron and solder, flux, etc... (Required if you selected the some soldering required option)
* A multimeter

Useful tools
* A desk vice
* Some 2 mm diameter round toothpicks sanded down to tightly fit the mounting holes of the Lisa/S

== Step 2 - Soldering ==

If you selected the Some Soldering Required option now we need to do that soldering.

* The 4 x 2 pin Molex PicoBlade connectors to the motor adaptor kit PCB
* The battery pig tale to the motor adaptor kit PCB [[File:Soldering.JPG|thumb|none|Soldering]]
* Using the multimeter check that there is '''<u>no</u>''' continuity between the pins of the battery and motor connectors. If there is then you have a solder bridge causing a short which needs to be fixed.
* Check that there is continuity between the positive (red) lead of the battery and the outside pin of the connectors.
* Wash off any flux with flux wash
* Place a tiny amount of solder on the pads on the bottom of the motor adaptor opt PCB where it connects to the Lisa/S. Tip use a solder sucker to suck most of the solder off again. You just want the pads tinned.
* Solder one of the 0.05" pitch 10 pin headers to the Lisa/S CAN, UART, SWD pads
* Alight the motor adaptor PCB with the Lisa/S PCB using the 2 mm toothpicks and solder the 6 pads [[File:Solder_Adaptor_to_LisaS.jpg|thumb|none|Soldering the motor adaptor to the Lisa/S]]
* Wash off any flux with flux wash
* Inspect the PCB to ensuring that all solder joints are wet and no drops of solder have be been left on the board causing shorts.
* Dry the PCB thoroughly with your wife/girlfriends hair dryer while she's out. Remember to put it back as you found it so she doesn't suspect a thing.

Now that you've got this far sit back and bask in the glory of soldering the tiny little joint. You might like to ponder as I did on your decision to opt for the pre soldered kit...

== Step 3 - Assemble the aircraft ==

Now that the fiddly bit has been completed, lets put everything together

* Place a small square of double sided tape on the back of the GPS antenna. [[File:Double_sided_tape.JPG|thumb|none|Double sided tape on the back of the GPS antenna]]
* Attach the GPS antenna to the GPS antenna connector on the Lisa/S
* Attach the CYRF antenna to the CYRF antenna connector [[File:ConnectAntennas.JPG|thumb|none|Antennas connected]]
* Stick the GPS antenna to the back of the CYRF radio PCB [[File:GPS_antenna_stuck_to_CYRF_back.JPG|thumb|none|GPS fixed]]
* Unscrew the 4 screws on the body of the airframe [[File:Airframe_pre-assembly.jpeg|thumb|none|Airframe disassembled]] [[File:LisaS_NanoQ_Assembly_Legend.jpg|thumb|none|Assembly Legend]]
* Insert the 4 arms with attached motors to the body
* Place the Lisa/S on the rubber mounts on the body in your desired orientation and secure with the 4 screws [[File:LisaS_mounted.jpeg|thumb|none|Lisa/S mounted]]
* Connect the 4 motors to the connectors [[File:Motors_connected.jpeg|thumb|none|Motors connected]]

== Step 4 - Install Paparazzi and other tools ==

If you don't already have [http://www.paparazziuav.org/ Paparazzi] installed on a computer now is the time to do so.

Follow the instructions at http://wiki.paparazziuav.org/wiki/Installation.

Tip: If you are installing on Mac OS X we recommend installing using the Source installation method instead of the basic. Some packages in the binary installer might be outdated and cause problems if you decide to use the Basic installation route. With Source installation you guarantee to have the newest packages that are much more likely to work on your version of Mac OS X and XCode.

== Step 5 - Flash the USBRF ==

The superbitrf firmware source code is hosted on Github. Additional information regarding the flashing firmware instructions can be found on the wiki page https://github.com/esden/superbitrf-firmware/wiki.
The flashing firmware instructions are the following:
* Open the terminal
* Clone the superbitrf-firmware repository by typing <code>git clone https://github.com/esden/superbitrf-firmware.git</code>
* Change directory into the superbitrf-firmware directory
* run <code>git submodule</code> init to initialize the libopencm3 submodule
* run <code>git submodule update</code> to download the libopencm3 submodule
* run <code>make</code>
* plug in your Superbit USBRF dongle while holding "the button" on the Superbit USBRF dongle, into your laptop (you should see the red and yellow LED blink alternating, indicating that the bootloader is active)
* run <code>make flash</code>

== Step 6 - Build and upload the Lisa/S firmware ==

While we go through the initial process it would be a good idea to charge the flight battery. You can do this with the [[Lisa/S_Nano_Quadcopter_Kit/BatteryCharger|supplied charger]] or your own battery charger.

Now lets get to building the firmware for the Quadcopter.

* Start Paparazzi Centre by running <code>./paparazzi</code> from a terminal window
* From the A/C menu select <code>LadyLisa</code>
* In the Airframe section check that you have the <code>ladybird_lisa_s.xml</code> airframe file
* In the <code>Target</code> drop down list select <code>ap</code>
* Click the <code>Build</code> button. If everything goes to plan the code will be built and there will not be any errors shown.
* Plug the <code>Serial Wire Debug</code> board into the ribbon cable
* Plug the other end of the ribbon cable into the BlackMagic board
* Plug the USB cable into the BlackMagic board
* Plug the <code>Serial Wire Debug</code> board into the Lisa/S SWD pins
* Plug the other end of the USB cable into a vacant USB port on the computer.
* Connect a fully charged battery to the Lisa/S
* From the <code>Flash mode</code> drop down list select <code>BlackMagic Probe (SWD)</code>
* Click the <code>Upload</code> button. You should see the LEDs of the Lisa/S go out and only the Power LED remains lit while the upload takes place. Once complete the other LEDs will light.

If using the Black Magic Probe use the [http://1bitsquared.com/collections/all-products/products/jtag-idc-cable "JTAG SWD Cable"] with [http://1bitsquared.com/collections/all-products/products/jtag-swd-adapter "JTAG SWD Adapter] and connect to the 4pin SWD header on the [http://1bitsquared.com/collections/autopilots/products/lisa-s Lisa/S] with the adapter facing away from the Lisa/S.

If you are using Mac OS-X, then you have to create a symbolic link for the BlackMagic to be seen as <code>ttyACM0</code>. Plug your BlackMagic board into a USB port on the computer and write " ls -l /dev/*usb* /dev/*USB* " command in a terminal window in order to see the device name. Use the first appearing name which should be something like /dev/cu.usbmodemE3BBA8B7. Then create a sym link with "sudo ln -s /dev/cu.usbmodemE3BBA8B7 /dev/ttyACM0 " command. Check the sym link by "ls -l /dev/ttyACM0 " command. Now the flashing should work.

== Step 7 - Binding your transmitter to the Superbit USBRF dongle ==

*Plug in the Superbit USBRF dongle into your computer
*Press "the button" on the Superbit USBRF dongle (the orange led should light up)
*Turn on your transmitter while holding the bind button. (for more information how to turn on your transmitter in bind mode refer to your transmitters documentation. This varies a lot depending on the version and maker of the transmitter. Spektrum DX6I and Orange RX transmitters you just hold the Trainer switch while you power it on. Others have a dedicated bind button on the back of the transmitter that you hold while turning on your transmitter.)
*If binding was successful the orange led will turn off
*Release the bind button on the transmitter
*After few seconds another led will light up indicating that the dongle is seeing/receiving packets from the transmitter
Tip: sometimes the binding is not successful on the first try, you might need to turn off and on (while still holding the bind button) your transmitter several times before the dongle recognizes your transmitter and the orange LED turns off

== Step 8 - Binding your transmitter to Lisa/S ==

*Power on the Lisa/S autopilot while holding the bind button on the board
*The Radio LED should be blinking in short blinks once a second
*Turn on your transmitter while holding the bind button
*The Radio LED should stop blinking
*Now you will have to press the bind button again and the transmitter should get recognized and the data should be received

[[Category:Lisa]] [[Category:User_Documentation]] [[Category:Tutorial]]

File:Airframe pre-assembly.jpeg

2014-11-14T18:32:07Z

Evandersman:

File:ConnectAntennas.JPG

2014-11-14T18:31:47Z

Evandersman:

File:Double sided tape.JPG

2014-11-14T18:31:28Z

Evandersman:

File:GPS antenna stuck to CYRF back.JPG

2014-11-14T18:31:13Z

Evandersman:

File:LisaS mounted.jpeg

2014-11-14T18:30:56Z

Evandersman:

File:LisaS NanoQ Assembly Legend.jpg

2014-11-14T18:30:41Z

Evandersman:

File:Motors connected.jpeg

2014-11-14T18:30:27Z

Evandersman:

File:Solder Adaptor to LisaS.jpg

2014-11-14T18:30:00Z

Evandersman:

File:Soldering.JPG

2014-11-14T18:29:00Z

Evandersman:

Lisa/S/Tutorial/Nano Quadcopter

2014-11-14T18:26:27Z

Evandersman: Created page with "So you've received your Lisa/S Nano Quadcopter kit, what do you do next... The following is an example set of instructions on how to put together your new Lisa/S Nano Quadcop..."