2. Introduction

This handbook describes a way to develop for opie, the first free linux "standard" desktop for handhelds and other embedded systems. It is based on the actual opie development strategy using trolltechs tmake/qmake instead of gnu-autoconf.

The goal of this document is to provide other developers with information sampled during my investigations using the internet and my experience, which was build up during several approaches to write opie compliant programs (I did not reach full compliance yet ;-)).

The handbook describes how to setup the opie develop environment (arm-kernel, cross-compiler and arm- libraries / emb-libraries) as well as kdevelop (and related progs, like qt-designer), which is my favourite development suite.

The following tutorial teaching opie development using example programs and a chapter "Opie Guidelines" is also included. The tutorial uses kdevelop as a basis.

This chapter (Intoduction) contains the history, a downloads section and the document roadbook.

2.1 Impressum

Werner Schulte
Pflugstrasse 5b
65462 Ginsheim / Germany
email : werner@schulte-ac.de

2.2 Document versions

• 0.2.7
  - addopie : new strategy not any more copied into the compiler dir, but into and extra directory (addopie/ipaq .. sharp) ADDOPIE - gcc 3.2.3 for glibc-2.2 added (bootstrap compiler for pxa kernel)
• 0.2.6
  - LIVE CD Extensions extended (V0.2.6) - changed to qte 2.3.7, some minor hints added
• 0.2.5
  - LIVE CD Extensions - Tutorial Chapter : filled missing sections - KDevelop Chapter : filled missing sections - new environment scripts - appendix in new files (cdscriptapp.sgml, odevscriptapp.sgml)
• 0.2.4
  - Opie Alarmserver usage and syslog usage (Opie Tutorial)
• 0.2.3
  - DeveloperCD using cloop-Device (emb, ipaq and sharp)
• 0.2.2
  - minor bugfixes and extensions
• 0.2.1a
  - Opie-build developer : forgot config.in
  
• 0.2.1
  - opie distribution chapter startet
  chapter structure definition
  build system explanation
  - ipkg_kdev addon added
• 0.2.0
  - qvfb
  - kdevlop startet
  

2.3 Document related downloads

• everything except toolchains
  http://www.uv-ac.de/opiedev/opiedev_all_0.2.7.tgz approx. 1200kByte.
  

Documents

• the sgml source
  http://www.uv-ac.de/opiedev/opiedev_sgml_0.2.7.tgz approx. 300kByte.
  
• the html version
  http://www.uv-ac.de/opiedev/opiedev_html_0.2.7.tgz approx. 300kByte.
  

Addons

• additional arm libs/includes for opie use (familiar-0.6.2, opie-1.0.2)
  http://www.uv-ac.de/opiedev/addtchn_opie_0.1.1_arm.tgz approx. 500kByte.
  
• kdevelop ipk creation addons
  http://www.uv-ac.de/opiedev/ipkg_kdev_0.4.0.tgz approx. 1kByte.
  

Scripts

• enviroment scripts
  http://www.uv-ac.de/opiedev/envscripts_0.2.0.tgz approx. 10kByte.
  
• automated qte- and opie build scripts
  http://www.uv-ac.de/opiedev/comscripts_0.1.6.tgz approx. 10kByte.
  
• Live-CD scripts
  http://www.uv-ac.de/opiedev/cdscripts_0.2.3.tgz approx. 10kByte.
  

Toolchains

• SharpZaurus Toolkit (my favourite)
  http://www.zaurus.com/dev/tools/other.htm.
• Open Zaurus Toolkits
  http://openzaurus.org/official/toolchain/.
• Handhelds.org toolchains
  http://handhelds.org/download/toolchain/.
• Suse CrossToolchain
  ftp://ftp.suse.com/pub/suse/i386/7.3/suse/d4/.

2.4 Usefull Links

• Handhelds.org (start page for familiar and opie related items)
  http://www.handhelds.org.
• Handhelds.org opie (start page opie related items)
  http://opie.handhelds.org.
• Handhelds.org opiedev (development CD site)
  http://www.handhelds.org/pub/linux/dists/opiedev.
• Trolltech (QT and related products)
  http://www.trolltech.com.
• Sharp Zaurus page
  http://www.zaurus.com.

still to be extended

2.5 Document Roadmap

This chapter describes the foreseen roadmap of this document. It depends on the time I am able to invest into the document, whether the timing is possible or has to be extended.

• 0.2.0 - Aug 2003
  Finalize the chapters "Getting started" and "Quick starter". Finalize the chapter "Live CD" Start a kdevelop chapter. Work on the kdevelop chapter.
• 0.4.0 - Nov 2003
  Based on that finalize the "Tutorial" chapter.
• 0.6.0 - Feb 2004
  Finalize the "GuideLines" chapter. This will take some time, as I am not yet experienced in this. If you want to help, send me information.
• 0.8.0 - Apr 2004
  first final version
• 1.0.0 - July 2004
  Final version (also available as a Latex version ?).