Difference between revisions of "KDevelop"

From ElphelWiki
Jump to: navigation, search
 
Line 13: Line 13:
 
directory, you may run the script with the following command:
 
directory, you may run the script with the following command:
 
  php prep_kdevelop.php --strict
 
  php prep_kdevelop.php --strict
With the '--strict' option this script will terminate if any of the required programs is missing (and output what exactly is needed to be installed). If all dependencies are satisfied the script will continue and create/modify several files:
+
With the '--strict' option this script will terminate if any of the required programs is missing (and output what exactly is needed to be installed). If all dependencies are satisfied the script will continue and create/modify several files:
 
*elphel353.kdevelop - KDevelop project, you may open it with KDevelop application by mouse-clicking this file in the file manager
 
*elphel353.kdevelop - KDevelop project, you may open it with KDevelop application by mouse-clicking this file in the file manager
 
*tags          - ctags index file, used by KDevelop to locate where the current name is declared or defined
 
*tags          - ctags index file, used by KDevelop to locate where the current name is declared or defined
Line 26: Line 26:
 
*templates/tf  - template for the Verilog HDL test fixture files
 
*templates/tf  - template for the Verilog HDL test fixture files
 
*templates/ucf  - template for the user constraint files (used with Verilog files)
 
*templates/ucf  - template for the user constraint files (used with Verilog files)
*~/.kde/share/config/kdeveloprc - KDevelop configuration file
+
*~/.kde/share/config/kdeveloprc - KDevelop configuration file.
 +
===Usage===
 +
KDevelop itself is documented [http://docs.kde.org/development/en/kdevelop/kdevelop/ on the KDE web site] so below are only Elphel-specific notes.
 +
====Building firmware====
 +
The complete firmware for the camera can be created with '''Build -> Build Project''', it is the same as running
 +
. ./init_env
 +
make
 +
from the project top directory, the difference is that in KDevelop you can click on the error/warning message and jump to the source code.
 +
====Building camera applications====
 +
If you need to (re)build just a single application in the camera, not the whole image - you may (while the source file is selected in the editor) use '''Build -> Compile''' - it is similar to running
 +
make install
 +
in the directory of the source file. After successful completion of this command you may ftp (or scp) the produced binary to the camera file system.
 +
 
 +
 
 +
 
 +
 
 
http://docs.elphel.com/elphel353-7.1/
 
http://docs.elphel.com/elphel353-7.1/

Revision as of 17:07, 7 August 2008

Using KDevelop with Elphel cameras software

It is now possible to use KDevelop (Integrated Development Environment) with Elphel cameras software. KDevelop provides graphical user interface to what was console environment only.

Installing

In order to use this feature you first need to install Elphel software - either the latest release from the Sourceforge (not yet released) or from CVS (i.e. downloading, unzipping and runningelphel353_install_from_cvs.sh).

After the software is installed (it takes some time to run ./install_elphel) you may navigate to the project root directory and run

./prep_kdevelop.php --strict

This script will require several pieces of the software to be installed - the first one is PHP (>=5.0.0) itself (including php5-cli). If PHP is installed in other than

/usr/local/php

directory, you may run the script with the following command:

php prep_kdevelop.php --strict

With the '--strict' option this script will terminate if any of the required programs is missing (and output what exactly is needed to be installed). If all dependencies are satisfied the script will continue and create/modify several files:

  • elphel353.kdevelop - KDevelop project, you may open it with KDevelop application by mouse-clicking this file in the file manager
  • tags - ctags index file, used by KDevelop to locate where the current name is declared or defined
  • ctags_excludes - list of directories (with wildcards) to exclude from ctags indexing (i.e. drivers for other architectures)
  • Doxyfile - Doxygen configuration (including the list of the subdirectories to scan) - used to generate documentation
  • templates - directory for custom file templates (headers for the new files)
  • templates/c - template for the C source files
  • templates/cpp - template for the C++ source files
  • templates/h - template for the C/C++ header files
  • templates/php - template for the PHP files
  • templates/v - template for the Verilog HDL source files
  • templates/tf - template for the Verilog HDL test fixture files
  • templates/ucf - template for the user constraint files (used with Verilog files)
  • ~/.kde/share/config/kdeveloprc - KDevelop configuration file.

Usage

KDevelop itself is documented on the KDE web site so below are only Elphel-specific notes.

Building firmware

The complete firmware for the camera can be created with Build -> Build Project, it is the same as running

. ./init_env
make

from the project top directory, the difference is that in KDevelop you can click on the error/warning message and jump to the source code.

Building camera applications

If you need to (re)build just a single application in the camera, not the whole image - you may (while the source file is selected in the editor) use Build -> Compile - it is similar to running

make install

in the directory of the source file. After successful completion of this command you may ftp (or scp) the produced binary to the camera file system.



http://docs.elphel.com/elphel353-7.1/