WebOS Internals - User contributions [en]

Application:Navit

2010-07-12T00:44:24Z

Tmandry: /* Summery */ Summary

[[Category:SDL]]

== Summary ==

[[Image:Navit_icon.png|50px|left]]
Navit is an open source (GPL) car navigation software for Linux systems. It will display your position on a map (in bird-view mode or as a 3D "visualization") from GPS sensor data, and can provide precise route calculation, touch screen functionality and supports Points of Interest (POI), which can be extended via an easy to use plugin system. Unlike other navigation systems, Navit maps are dynamically generated in real time from vector data. Information about Navit can be found [http://wiki.navit-project.org/index.php/Main_Page on the Navit wiki].

'''Note''' : '''there is a french translation for the english Navit wiki page here : http://www.webos-internals.org/index.php?title=Application:Navit-FR'''

== Where do you get the latest ALPHA version of Navit for WeobOS 1.4.1 ? ==

HaPe and noradtux have put this ALPHA version into a zip file all for you to enjoy, test, curse, and provide feedback at
http://forums.precentral.net/webos-internals/224609-navit-pre.html

'''Attention: This packages only work with webos < 1.4.5 . A version for 1.4.5 and above will be in Preware when finished.'''

You get the zip file for webos < 1.4.5 here => [http://www.hp-jochmann.de/Download.nsf/Download?OpenAgent&doc=37B8A6BE782A7E04C1257702006A6DCD Navit Alpha]

'''Attention: This packages only work with webos < 1.4.5 . A version for 1.4.5 and above will be in Preware when finished.'''

As instructed by HaPe you install it onto your Pre by,

# The zip file contains a navit ipk, a espeak ipk and some locale ipks. The easy way to install is by using WebOSQuickInstall found here http://forums.precentral.net/canuck-software/228310-webos-quick-install-v3-14-a.html . Note Preware install method is not yet available, its promised in the future once the Palm PDK is officially released. If you have old versions of navit and espeak then use Preware or WebOSQuickInstall to delete them, although the locale ipk could be left alone.
# You need to install at least the navit and the espeak ipk. You will see an Icon for both Navit and espeak (press it first and you get a speech to confirm it works!)
# The default of the Navit menus and speak output is English. To get a other local language working you need to install the locale ipk for your lang/county. I made some small once with only one lang_COUNTRY combination and one big with all I have. Only use the all one if you can not find a matching other, as the installed size is about 64MB for the all one. ONLY INSTALL ONE LOCAL IPK AT THE TIME!!!!!! '''At the moment there is a bug when you remove an locale ipk. One symbolic link is not removed. You need to do this manually by executing the following commands from novterm or from the WOQI command line:
## mount -o remount,rw /
## rm /usr/lib/locale
## mount -o remount,ro /'''
# You also need a map. Go to http://maps.navit-project.org/download/ and create one of the part of the world you need or look for created maps here => http://wiki.navit-project.org/index.php/OpenStreetMaps Connect your Pre in USB mode, create a folder named MapsNavit and put the *.bin file into it. ''Note I (PreRunr) have found that small is better (faster processing) and that the Cloudmade maps can have problems so use the extractor version first. Many POIs seems to stuff it up so CHOOSE the T@H display option if your screen locks up and requires a restart - hopefully our experts will fix this up in later versions.''
# To switch between the three skins you need to open the navit.xml in .app-storage/file_.media.cryptofs.apps.usr.palm.applications.org.webosinternals.navit_0/ . At the button you find the section where the skin is included. Remove the comment makers "" from the skin you plan to use and add them to the current skin.
# Try it out!
# Look at .app-storage/file_.media.cryptofs.apps.usr.palm.applications.org.webosinternals.navit_0/navit.log on you USB drive if Navit is not working as expected. If Navit has problems it writes the information into this log file.

== Where do you get the latest version of Navit for WeobOS 1.4.5 and above ? ==

# Open Preware. Select available applications. Then type 'Navit' and install as any other WebOS application.
# This will automatically install two other needed packages if you not have installed them. The packages are 'speechd' and 'locale'.
# You settings are migrated if you had installed the Navit Alpha before. Then you can skip step 4-8 the rest.
# Now start Navit. You will see the OSD but no map as this will be installed in the next step. This first start will create the default settings and the emty folder for the map.
# Quit Navit and connect your Pre to your PC in USB mode.
# You also need a map. Go to http://maps.navit-project.org/download/ and create one of the part of the world you need or look for created maps here => http://wiki.navit-project.org/index.php/OpenStreetMaps ''Note I (PreRunr) have found that small is better (faster processing) and that the Cloudmade maps can have problems so use the extractor version first.''
# Put the *.bin file into the folder appdata/org.webosinternals.navit/maps on the USB drive of your Pre.
# To switch between the three skins you need to open the navit.xml in appdata/org.webosinternals.navit/ . At the button you find the section where the skin is included. Remove the comment makers "" from the skin you plan to use and add them to the current skin.
# Try it out!
# Look at appdata/org.webosinternals.navit/navit.log on you USB drive if Navit is not working as expected. If Navit has problems it writes the information into this log file.

If you have any questions about this version then you can find help here => http://forums.precentral.net/webos-internals/254622-navit-3d-car-navigation-system.html

== Using Map&Guide maps ==

For all Europe uses. You can get a good Mapset from Amazon for 5 Euro => [http://www.amazon.de/Marco-Polo-Gro%C3%9Fer-Reiseplaner-DVD-ROM/dp/3829731426/ Marco Polo Großer Reiseplaner 2007/2008 (DVD-ROM) auf Amazon.de]

The disadvantage is that the complete map is 3GB, if you only take Germany and the Major roots of Europe it is still 1GB.

'''For Linux'''
# Change directory to where DVD is mounted
# Unpack data2.cab with: unshield x travel/data2.cab
# Now, you should get a directory named like DIRLAN_GER.
# Inside you find the maps...
'''For Windows'''
# Install the appliaction
# you find the maps in a folder inside the program folder.

'''Installing the maps'''
# The dem.map folder with all the majors roads and towns of Europe...
# ...and five smpX.smp folders, which contain the details of countries:
* smp1: DK,S,N,IS,FIN,N
* smp2: F,E,GBZ,P,AND,MC
* smp3: Germany
* smp4: CZ,SK,RSM,EST,GEO,LV,LT,MD,RUS,UA,BY,GR,H,I,RO,CH,A,PL,AL,MT,CY,BG,FL,SRB,MNE,HR,SLO,BIH,MK,TR,AZ,AM,V
* smp5: NL,B,GB,L,IRL
# copy the dem.map folder into a place on your hard drive
# remove all *d60* files from the dem.map folder
# copy the dem.map folder into /MaypsNavit on you usb drive
# copy the smpX.smp folder you need into /MaypsNavit/dem.map folder
# open appdata/org.webosinternals.navit/navit.xml and change the following:
<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/internal/appdata/org.webosinternals.navit/maps/*.bin"/>
</mapset>
to
<mapset enabled="yes">
<map type="binfile" enabled="yes" active="yes" data="/media/internal/appdata/org.webosinternals.navit/maps/osm/*.bin"/>
<map type="mg" enabled="yes" active="no" data="/media/internal/appdata/org.webosinternals.navit/maps/dem.map" />
<map type="mg" enabled="yes" active="no" data="/media/internal/appdata/org.webosinternals.navit/maps/dem.map/smp3.smp" />
</mapset>

Now you can switch between the OSM and the M&G maps from the settings/maps menu inside of Navit. The OSM map is the default. To make M&G the default you need to invert the active switches.

I would expect the the Map&Guide maps for other countries will also work. But you need to find a cheep Product that contains them.

If you have the m&g and the OSM maps on your USB drive then you can use the index from the m&g maps for searching and the OSM maps for routing and display. To do this you need to add the mapset this way:
<mapset enabled="yes">
<map type="mg" enabled="yes" active="no" data="/media/internal/appdata/org.webosinternals.navit/maps/dem.map/smp3.smp" />
<map type="mg" enabled="yes" active="no" data="/media/internal/appdata/org.webosinternals.navit/maps/dem.map" />
<map type="binfile" enabled="yes" active="yes" data="/media/internal/appdata/org.webosinternals.navit/maps/osm/*.bin"/>
</mapset>
It looks like Navit uses the street index of the first enabled map even if it is not active.

== Why don't I get the new skins we see below? ==

Navit only copies in the new XML files if the Navit.xml is not there. You need to delete the old ones to get the new.

You find the xml files on the USB drive J: (or another drive X: when your Pre is in USB mode (not charge only mode) depending upon your PC setup.

Located here J:/appdata/org.webosinternals.navit/

== Only as a start. Some images of the current skins: ==

Skin PreNav:

[[Image:PreNav-L.JPG]]
[[Image:PreNav-P.JPG]]

Skin Pre:

[[Image:Pre-P.jpg]]

Basic skin:

[[Image:Basic-P.jpg]]
'''

== How to get around the menus (not complete)''' ==

''As an aside the screen captures don't work on full screen - sorry.''

Main screen is seen here before GPS lock

[[Image:Start_screen.png]] (here the last saved GPS position is used to choose the starting map).

Press your finger on the screen and "push" the map around to get the desired location (where you are now or where you want to go) right into the centre of the screen (if you want to zoom into a location use the + button). Tap the screen and you will get the Main Menu shown here.

[[Image:Main_menu.png]]
Since we want to go somewhere tap on Actions.

[[Image:Actions_menu.png]]
Now you have a choice of the Location at the center of the map screen, the location of the car (no good here as GPS has not locked in), the Location of a saved Bookmark, or searching for a Location in your OSM or other map you have already loaded into your Pre at /media/NavitMaps/. Choosing Town we get this screen.

[[Image:Town_view.png]]
Now unless you live in the USA you can now enter a town. If not tap on the US flag and you should get this screen.

[[Image:Town_view2.png]]
Now Type in your country eg Au will give at least two countries to choose from. Select one and you will then get to enter a town, the street and then house. Lots of times this does not work too well as the House numbering is not available. In this case follow instructions below on How to Plan a Route.

OK I have told NAVIT that I wish to go to my new destination and now its ready to go.

[[Image:Navit_OK_to_drive.png]]

It shows the way to go as a BIG FAT BLUE line as well as speaking the directions. If you want to read the directions Chooose Route then Description. The voice reads these out as you go along the route. Now Rod Whitby can guess where I live.

Helpful notes from vreihen on 18 and 26 May 2010 now follow,

== On starting up issues ie '''why the map layer isn't loading?''' ==

When Navit first starts up, it uses the north pole as it's initial position (if I recall correctly) until it gets an initial GPS fix. Your map layer problem may be that the GPS point is still at the north pole, or perhaps outside of the map that you have installed. If you tap on the center of the screen and tap on actions, there will be an icon of a car and an icon of a globe. The car icon is your current position, and should contain a non-zero latitude and longitude if your GPS is working and has a fix. Verify that those coordinates are where you are located before you dig any deeper into the maps as the cause of the missing layer.

The information panels at the bottom of the screen are only populated when Navit is navigating between two points. Otherwise, they should be blank.

If all else fails with the maps, you could download the entire planet.bin if you have 3.5 gigs of free USB flash space in your phone to eliminate the map file as the cause of your problem.....

== On '''how to plan a route''' ==

1) Scroll through the map until you can see the location that you want to drive to.

2) Zoom in tight on the screen, if necessary. Tap on your destination on the map.

3) When Navit opens it's main menu, tap on actions.

4) The car icon should show your current latitude/longitude. (Just saying)

5) The globe icon should show the destination latitude/longitude that you tapped on the map.

6) Tap on the globe icon.

7) From the menu that pops up, select either bookmark this location (recommended) or navigate to this location.

8) If you chose to bookmark it, tap actions | bookmarks, then tap your bookmark. Select navigate to this location.

9) Depending on the distance you asked it to go, Navit should pop up the first driving direction and speak it to you within 5-10 seconds.

The OSM map data apparently does not contain the concept of a state, so navigating by state/city/street lookup is difficult to impossible. Navigating by bookmark on the map is the only option for the time being.....

''' Changing The Starting position'''

You might want to change the starting position of navit, especially if you are using Navit without a GPS. You can get your coordinates here: http://itouchmap.com/latlong.html

You can change the starting position in navit.xml, here :

<navit gui="..." graphics="..." center="4808 N 1134 E" zoom="128" >

The latitude and longitude are written as multiplied by 100, i.e. you won't see the decimal point. For example, instead of 48.08, enter 4808.

== So you want Miles not km? ==

NAVIT has this link http://trac.navit-project.org/ticket/12

WebOS Internals PDK

2010-07-11T02:05:51Z

Tmandry: /* Prequisites */ Fixed name, added texinfo

[[Category: SDL]]
Palm's binary sdk the "Plugin Developer Kit" became available to all developers in March 2010.

In addition to the PDK, WebOS Internals has released a full "WIDK" (WebOS Internals Development Kit) for you using Scratchbox2.

We ''strongly'' urge the community to standardize on this WIDK. It uses the same underlying technologies, and is entirely open.

Scratchbox 2 is a cross-compilation engine, it can be used to create a highly flexible SDK.

As installed below, the install process uses a script which extracts the required Palm provided files from a copy of webos doctor, and downloads from other sources, and builds a complete compilation environment automatically which can compile SDL and openGLES apps for webOS.

SB2 ''itself'' is totally distribution neutral but the webOS cross-compile environment is designed and tested on Ubuntu 9.10 32 bit. (At least one user in #webos-internals reports complete success running the cross compile environment in Ubuntu 9.10 64 bit after installing curl via apt-get.) See [[WebOS_Internals_PDK_on_Mandriva]] if you want to run it on Mandriva and are willing to support that yourself and not ask WebOS Internals any questions about it. Otherwise, use the recommended OS.

The webOS Internals team ''strongly suggest'' apt-get install into that environment only for this purpose. The same installation of Sun Virtualbox which hosts the Palm SDK emulator can host an Ubuntu 9.10 server with very little effort.

Developers wanting to work in an open environment 'without' SB2 can consider using the [[PuffTheMagic NDK]].

==SB2 Homepage==
[http://www.freedesktop.org/wiki/Software/sbox2 http://www.freedesktop.org/wiki/Software/sbox2]pdk

==License==
Scratchbox 2 is distributed under LGPL version 2.1, portions are under GPL version 2. Some minor stuff is under MIT style license.

== Installation on Ubuntu for WebOS PDK cross compiling ==

If setting up in a Virtual Box instance, it is recommended that you first complete the openSSH config as described in the VirtualBox tips for Windows users to the right. This is helpful even with a Linux host, as SSH into the PDK Virtual Machine will allow copy and paste of the commands listed below and reduce errors.

<div style="float:right; clear:right; width:30%">{{Ubuntu_VM_notes_for_Windows_users}}</div>
===Toolchain===

===Prerequisites===
Your Ubuntu installation will need the following installed. If you do not have them, run the command after the package name. You can test if they are found by just typing the command name. If it says command not found, you need to install it.

{| border="1"
|+
|'''git''' || sudo apt-get install git-core
|-
|'''gcc''' || sudo apt-get install build-essential
|-
|'''curl''' || sudo apt-get install curl
|-
|'''unzip'''|| sudo apt-get install unzip
|-
|'''autoconf'''|| sudo apt-get install autoconf
|-
|'''subversion'''|| sudo apt-get install subversion
|-
|'''libtool'''|| sudo apt-get install libtool
|-
|'''wget'''|| sudo apt-get install wget
|-
|'''pkg-config'''|| sudo apt-get install pkg-config
|-
|'''gettext'''|| sudo apt-get install gettext
|-
|'''fakeroot'''|| sudo apt-get install fakeroot
|-
|'''javac'''|| sudo apt-get install sun-java6-jdk
|-
|'''ant'''|| sudo apt-get install ant
|-
|'''xsltproc'''|| sudo apt-get install xsltproc
|-
|'''intltool'''|| sudo apt-get install intltool
|-
|'''mkimage'''|| sudo apt-get install uboot-mkimage
|-
|'''lsdiff'''|| sudo apt-get install patchutils
|-
|'''flex'''|| sudo apt-get install flex
|-
|'''bison'''|| sudo apt-get install bison
|-
|'''libssl-dev'''|| sudo apt-get install libssl-dev
|-
|'''libz-dev'''|| sudo apt-get install libz-dev
|-
|'''libbz2-dev'''|| sudo apt-get install libbz2-dev
|-
|'''xar'''|| sudo apt-get install xar
|-
|'''help2man'''|| sudo apt-get install help2man
|-
|'''texinfo'''|| sudo apt-get install texinfo
|}

* it has been reported that sun-java6-jdk isn't necessary

If you're uncertain at all, just cut and paste the following. If they are already installed, they'll be skipped.

sudo apt-get install git-core build-essential curl unzip autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison libssl-dev libz-dev libbz2-dev xar help2man texinfo

'''Note:''' If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.<BR>
Use these 2 command line :<BR>
Update repositories :
sudo aptitude update
And next, update the packages :
sudo aptitude safe-upgrade

If you're on a 64-bit system, you will also need to install the ia32-libs package.

'''Note:''' The ''make toolchain'' command and later steps will download approximately a half-gig of tools and sources from various locations. Do not start this if you do not have time for a large download. Additionally, if you already have downloaded a copy of the correct version of the WebOS doctor, you can reduce the download time by copying the doctor file into cross-compile/doctors/ with the correct name. This will cause the appropriate command to skip that download. Note that codesourcery rate limts downloads and at a minimum this process will take 10 to 15 minutes irrespective of your connection speed.

====Start setup====
Create a preware folder, copy the cross-compile tools into it (if you have not installed git, apt-get install git-core), and use a make script to begin the set up of the compilation toolchain.

sudo mkdir -p /srv/preware
cd /srv/preware
sudo chmod 777 .
git clone git://git.webos-internals.org/preware/cross-compile.git
cd cross-compile
make toolchain

====Fix mmap errors====
The following commands appear redundant. They are not. The install this fixes your mmap config to fix an mmap: permission denied error, but we don't need the package itself.

sudo apt-get install qemu-arm-static
sudo apt-get remove qemu-arm-static

: <span style="font-size:150%">OR</span> As a workaround, if this package is not available,
::: the following commands can be executed in a root shell (sudo -s) to fix the mmap configuration to enable qemu-arm to work.

echo "vm.mmap_min_addr = 4096" > /etc/sysctl.d/mmap_min_addr.conf
/etc/init.d/procps restart

(note that the value should not be "0". 4096 is chosen to avoid null pointer attacks.)

====Verify sh shell====
On Ubuntu /bin/sh is a symbolic link to dash. This will cause errors with the make stage command below, as some of the scripts assume bash. Run the following command to see what shell sh is linked to.

ls -l /bin/sh

If the result is a link to dash:

lrwxrwxrwx 1 root root 4 2010-07-06 23:55 /bin/sh -> dash

You will want to correct it with the following:

sudo dpkg-reconfigure dash

You will be asked if you want to "Install dash as /bin/sh?". Select "<No>" and bash will be used. Rerun the command to verify:

ls -l /bin/sh

You should now see:

lrwxrwxrwx 1 root root 4 2010-07-09 21:12 /bin/sh -> bash

====Setup Scratchbox====
Now, use apt-get to setup scratchbox...

sudo apt-get install scratchbox2 qemu-kvm-extras

...and set it up for compiling for webOS.

cd /srv/preware/cross-compile/toolchain/arm-2007q3/arm-none-linux-gnueabi/libc
PATH=/srv/preware/cross-compile/toolchain/arm-2007q3/bin:${PATH} sb2-init -c /usr/bin/qemu-arm armv7 arm-none-linux-gnueabi-gcc
cd /srv/preware/cross-compile

Then:

make stage

Once this setup is complete, compiling sdl apps for webOS is very simple.

==Errors during make stage (Feb 27 8:45 UTC)==
Confirmed by 2 people:
===Ecore===
*TRUE and FALSE are not defined

Manually add the definition:

#ifndef TRUE
# define TRUE 1
#endif

#ifndef FALSE
# define FALSE 0
#endif

===/bin/sh errors===
If you are getting a "bad fd number" or other /bin/sh error, make sure your /bin/sh points to bash, not another shell (such as dash.)

Go back through the Verify sh shell section above to correct.

==Sample build of [[Application:Doom]]==

Now, go to [[Building DOOM with scratchbox2]] and follow the simple directions.

==In Process Enhancements==
[[Extracting the PDK on Linux]]

WebOS Internals PDK

2010-07-03T20:21:29Z

Tmandry: /* Prequisites */

[[Category: SDL]]
Palm's binary sdk the "Plugin Developer Kit" became available to all developers in March 2010.

In addition to the PDK, WebOS Internals has released a full "WIDK" (WebOS Internals Development Kit) for you using Scratchbox2.

We ''strongly'' urge the community to standardize on this WIDK. It uses the same underlying technologies, and is entirely open.

Scratchbox 2 is a cross-compilation engine, it can be used to create a highly flexible SDK.

As installed below, the install process uses a script which extracts the required Palm provided files from a copy of webos doctor, and downloads from other sources, and builds a complete compilation environment automatically which can compile SDL and openGLES apps for webOS.

SB2 ''itself'' is totally distribution neutral but the webOS cross-compile environment is designed and tested on Ubuntu 9.10 32 bit. (At least one user in #webos-internals reports complete success running the cross compile environment in Ubuntu 9.10 64 bit after installing curl via apt-get.) See [[WebOS_Internals_PDK_on_Mandriva]] if you want to run it on Mandriva and are willing to support that yourself and not ask WebOS Internals any questions about it. Otherwise, use the recommended OS.

The webOS Internals team ''strongly suggest'' apt-get install into that environment only for this purpose. The same installation of Sun Virtualbox which hosts the Palm SDK emulator can host an Ubuntu 9.10 server with very little effort.

Developers wanting to work in an open environment 'without' SB2 can consider using the [[PuffTheMagic NDK]].

==SB2 Homepage==
[http://www.freedesktop.org/wiki/Software/sbox2 http://www.freedesktop.org/wiki/Software/sbox2]pdk

==License==
Scratchbox 2 is distributed under LGPL version 2.1, portions are under GPL version 2. Some minor stuff is under MIT style license.

== Installation on Ubuntu for WebOS PDK cross compiling ==
<div style="float:right; clear:right; width:30%">{{Ubuntu_VM_notes_for_Windows_users}}</div>
===Toolchain===

===Prequisites===
Your Ubuntu installation will need the following installed. If you do not have them, run the command after the package name. You can test if they are found by just typing the command name. If it says command not found, you need to install it.

{| border="1"
|+
|'''git''' || sudo apt-get install git-core
|-
|'''gcc''' || sudo apt-get install build-essential
|-
|'''curl''' || sudo apt-get install curl
|-
|'''unzip'''|| sudo apt-get install unzip
|-
|'''autoconf'''|| sudo apt-get install autoconf
|-
|'''subversion'''|| sudo apt-get install subversion
|-
|'''libtool'''|| sudo apt-get install libtool
|-
|'''wget'''|| sudo apt-get install wget
|-
|'''pkg-config'''|| sudo apt-get install pkg-config
|-
|'''gettext'''|| sudo apt-get install gettext
|-
|'''fakeroot'''|| sudo apt-get install fakeroot
|-
|'''javac'''|| sudo apt-get install sun-java6-jdk
|-
|'''ant'''|| sudo apt-get install ant
|-
|'''xsltproc'''|| sudo apt-get install xsltproc
|-
|'''intltool'''|| sudo apt-get install intltool
|-
|'''mkimage'''|| sudo apt-get install uboot-mkimage
|-
|'''lsdiff'''|| sudo apt-get install patchutils
|-
|'''flex'''|| sudo apt-get install flex
|-
|'''bison'''|| sudo apt-get install bison
|-
|'''libssl-dev'''|| sudo apt-get install libssl-dev
|-
|'''libz-dev'''|| sudo apt-get install libz-dev
|-
|'''libbz2-dev'''|| sudo apt-get install libbz2-dev
|-
|'''xar'''|| sudo apt-get install xar
|-
|'''help2man'''|| sudo apt-get install help2man
|}

*** it has been reported that sun-java6-jdk isn't necessary ***

If you're uncertain at all, just cut and paste the following. If they are already installed, they'll be skipped.

sudo apt-get install git-core build-essential curl unzip autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison libssl-dev libz-dev libbz2-dev xar help2man

'''Note:''' If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.<BR>
Use these 2 command line :<BR>
Update repositories :
sudo aptitude update
And next, update the packages :
sudo aptitude safe-upgrade

If you're on a 64-bit system, you will also need to install the ia32-libs package.

'''Note:''' The ''make toolchain'' command and later steps will download approximately a half-gig of tools and sources from various locations. Do not start this if you do not have time for a large download. Additionally, if you already have downloaded a copy of the correct version of the WebOS doctor, you can reduce the download time by copying the doctor file into cross-compile/doctors/ with the correct name. This will cause the appropriate command to skip that download. Note that codesourcery rate limts downloads and at a minimum this process will take 10 to 15 minutes irrespective of your connection speed.

====Start setup====
Create a preware folder, copy the cross-compile tools into it (if you have not installed git, apt-get install git-core), and use a make script to begin the set up of the compilation toolchain.

sudo mkdir -p /srv/preware
cd /srv/preware
sudo chmod 777 .
git clone git://git.webos-internals.org/preware/cross-compile.git
cd cross-compile
make toolchain

====Fix mmap errors====
The following commands appear redundant. They are not. The install this fixes your mmap config to fix an mmap: permission denied error, but we don't need the package itself.

sudo apt-get install qemu-arm-static
sudo apt-get remove qemu-arm-static

: <span style="font-size:150%">OR</span> As a workaround, if this package is not available,
::: the following commands can be executed in a root shell (sudo -s) to fix the mmap configuration to enable qemu-arm to work.

echo "vm.mmap_min_addr = 4096" > /etc/sysctl.d/mmap_min_addr.conf
/etc/init.d/procps restart

(note that the value should not be "0". 4096 is chosen to avoid null pointer attacks.)

====Setup Scratchbox====
Now, use apt-get to setup scratchbox...

sudo apt-get install scratchbox2 qemu-kvm-extras

...and set it up for compiling for webOS.

cd /srv/preware/cross-compile/toolchain/arm-2007q3/arm-none-linux-gnueabi/libc
PATH=/srv/preware/cross-compile/toolchain/arm-2007q3/bin:${PATH} sb2-init -c /usr/bin/qemu-arm armv7 arm-none-linux-gnueabi-gcc
cd /srv/preware/cross-compile

Then:

make stage

Once this setup is complete, compiling sdl apps for webOS is very simple.

==Errors during make stage (Feb 27 8:45 UTC)==
Confirmed by 2 people:
===Ecore===
*TRUE and FALSE are not defined

Manually add the definition:

#ifndef TRUE
# define TRUE 1
#endif

#ifndef FALSE
# define FALSE 0
#endif

===/bin/sh errors===
If you are getting a "bad fd number" or other /bin/sh error, make sure your /bin/sh points to bash, not another shell (such as dash.)

==Sample build of [[Application:Doom]]==

Now, go to [[Building DOOM with scratchbox2]] and follow the simple directions.

==In Process Enhancements==
[[Extracting the PDK on Linux]]

WebOS Internals PDK

2010-06-22T19:21:36Z

Tmandry: /* Errors during make stage (Feb 27 8:45 UTC) */

[[Category: SDL]]
Palm's binary sdk the "Plugin Developer Kit" became available to all developers in March 2010.

In addition to the PDK, WebOS Internals has released a full "WIDK" (WebOS Internals Development Kit) for you using Scratchbox2.

We ''strongly'' urge the community to standardize on this WIDK. It uses the same underlying technologies, and is entirely open.

Scratchbox 2 is a cross-compilation engine, it can be used to create a highly flexible SDK.

As installed below, the install process uses a script which extracts the required Palm provided files from a copy of webos doctor, and downloads from other sources, and builds a complete compilation environment automatically which can compile SDL and openGLES apps for webOS.

SB2 ''itself'' is totally distribution neutral but the webOS cross-compile environment is designed and tested on Ubuntu 9.10 32 bit. (At least one user in #webos-internals reports complete success running the cross compile environment in Ubuntu 9.10 64 bit after installing curl via apt-get.) See [[WebOS_Internals_PDK_on_Mandriva]] if you want to run it on Mandriva and are willing to support that yourself and not ask WebOS Internals any questions about it. Otherwise, use the recommended OS.

The webOS Internals team ''strongly suggest'' apt-get install into that environment only for this purpose. The same installation of Sun Virtualbox which hosts the Palm SDK emulator can host an Ubuntu 9.10 server with very little effort.

Developers wanting to work in an open environment 'without' SB2 can consider using the [[PuffTheMagic NDK]].

==SB2 Homepage==
[http://www.freedesktop.org/wiki/Software/sbox2 http://www.freedesktop.org/wiki/Software/sbox2]pdk

==License==
Scratchbox 2 is distributed under LGPL version 2.1, portions are under GPL version 2. Some minor stuff is under MIT style license.

== Installation on Ubuntu for WebOS PDK cross compiling ==
<div style="float:right; clear:right; width:30%">{{Ubuntu_VM_notes_for_Windows_users}}</div>
===Toolchain===

===Prequisites===
Your Ubuntu installation will need the following installed. If you do not have them, run the command after the package name. You can test if they are found by just typing the command name. If it says command not found, you need to install it.

{| border="1"
|+
|'''git''' || sudo apt-get install git-core
|-
|'''gcc''' || sudo apt-get install build-essential
|-
|'''curl''' || sudo apt-get install curl
|-
|'''unzip'''|| sudo apt-get install unzip
|-
|'''autoconf'''|| sudo apt-get install autoconf
|-
|'''subversion'''|| sudo apt-get install subversion
|-
|'''libtool'''|| sudo apt-get install libtool
|-
|'''wget'''|| sudo apt-get install wget
|-
|'''pkg-config'''|| sudo apt-get install pkg-config
|-
|'''gettext'''|| sudo apt-get install gettext
|-
|'''fakeroot'''|| sudo apt-get install fakeroot
|-
|'''javac'''|| sudo apt-get install sun-java6-jdk
|-
|'''ant'''|| sudo apt-get install ant
|-
|'''xsltproc'''|| sudo apt-get install xsltproc
|-
|'''intltool'''|| sudo apt-get install intltool
|-
|'''mkimage'''|| sudo apt-get install uboot-mkimage
|-
|'''lsdiff'''|| sudo apt-get install patchutils
|-
|'''flex'''|| sudo apt-get install flex
|-
|'''bison'''|| sudo apt-get install bison
|}

*** it has been reported that sun-java6-jdk isn't necessary ***

If you're uncertain at all, just cut and paste the following. If they are already installed, they'll be skipped.

sudo apt-get install git-core build-essential curl unzip autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison

'''Note:''' If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.<BR>
Use these 2 command line :<BR>
Update repositories :
sudo aptitude update
And next, update the packages :
sudo aptitude safe-upgrade

If you're on a 64-bit system, you will also need to install the ia32-libs package.

'''Note:''' The ''make toolchain'' command and later steps will download approximately a half-gig of tools and sources from various locations. Do not start this if you do not have time for a large download. Additionally, if you already have downloaded a copy of the correct version of the WebOS doctor, you can reduce the download time by copying the doctor file into cross-compile/doctors/ with the correct name. This will cause the appropriate command to skip that download. Note that codesourcery rate limts downloads and at a minimum this process will take 10 to 15 minutes irrespective of your connection speed.

====Start setup====
Create a preware folder, copy the cross-compile tools into it (if you have not installed git, apt-get install git-core), and use a make script to begin the set up of the compilation toolchain.

sudo mkdir -p /srv/preware
cd /srv/preware
sudo chmod 777 .
git clone git://git.webos-internals.org/preware/cross-compile.git
cd cross-compile
make toolchain

====Fix mmap errors====
The following commands appear redundant. They are not. The install this fixes your mmap config to fix an mmap: permission denied error, but we don't need the package itself.

sudo apt-get install qemu-arm-static
sudo apt-get remove qemu-arm-static

: <span style="font-size:150%">OR</span> As a workaround, if this package is not available,
::: the following commands can be executed in a root shell (sudo -s) to fix the mmap configuration to enable qemu-arm to work.

echo "vm.mmap_min_addr = 4096" > /etc/sysctl.d/mmap_min_addr.conf
/etc/init.d/procps restart

(note that the value should not be "0". 4096 is chosen to avoid null pointer attacks.)

====Setup Scratchbox====
Now, use apt-get to setup scratchbox...

sudo apt-get install scratchbox2 qemu-kvm-extras

...and set it up for compiling for webOS.

cd /srv/preware/cross-compile/toolchain/arm-2007q3/arm-none-linux-gnueabi/libc
PATH=/srv/preware/cross-compile/toolchain/arm-2007q3/bin:${PATH} sb2-init -c /usr/bin/qemu-arm armv7 arm-none-linux-gnueabi-gcc
cd /srv/preware/cross-compile

Then:

make stage

Once this setup is complete, compiling sdl apps for webOS is very simple.

==Errors during make stage (Feb 27 8:45 UTC)==
Confirmed by 2 people:
===Ecore===
*TRUE and FALSE are not defined

Manually add the definition:

#ifndef TRUE
# define TRUE 1
#endif

#ifndef FALSE
# define FALSE 0
#endif

===/bin/sh errors===
If you are getting a "bad fd number" or other /bin/sh error, make sure your /bin/sh points to bash, not another shell (such as dash.)

==Sample build of [[Application:Doom]]==

Now, go to [[Building DOOM with scratchbox2]] and follow the simple directions.

==In Process Enhancements==
[[Extracting the PDK on Linux]]

WebOS Internals PDK

2010-06-22T19:21:00Z

Tmandry: /* Errors during make stage (Feb 27 8:45 UTC) */ Better spacing

[[Category: SDL]]
Palm's binary sdk the "Plugin Developer Kit" became available to all developers in March 2010.

In addition to the PDK, WebOS Internals has released a full "WIDK" (WebOS Internals Development Kit) for you using Scratchbox2.

We ''strongly'' urge the community to standardize on this WIDK. It uses the same underlying technologies, and is entirely open.

Scratchbox 2 is a cross-compilation engine, it can be used to create a highly flexible SDK.

As installed below, the install process uses a script which extracts the required Palm provided files from a copy of webos doctor, and downloads from other sources, and builds a complete compilation environment automatically which can compile SDL and openGLES apps for webOS.

SB2 ''itself'' is totally distribution neutral but the webOS cross-compile environment is designed and tested on Ubuntu 9.10 32 bit. (At least one user in #webos-internals reports complete success running the cross compile environment in Ubuntu 9.10 64 bit after installing curl via apt-get.) See [[WebOS_Internals_PDK_on_Mandriva]] if you want to run it on Mandriva and are willing to support that yourself and not ask WebOS Internals any questions about it. Otherwise, use the recommended OS.

The webOS Internals team ''strongly suggest'' apt-get install into that environment only for this purpose. The same installation of Sun Virtualbox which hosts the Palm SDK emulator can host an Ubuntu 9.10 server with very little effort.

Developers wanting to work in an open environment 'without' SB2 can consider using the [[PuffTheMagic NDK]].

==SB2 Homepage==
[http://www.freedesktop.org/wiki/Software/sbox2 http://www.freedesktop.org/wiki/Software/sbox2]pdk

==License==
Scratchbox 2 is distributed under LGPL version 2.1, portions are under GPL version 2. Some minor stuff is under MIT style license.

== Installation on Ubuntu for WebOS PDK cross compiling ==
<div style="float:right; clear:right; width:30%">{{Ubuntu_VM_notes_for_Windows_users}}</div>
===Toolchain===

===Prequisites===
Your Ubuntu installation will need the following installed. If you do not have them, run the command after the package name. You can test if they are found by just typing the command name. If it says command not found, you need to install it.

{| border="1"
|+
|'''git''' || sudo apt-get install git-core
|-
|'''gcc''' || sudo apt-get install build-essential
|-
|'''curl''' || sudo apt-get install curl
|-
|'''unzip'''|| sudo apt-get install unzip
|-
|'''autoconf'''|| sudo apt-get install autoconf
|-
|'''subversion'''|| sudo apt-get install subversion
|-
|'''libtool'''|| sudo apt-get install libtool
|-
|'''wget'''|| sudo apt-get install wget
|-
|'''pkg-config'''|| sudo apt-get install pkg-config
|-
|'''gettext'''|| sudo apt-get install gettext
|-
|'''fakeroot'''|| sudo apt-get install fakeroot
|-
|'''javac'''|| sudo apt-get install sun-java6-jdk
|-
|'''ant'''|| sudo apt-get install ant
|-
|'''xsltproc'''|| sudo apt-get install xsltproc
|-
|'''intltool'''|| sudo apt-get install intltool
|-
|'''mkimage'''|| sudo apt-get install uboot-mkimage
|-
|'''lsdiff'''|| sudo apt-get install patchutils
|-
|'''flex'''|| sudo apt-get install flex
|-
|'''bison'''|| sudo apt-get install bison
|}

*** it has been reported that sun-java6-jdk isn't necessary ***

If you're uncertain at all, just cut and paste the following. If they are already installed, they'll be skipped.

sudo apt-get install git-core build-essential curl unzip autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison

'''Note:''' If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.<BR>
Use these 2 command line :<BR>
Update repositories :
sudo aptitude update
And next, update the packages :
sudo aptitude safe-upgrade

If you're on a 64-bit system, you will also need to install the ia32-libs package.

'''Note:''' The ''make toolchain'' command and later steps will download approximately a half-gig of tools and sources from various locations. Do not start this if you do not have time for a large download. Additionally, if you already have downloaded a copy of the correct version of the WebOS doctor, you can reduce the download time by copying the doctor file into cross-compile/doctors/ with the correct name. This will cause the appropriate command to skip that download. Note that codesourcery rate limts downloads and at a minimum this process will take 10 to 15 minutes irrespective of your connection speed.

====Start setup====
Create a preware folder, copy the cross-compile tools into it (if you have not installed git, apt-get install git-core), and use a make script to begin the set up of the compilation toolchain.

sudo mkdir -p /srv/preware
cd /srv/preware
sudo chmod 777 .
git clone git://git.webos-internals.org/preware/cross-compile.git
cd cross-compile
make toolchain

====Fix mmap errors====
The following commands appear redundant. They are not. The install this fixes your mmap config to fix an mmap: permission denied error, but we don't need the package itself.

sudo apt-get install qemu-arm-static
sudo apt-get remove qemu-arm-static

: <span style="font-size:150%">OR</span> As a workaround, if this package is not available,
::: the following commands can be executed in a root shell (sudo -s) to fix the mmap configuration to enable qemu-arm to work.

echo "vm.mmap_min_addr = 4096" > /etc/sysctl.d/mmap_min_addr.conf
/etc/init.d/procps restart

(note that the value should not be "0". 4096 is chosen to avoid null pointer attacks.)

====Setup Scratchbox====
Now, use apt-get to setup scratchbox...

sudo apt-get install scratchbox2 qemu-kvm-extras

...and set it up for compiling for webOS.

cd /srv/preware/cross-compile/toolchain/arm-2007q3/arm-none-linux-gnueabi/libc
PATH=/srv/preware/cross-compile/toolchain/arm-2007q3/bin:${PATH} sb2-init -c /usr/bin/qemu-arm armv7 arm-none-linux-gnueabi-gcc
cd /srv/preware/cross-compile

Then:

make stage

Once this setup is complete, compiling sdl apps for webOS is very simple.

==Errors during make stage (Feb 27 8:45 UTC)==
Confirmed by 2 people:
===Ecore===
*TRUE and FALSE are not defined

Manually add the definition:

#ifndef TRUE
# define TRUE 1
#endif

#ifndef FALSE
# define FALSE 0
#endif

===/bin/sh errors===
If you are getting a "bad fd number" or other /bin/sh error, make sure your /bin/sh points to bash, not another shell (such as dash.)

==Sample build of [[Application:Doom]]==

Now, go to [[Building DOOM with scratchbox2]] and follow the simple directions.

==In Process Enhancements==
[[Extracting the PDK on Linux]]

WebOS Internals PDK

2010-06-21T20:15:16Z

Tmandry: /* Errors during make stage (Feb 27 8:45 UTC) */

[[Category: SDL]]
Palm's binary sdk the "Plugin Developer Kit" became available to all developers in March 2010.

In addition to the PDK, WebOS Internals has released a full "WIDK" (WebOS Internals Development Kit) for you using Scratchbox2.

We ''strongly'' urge the community to standardize on this WIDK. It uses the same underlying technologies, and is entirely open.

Scratchbox 2 is a cross-compilation engine, it can be used to create a highly flexible SDK.

As installed below, the install process uses a script which extracts the required Palm provided files from a copy of webos doctor, and downloads from other sources, and builds a complete compilation environment automatically which can compile SDL and openGLES apps for webOS.

SB2 ''itself'' is totally distribution neutral but the webOS cross-compile environment is designed and tested on Ubuntu 9.10 32 bit. (At least one user in #webos-internals reports complete success running the cross compile environment in Ubuntu 9.10 64 bit after installing curl via apt-get.) See [[WebOS_Internals_PDK_on_Mandriva]] if you want to run it on Mandriva and are willing to support that yourself and not ask WebOS Internals any questions about it. Otherwise, use the recommended OS.

The webOS Internals team ''strongly suggest'' apt-get install into that environment only for this purpose. The same installation of Sun Virtualbox which hosts the Palm SDK emulator can host an Ubuntu 9.10 server with very little effort.

Developers wanting to work in an open environment 'without' SB2 can consider using the [[PuffTheMagic NDK]].

==SB2 Homepage==
[http://www.freedesktop.org/wiki/Software/sbox2 http://www.freedesktop.org/wiki/Software/sbox2]pdk

==License==
Scratchbox 2 is distributed under LGPL version 2.1, portions are under GPL version 2. Some minor stuff is under MIT style license.

== Installation on Ubuntu for WebOS PDK cross compiling ==
<div style="float:right; clear:right; width:30%">{{Ubuntu_VM_notes_for_Windows_users}}</div>
===Toolchain===

===Prequisites===
Your Ubuntu installation will need the following installed. If you do not have them, run the command after the package name. You can test if they are found by just typing the command name. If it says command not found, you need to install it.

{| border="1"
|+
|'''git''' || sudo apt-get install git-core
|-
|'''gcc''' || sudo apt-get install build-essential
|-
|'''curl''' || sudo apt-get install curl
|-
|'''unzip'''|| sudo apt-get install unzip
|-
|'''autoconf'''|| sudo apt-get install autoconf
|-
|'''subversion'''|| sudo apt-get install subversion
|-
|'''libtool'''|| sudo apt-get install libtool
|-
|'''wget'''|| sudo apt-get install wget
|-
|'''pkg-config'''|| sudo apt-get install pkg-config
|-
|'''gettext'''|| sudo apt-get install gettext
|-
|'''fakeroot'''|| sudo apt-get install fakeroot
|-
|'''javac'''|| sudo apt-get install sun-java6-jdk
|-
|'''ant'''|| sudo apt-get install ant
|-
|'''xsltproc'''|| sudo apt-get install xsltproc
|-
|'''intltool'''|| sudo apt-get install intltool
|-
|'''mkimage'''|| sudo apt-get install uboot-mkimage
|-
|'''lsdiff'''|| sudo apt-get install patchutils
|-
|'''flex'''|| sudo apt-get install flex
|-
|'''bison'''|| sudo apt-get install bison
|}

*** it has been reported that sun-java6-jdk isn't necessary ***

If you're uncertain at all, just cut and paste the following. If they are already installed, they'll be skipped.

sudo apt-get install git-core build-essential curl unzip autoconf subversion libtool wget pkg-config gettext fakeroot ant xsltproc intltool uboot-mkimage patchutils flex bison

'''Note:''' If you are a beginner with Ubuntu Linux Distribution, you should update all the packages on your system to avoid problems when you will compile.<BR>
Use these 2 command line :<BR>
Update repositories :
sudo aptitude update
And next, update the packages :
sudo aptitude safe-upgrade

If you're on a 64-bit system, you will also need to install the ia32-libs package.

'''Note:''' The ''make toolchain'' command and later steps will download approximately a half-gig of tools and sources from various locations. Do not start this if you do not have time for a large download. Additionally, if you already have downloaded a copy of the correct version of the WebOS doctor, you can reduce the download time by copying the doctor file into cross-compile/doctors/ with the correct name. This will cause the appropriate command to skip that download. Note that codesourcery rate limts downloads and at a minimum this process will take 10 to 15 minutes irrespective of your connection speed.

====Start setup====
Create a preware folder, copy the cross-compile tools into it (if you have not installed git, apt-get install git-core), and use a make script to begin the set up of the compilation toolchain.

sudo mkdir -p /srv/preware
cd /srv/preware
sudo chmod 777 .
git clone git://git.webos-internals.org/preware/cross-compile.git
cd cross-compile
make toolchain

====Fix mmap errors====
The following commands appear redundant. They are not. The install this fixes your mmap config to fix an mmap: permission denied error, but we don't need the package itself.

sudo apt-get install qemu-arm-static
sudo apt-get remove qemu-arm-static

: <span style="font-size:150%">OR</span> As a workaround, if this package is not available,
::: the following commands can be executed in a root shell (sudo -s) to fix the mmap configuration to enable qemu-arm to work.

echo "vm.mmap_min_addr = 4096" > /etc/sysctl.d/mmap_min_addr.conf
/etc/init.d/procps restart

(note that the value should not be "0". 4096 is chosen to avoid null pointer attacks.)

====Setup Scratchbox====
Now, use apt-get to setup scratchbox...

sudo apt-get install scratchbox2 qemu-kvm-extras

...and set it up for compiling for webOS.

cd /srv/preware/cross-compile/toolchain/arm-2007q3/arm-none-linux-gnueabi/libc
PATH=/srv/preware/cross-compile/toolchain/arm-2007q3/bin:${PATH} sb2-init -c /usr/bin/qemu-arm armv7 arm-none-linux-gnueabi-gcc
cd /srv/preware/cross-compile

Then:

make stage

Once this setup is complete, compiling sdl apps for webOS is very simple.

==Errors during make stage (Feb 27 8:45 UTC)==
Confirmed by 2 people:
===Ecore===
*TRUE and FALSE are not defined

Manually add the definition:

#ifndef TRUE
# define TRUE 1
#endif

#ifndef FALSE
# define FALSE 0
#endif

===/bin/sh errors===
If you are getting a "bad fd number" or other /bin/sh error, make sure your /bin/sh points to bash, not another shell (such as dash.)

==Sample build of [[Application:Doom]]==

Now, go to [[Building DOOM with scratchbox2]] and follow the simple directions.

==In Process Enhancements==
[[Extracting the PDK on Linux]]