Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Tree [97707f] /
History



File Date Author Commit
cmake 2012-09-22 Zoltan Padrah Zoltan Padrah [d9bbba] Merge branch 'master' into new-gui
doc 2012-07-10 Zoltan Padrah Zoltan Padrah [97707f] all images are added inline
examples 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
icons 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
microbe 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
po 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
src 2012-09-22 Zoltan Padrah Zoltan Padrah [b19732] start implementing the actions to be added in t...
tests 2011-12-08 Zoltan P Zoltan P [c497bc] Merge branch 'master' of git@github.com:ktechla...
.gitignore 2012-09-22 Zoltan Padrah Zoltan Padrah [d9bbba] Merge branch 'master' into new-gui
AUTHORS 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
CMakeLists.txt 2011-07-15 johnyb johnyb [812dd5] Merge pull request #2 from ktechlab/no-qt3suppo...
COPYING 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
ChangeLog 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
Doxyfile 2011-08-10 Zoltan P Zoltan P [556cea] remove trailing whitespace from doxyfile
INSTALL 2012-06-28 Zoltan Padrah Zoltan Padrah [420617] add running-testing section to the INSTALL file
NEWS 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
README.md 2012-06-28 Zoltan Padrah Zoltan Padrah [77e329] consistent spaces around "/"
TODO 2011-05-18 Zoltan P Zoltan P [19ebe3] merge the minimal_simulator branch to the maste...
config.h.cmake 2011-07-15 johnyb johnyb [812dd5] Merge pull request #2 from ktechlab/no-qt3suppo...
simple-launch.sh 2012-09-22 Zoltan Padrah Zoltan Padrah [d9bbba] Merge branch 'master' into new-gui
simple-setup.sh 2012-09-22 Zoltan Padrah Zoltan Padrah [d9bbba] Merge branch 'master' into new-gui

Read Me

KTechLab

KTechLab is an IDE for microcontrollers and electronics.
It supports circuit simulation,
program development for microcontrollers and
simulating the programmed microcontroller together with its application circuit.

Introduction

Resources

Getting the source

KTechLab's source code is located in GIT repositories.

The official repository is located on github:

Other notable GIT repositories are located on sourceforge:

  • main KTechLab repository:

    • git://ktechlab.git.sourceforge.net/gitroot/ktechlab/ktechlab
    • contains the contents of the previously used SVN repository
  • developers' own repositories:

    • git://ktechlab.git.sourceforge.net/gitroot/ktechlab/ktl-alonzotg
    • git://ktechlab.git.sourceforge.net/gitroot/ktechlab/ktl-j_ohny_b
    • git://ktechlab.git.sourceforge.net/gitroot/ktechlab/ktl-zoltan_p
      • the master branch should have the same content as the
        official master branch from github
    • these repositories contain work-in-progress code,
      which is supposed to be merged in the master branch on github

Checking out from GIT can be performed with the following commands:

git clone git://github.com/ktechlab/ktechlab.git
cd ktechlab
git checkout -b master --track origin/master

Building and Running

Required dependencies

  • Qt4 -dev
  • cmake
  • glib -dev

Optional dependencies

  • KDE4 libraries -dev
  • KDevPlatform libraries -dev
    • NOTE: without the following two components, only the unit tests
      will be built; those are not useful for end-users
  • GPSim -dev, for microcontroller support
  • Eigen2 -dev, for unit tests; generally it is not needed for builds
    targeted to end-users, but it is useful for development

Since KDE4, all Makefiles in KDE projects are generated using CMake.
After checking out the source (see Getting the source),
here is how to compile and install KTechLab.
CMkake is not a run-time dependency of KTechLab.

  1. By using a terminal, navigate to the top-level source-directory

  2. Run the shell script simple-setup.sh.
    This command compiles KTechLab into the directory simple-build,
    installs it into the directory simple-install and
    sets up the user-specific settings (syscoca, mime database) for the
    current user.

     sh simple-setup.sh
    
  3. Launch KTechLab by running the script simple-launch.sh

     sh simple-launch.sh
    

KTechLab should start running at this point.
If this simple method of launching KTechLab does not work,
please contact the developers, because you found is a bug.

Running by multiple users with same build/install directory

It is possible to run an already compiled and installed version of KTechLab
by multiple users. In order to do this, run the script
ktechlab-user-setup.sh from the simple-install/bin/ directory

     sh simple/install/bin/ktechlab-user-setup.sh

Then you can launch KTechLab as usual

    sh simple-launch.sh

Running a build when the source/build/install directory has been moved

It the source directory has been moved, then the setup procedure has
to be rerun. This is due to the fact that in the launch scripts of
KTechLab, absolute directory paths are generated.
The compilation step should be a lot faster than previously, because
the source files have not been changed, so the existing build is
just verified, not recreated.

     sh simple-setup.sh
     sh simple-launch.sh

Have fun with KTechLab!