Manual

Purpose

KKmulticopter Flash Tool is a tool to easily upload a firmware to your KKmulticopter board. It is designed to support the users that never have flashed a firmware to a micro-controller before. You just have to select your programmer and your board or controller type. Afterwards you have the possibility to flash a firmware file from your PC or directly from the internet by selecting from a list of latest available firmwares. This repository is maintained by me, so if I miss a new version please contact me. The tool is saving some settings on the exit of the tool. To not set-up everything on the next launches of the software it saves the settings you did on program end.

General requirements

To run the tool you need a normal Windows PC, Mac or Linux PC. On your machine should be Java installed at least in version 6. You have to be care full when you download it, because the Oracle homepage offers you automatically a download according to the version of the browser that you use. So if you have a 64 bit OS you should also use a 64 bit browser to download Java. Firefox and Chrome are no 64 bit browsers, but IE9 is 64 bit.

Installation

On Windows or Linux

You just have to un-zip the archive you downloaded to any folder you like.

Mac OS X

Just open the dmg-image and move the kkMulticopter Flash Tool to the Applications folder. If you run Mac OS X 10.7 (Lion) you have also to move the libusb 1.0 file to the lib folder. This action will open a password prompt, where you have to enter your password. Before you move the libusb make sure it is not already on your system. Type ls /usr/local/lib/libusb* to the terminal. If it is already there you should find /usr/local/lib/libusb-1.0.0.dylib

Run the flash tool

To start the tool use the run script dedicated for your OS.

  • kkMulticopterFlashTool.cmd Windows command script
  • kkMulticopterFlashTool.sh Linux bash script
  • The kkMulticopter Flash Tool Mac OS App

Do not run the java executable as the tool will not work properly.

The Menu

Settings

The settings menu has one functions:

  1. you can set the user language.

Contribute

In this menu you can send me a bug report.

The send bug report menu item will open your default email program and paste the content of kklogging.txt to the mail body.

Help

In this part of the menu I collect some internet links to helpful resources to set-up the firmwares I have in the repository and there is a link to this manual.

Info

Contains the About screen and the full text of the GPL 3 license.

Hardware Test

The hardware test abilities of the kkflashtool can be found on the KKMulticopter Checker tab. It is based on the kkcheck V1.0 firmware of Mike Barton. For using the functionality of this module you have to flash the mentioned firmware to the kkboard you want to test. The board's health will be read via a serial adapter and results of the sensors, pot positions and receiver pins can be read on the middle panel of the module.

Requirements

  • In addition to kkboard and ISP adapter (to flash the firmware) you only need a USB-to-serial adapter. You can use e.g. a Sparkfun basic or any CP2102 or PL2303 based adapter. Important is that it works on TTL level (5V).
  • The driver for the adapter must be installed on your system.
  • And four Servo male-to-male wires to connect the receiver input pins with the motor output pins. You can use the one you use to connect to the receiver. Or get some on ebay or for cheap source for people in Europe Flyduino.

Sparkfun FTDI Basic CP 2102 based USB-to-TTL

Preparing the hardware

  • Flash the kkcheck firmware to your kkboard.
  • Set the pots to middle position.
  • Connect the motor outputs M1→M4 to the receiver input pins on the kkboard using the male-to-male wires.
  • Connect the RX pin on the TTL cable to the signal pin of M6 on the kkboard. Do the same for GND and 5V.
    • RXI pin on Sparkfun Basic
    • TXD pin on the CP2102 shown on the image above.
  • Plug the USB end into the PC

Wiring scheme img_0198.jpg

Running the test

  • Switch to the kkMulticopter Checker panel
  • Select the board you want to test. This is only for information at the moment and is only required if you submit your results.
  • Now plug the USB adapter to the PC. LED on the kkboard should begin to blink.
  • Select the serial port from the list.
  • Press start to run the test.
  • After about one second the results of the test appears in the panel named 'Results'. The data are updated every second until you press the stop button.

Understanding the output

Pot Values

The value shows the gain pot setting (range 0 to 1023). Turning the gain pot should change the value.

Gyro Values

This values show Gyro output. These will typically be in the range 700 to 900 (but may be lower depending on the type of gyro) and will naturally fluctuate by a small amount. Turning the board should produce different numbers, if not there is a problem.

Receiver Values

This number should be 1000 +/-2.
If the value is 0, switch the receiver wire with one of the other receiver wires.
If the problem stays with the receiver pin, it is the receiver pin connection.
If the problem moves, the problem is with the motor output pin.

Submit button & Visit instructions button

Submit button

You may send the results of the test to me, with a comment what a brief description of the symptoms or if it is okay. Make sure the board is selected correctly. I will use the data to improve the Health panel.

Visit instructions

This button links to this page.

This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.More information