WebOS Internals - User contributions [en]

WebOS Internals PDK

2010-07-10T01:23:04Z

Sacherjj: /* Verify sh shell */

[[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===

===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.)

====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-10T01:21:17Z

Sacherjj: /* Installation on Ubuntu for WebOS PDK cross compiling */

[[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===

===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.)

====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.

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 this 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-10T01:20:24Z

Sacherjj: /* Installation on Ubuntu for WebOS PDK cross compiling */

[[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 Ubuntu VM notes 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===

===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.)

====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.

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 this 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-10T01:16:10Z

Sacherjj: Added Verify sh shell section.

[[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.)

====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.

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 this 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-08T02:34:45Z

Sacherjj: /* /bin/sh errors */

[[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.)

On Ubuntu 9.10 Server, this can be corrected by running: sudo dpkg-reconfigure dash

You will be asked if you want to "Install dash as /bin/sh?". Select "<No>" and bash will be used. This should allow "make stage" to not get the "bad fd number" error.

==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]]

Application:Precorder

2009-12-01T19:32:17Z

Sacherjj: Updated First Screenshot

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.3.0 <br />(26 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-01-12_141733.png
|description=

== Summary ==

Precorder has been developed to bridge the gap between the current revision of WebOS and a future release that will enable video recording. It is capable of recording in multiple combinations of audio and video and includes support for using the built-in LED for lumination while recording in dark areas. Video recorded with Precorder is viewable through Palms built in video application.

== Status ==

Precorder is ALPHA SOFTWARE developed primarily by ZSoc of WebOS Internals with assistance from a number of other developers (as listed in the Maintainers field in the package metadata).

It does not have a viewfinder, cause we technically do not know how to do that (yet?).

== Recent Changes ==

Even though Precorder in alpha state is not available for download in Preware (it will be when it goes into beta), once you install Precorder it appears in the Installed Packages section and you can see the package changelogs there.

== Donations ==

Please see the official PreCentral thread first post at http://forums.precentral.net/2059462-post1.html for the donation link. Since this is a wiki that anyone can edit, we do not put the donation link here.

==Installation==

Note that you cannot install the packages using any other method than the methods below. Specifically, fileCoaster is not able to install these packages.

=== Preware ===

Precorder will be added to Preware once it reaches beta status. Until then, please use the Precorder bootstrap script.

=== Bootstrap Script ===

The easiest (and guaranteed to always be up to date) method of installing the latest packages via the precorder bootstrap script.

Just run the following two commands on your Pre. You can get a command line either via the Terminal application in Preware, or by an SSH connection, or by using the Linux commandline window in WebOS Quick Install. The precorder bootstrap can also be re-run at any time to safely update Precorder to the latest alpha testing version.

<br>
rm -f precorder-bootstrap
<br>
wget http://bit.ly/precorder-bootstrap
<br>
sh precorder-bootstrap

=== WebOS Quick Install ===

If you can't use the precorder bootstrap script for some reason, you can also use the following links to download the individual packages and install them with WebOS Quick Install. Note that these links will quickly get out of date, so please use the precorder bootstrap to always get the latest alpha testing version.

Note that to be able to use WebOS Quick Install to install Precorder, you must first have installed Preware on your device. See http://install.preware.org for instructions on how to do that. When Precorder reaches beta status, you will be able to install, update and remove the packages directly in Preware.

You can install the GstService ([http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.3.0_armv7.ipk Pre] or [http://ipkg.preware.org/feeds/webos-internals/testing/armv6/org.webosinternals.gstservice_0.3.0_armv6.ipk Pixi]) and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.3.0_all.ipk Precorder] ipkg files with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install]. (Note that these links may be out of date if we forget to update them every time we release a new version)

# Save the gstservice and and Precorder ipk's to your local computer.
# Install [[Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method|WebOS Quick Install]]
# Drag the gstservice IPK into the center of the WebOS Quick install window.
# Click the Install button.
# Drag the Precorder application ipk into the center of the WebOS Quick Install window.
# Click the install button.

== License ==

The GStreamer Service package is MIT Open Source licensed. The Precorder application is GPLv2 Open Source licensed.

== Operating notes ==

When precorder is first launched you will see the main screen. Only one button is currently functional. Tapping the 'Record Now' button will begin recording video to the /media/internal location on the pre making these videos available to be copied via USB. They will be located in the root of the USB drive when connected to your computer.
=== Viewfinder ===
Note that you are not able to see the video as it is recording. There is no viewfinder. It is currently technically infeasible to create a viewfinder (but maybe someone will work out how to do it). (For a description of why it is technically infeasible, and to make suggestions, ask questions, please see [http://www.webos-internals.org/wiki/Application_talk:Precorder#Viewfinder_discussion this section in the discussion page].)
=== Controls ===
When you tap the 'Record Now' button the screen will change to notify you that Precorder is currently capturing audio and video. There is a 'Stop recording' button located on the screen. Tapping this button stops the audio/video capture and returns you to the main view.
=== Customization ===
There are several features of Precorder that can be customized. All of these settings are available via the preferences option within the Precorder menu. The table below lists all possible preferences. Options in bold represent defaults.

<Table><TR><TD>
{{{!}} border="1" cellpadding="4"
{{!}}Option
{{!}}Description
{{!}}Possible Selections
{{!}}-
{{!}}Audio Format
{{!}}Select what format you would like the audio stream to be saved in.
{{!}}'''AAC''', AMRNB, MP3
{{!}}-
{{!}}Video Format
{{!}}Select what format you would like the video stream to be saved in.
{{!}}Mpeg-4, H.263, '''H.264/AVC'''
{{!}}-
{{!}}Container
{{!}}Select what multimedia container the audio/video streams will be in.
{{!}}'''mp4''', 3gp
{{!}}-
{{!}}Media Source
{{!}}What would you like Precorder to capture?
{{!}}Audio only, Video only, '''Both'''
{{!}}-
{{!}}Flash
{{!}}Would you like to use the built in LED for illumination?
{{!}}'''Off''', Low, Medium, High
{{!}}}
</TD></TR></Table>

=== Recent enhancements ===

'''0.3.0'''
*LED brightness now selectable
*Launch button added to launch video player
*Videos now are saved in /media/internal/video

'''0.2.3'''
*fixed css bug (correctly pushing the record button to the bottom of the screen)
*added icon for launcher

=== Known bugs ===

Precorder is currently in Alpha stages and as such is in a constant state of flux with new features being added and old functionality being modified. Please use this software at your own risk. Due to the alpha nature of the software, please check the discussion page for a more accurate list of bugs and/or feature requests.

*First run on any phone will cause a blank output.
**Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine.

*Getting the video light to work may cause 2 starts. Should be a 1-time-only process.
*2 minute limitation of recording. Once the video hits 2 minutes, the video data is lost and outputs a blank file.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder 2009-01-12 141733.png‎|alt=Precorder Main View|This is the initial view upon launching Precorder]]
[[Image:Precorder 2009-01-12 141738.png|alt=Precorder Recording View|This is the display during audio/video capture]]
[[Image:Precorder_2009-01-12_141805.png|alt=Precorder Preferences View|This is the preferences selection screen]]
[[Image:Precorder_2009-01-12_141742.png|alt=Precorder Finished Recording View|Button at top now allow opening the recorded file directly]]
[[Image:Launcher_2009-24-11_164206.png|alt=Palm OEM video app|All videos are viewable on the device via the Palm OEM video application]]

}}

Application:Precorder

2009-12-01T19:31:28Z

Sacherjj: Added Post Recording Screen Grab

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.3.0 <br />(26 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-24-11_164136.png
|description=

== Summary ==

Precorder has been developed to bridge the gap between the current revision of WebOS and a future release that will enable video recording. It is capable of recording in multiple combinations of audio and video and includes support for using the built-in LED for lumination while recording in dark areas. Video recorded with Precorder is viewable through Palms built in video application.

== Status ==

Precorder is ALPHA SOFTWARE developed primarily by ZSoc of WebOS Internals with assistance from a number of other developers (as listed in the Maintainers field in the package metadata).

It does not have a viewfinder, cause we technically do not know how to do that (yet?).

== Recent Changes ==

Even though Precorder in alpha state is not available for download in Preware (it will be when it goes into beta), once you install Precorder it appears in the Installed Packages section and you can see the package changelogs there.

== Donations ==

Please see the official PreCentral thread first post at http://forums.precentral.net/2059462-post1.html for the donation link. Since this is a wiki that anyone can edit, we do not put the donation link here.

==Installation==

Note that you cannot install the packages using any other method than the methods below. Specifically, fileCoaster is not able to install these packages.

=== Preware ===

Precorder will be added to Preware once it reaches beta status. Until then, please use the Precorder bootstrap script.

=== Bootstrap Script ===

The easiest (and guaranteed to always be up to date) method of installing the latest packages via the precorder bootstrap script.

Just run the following two commands on your Pre. You can get a command line either via the Terminal application in Preware, or by an SSH connection, or by using the Linux commandline window in WebOS Quick Install. The precorder bootstrap can also be re-run at any time to safely update Precorder to the latest alpha testing version.

<br>
rm -f precorder-bootstrap
<br>
wget http://bit.ly/precorder-bootstrap
<br>
sh precorder-bootstrap

=== WebOS Quick Install ===

If you can't use the precorder bootstrap script for some reason, you can also use the following links to download the individual packages and install them with WebOS Quick Install. Note that these links will quickly get out of date, so please use the precorder bootstrap to always get the latest alpha testing version.

Note that to be able to use WebOS Quick Install to install Precorder, you must first have installed Preware on your device. See http://install.preware.org for instructions on how to do that. When Precorder reaches beta status, you will be able to install, update and remove the packages directly in Preware.

You can install the GstService ([http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.3.0_armv7.ipk Pre] or [http://ipkg.preware.org/feeds/webos-internals/testing/armv6/org.webosinternals.gstservice_0.3.0_armv6.ipk Pixi]) and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.3.0_all.ipk Precorder] ipkg files with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install]. (Note that these links may be out of date if we forget to update them every time we release a new version)

# Save the gstservice and and Precorder ipk's to your local computer.
# Install [[Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method|WebOS Quick Install]]
# Drag the gstservice IPK into the center of the WebOS Quick install window.
# Click the Install button.
# Drag the Precorder application ipk into the center of the WebOS Quick Install window.
# Click the install button.

== License ==

The GStreamer Service package is MIT Open Source licensed. The Precorder application is GPLv2 Open Source licensed.

== Operating notes ==

When precorder is first launched you will see the main screen. Only one button is currently functional. Tapping the 'Record Now' button will begin recording video to the /media/internal location on the pre making these videos available to be copied via USB. They will be located in the root of the USB drive when connected to your computer.
=== Viewfinder ===
Note that you are not able to see the video as it is recording. There is no viewfinder. It is currently technically infeasible to create a viewfinder (but maybe someone will work out how to do it). (For a description of why it is technically infeasible, and to make suggestions, ask questions, please see [http://www.webos-internals.org/wiki/Application_talk:Precorder#Viewfinder_discussion this section in the discussion page].)
=== Controls ===
When you tap the 'Record Now' button the screen will change to notify you that Precorder is currently capturing audio and video. There is a 'Stop recording' button located on the screen. Tapping this button stops the audio/video capture and returns you to the main view.
=== Customization ===
There are several features of Precorder that can be customized. All of these settings are available via the preferences option within the Precorder menu. The table below lists all possible preferences. Options in bold represent defaults.

<Table><TR><TD>
{{{!}} border="1" cellpadding="4"
{{!}}Option
{{!}}Description
{{!}}Possible Selections
{{!}}-
{{!}}Audio Format
{{!}}Select what format you would like the audio stream to be saved in.
{{!}}'''AAC''', AMRNB, MP3
{{!}}-
{{!}}Video Format
{{!}}Select what format you would like the video stream to be saved in.
{{!}}Mpeg-4, H.263, '''H.264/AVC'''
{{!}}-
{{!}}Container
{{!}}Select what multimedia container the audio/video streams will be in.
{{!}}'''mp4''', 3gp
{{!}}-
{{!}}Media Source
{{!}}What would you like Precorder to capture?
{{!}}Audio only, Video only, '''Both'''
{{!}}-
{{!}}Flash
{{!}}Would you like to use the built in LED for illumination?
{{!}}'''Off''', Low, Medium, High
{{!}}}
</TD></TR></Table>

=== Recent enhancements ===

'''0.3.0'''
*LED brightness now selectable
*Launch button added to launch video player
*Videos now are saved in /media/internal/video

'''0.2.3'''
*fixed css bug (correctly pushing the record button to the bottom of the screen)
*added icon for launcher

=== Known bugs ===

Precorder is currently in Alpha stages and as such is in a constant state of flux with new features being added and old functionality being modified. Please use this software at your own risk. Due to the alpha nature of the software, please check the discussion page for a more accurate list of bugs and/or feature requests.

*First run on any phone will cause a blank output.
**Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine.

*Getting the video light to work may cause 2 starts. Should be a 1-time-only process.
*2 minute limitation of recording. Once the video hits 2 minutes, the video data is lost and outputs a blank file.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder 2009-01-12 141733.png‎|alt=Precorder Main View|This is the initial view upon launching Precorder]]
[[Image:Precorder 2009-01-12 141738.png|alt=Precorder Recording View|This is the display during audio/video capture]]
[[Image:Precorder_2009-01-12_141805.png|alt=Precorder Preferences View|This is the preferences selection screen]]
[[Image:Precorder_2009-01-12_141742.png|alt=Precorder Finished Recording View|Button at top now allow opening the recorded file directly]]
[[Image:Launcher_2009-24-11_164206.png|alt=Palm OEM video app|All videos are viewable on the device via the Palm OEM video application]]

}}

File:Precorder 2009-01-12 141742.png

2009-12-01T19:30:00Z

Sacherjj:

Application:Precorder

2009-12-01T19:27:41Z

Sacherjj: Updated Screengrabs to Newest Version

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.3.0 <br />(26 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-24-11_164136.png
|description=

== Summary ==

Precorder has been developed to bridge the gap between the current revision of WebOS and a future release that will enable video recording. It is capable of recording in multiple combinations of audio and video and includes support for using the built-in LED for lumination while recording in dark areas. Video recorded with Precorder is viewable through Palms built in video application.

== Status ==

Precorder is ALPHA SOFTWARE developed primarily by ZSoc of WebOS Internals with assistance from a number of other developers (as listed in the Maintainers field in the package metadata).

It does not have a viewfinder, cause we technically do not know how to do that (yet?).

== Recent Changes ==

Even though Precorder in alpha state is not available for download in Preware (it will be when it goes into beta), once you install Precorder it appears in the Installed Packages section and you can see the package changelogs there.

== Donations ==

Please see the official PreCentral thread first post at http://forums.precentral.net/2059462-post1.html for the donation link. Since this is a wiki that anyone can edit, we do not put the donation link here.

==Installation==

Note that you cannot install the packages using any other method than the methods below. Specifically, fileCoaster is not able to install these packages.

=== Preware ===

Precorder will be added to Preware once it reaches beta status. Until then, please use the Precorder bootstrap script.

=== Bootstrap Script ===

The easiest (and guaranteed to always be up to date) method of installing the latest packages via the precorder bootstrap script.

Just run the following two commands on your Pre. You can get a command line either via the Terminal application in Preware, or by an SSH connection, or by using the Linux commandline window in WebOS Quick Install. The precorder bootstrap can also be re-run at any time to safely update Precorder to the latest alpha testing version.

<br>
rm -f precorder-bootstrap
<br>
wget http://bit.ly/precorder-bootstrap
<br>
sh precorder-bootstrap

=== WebOS Quick Install ===

If you can't use the precorder bootstrap script for some reason, you can also use the following links to download the individual packages and install them with WebOS Quick Install. Note that these links will quickly get out of date, so please use the precorder bootstrap to always get the latest alpha testing version.

Note that to be able to use WebOS Quick Install to install Precorder, you must first have installed Preware on your device. See http://install.preware.org for instructions on how to do that. When Precorder reaches beta status, you will be able to install, update and remove the packages directly in Preware.

You can install the GstService ([http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.3.0_armv7.ipk Pre] or [http://ipkg.preware.org/feeds/webos-internals/testing/armv6/org.webosinternals.gstservice_0.3.0_armv6.ipk Pixi]) and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.3.0_all.ipk Precorder] ipkg files with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install]. (Note that these links may be out of date if we forget to update them every time we release a new version)

# Save the gstservice and and Precorder ipk's to your local computer.
# Install [[Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method|WebOS Quick Install]]
# Drag the gstservice IPK into the center of the WebOS Quick install window.
# Click the Install button.
# Drag the Precorder application ipk into the center of the WebOS Quick Install window.
# Click the install button.

== License ==

The GStreamer Service package is MIT Open Source licensed. The Precorder application is GPLv2 Open Source licensed.

== Operating notes ==

When precorder is first launched you will see the main screen. Only one button is currently functional. Tapping the 'Record Now' button will begin recording video to the /media/internal location on the pre making these videos available to be copied via USB. They will be located in the root of the USB drive when connected to your computer.
=== Viewfinder ===
Note that you are not able to see the video as it is recording. There is no viewfinder. It is currently technically infeasible to create a viewfinder (but maybe someone will work out how to do it). (For a description of why it is technically infeasible, and to make suggestions, ask questions, please see [http://www.webos-internals.org/wiki/Application_talk:Precorder#Viewfinder_discussion this section in the discussion page].)
=== Controls ===
When you tap the 'Record Now' button the screen will change to notify you that Precorder is currently capturing audio and video. There is a 'Stop recording' button located on the screen. Tapping this button stops the audio/video capture and returns you to the main view.
=== Customization ===
There are several features of Precorder that can be customized. All of these settings are available via the preferences option within the Precorder menu. The table below lists all possible preferences. Options in bold represent defaults.

<Table><TR><TD>
{{{!}} border="1" cellpadding="4"
{{!}}Option
{{!}}Description
{{!}}Possible Selections
{{!}}-
{{!}}Audio Format
{{!}}Select what format you would like the audio stream to be saved in.
{{!}}'''AAC''', AMRNB, MP3
{{!}}-
{{!}}Video Format
{{!}}Select what format you would like the video stream to be saved in.
{{!}}Mpeg-4, H.263, '''H.264/AVC'''
{{!}}-
{{!}}Container
{{!}}Select what multimedia container the audio/video streams will be in.
{{!}}'''mp4''', 3gp
{{!}}-
{{!}}Media Source
{{!}}What would you like Precorder to capture?
{{!}}Audio only, Video only, '''Both'''
{{!}}-
{{!}}Flash
{{!}}Would you like to use the built in LED for illumination?
{{!}}'''Off''', Low, Medium, High
{{!}}}
</TD></TR></Table>

=== Recent enhancements ===

'''0.3.0'''
*LED brightness now selectable
*Launch button added to launch video player
*Videos now are saved in /media/internal/video

'''0.2.3'''
*fixed css bug (correctly pushing the record button to the bottom of the screen)
*added icon for launcher

=== Known bugs ===

Precorder is currently in Alpha stages and as such is in a constant state of flux with new features being added and old functionality being modified. Please use this software at your own risk. Due to the alpha nature of the software, please check the discussion page for a more accurate list of bugs and/or feature requests.

*First run on any phone will cause a blank output.
**Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine.

*Getting the video light to work may cause 2 starts. Should be a 1-time-only process.
*2 minute limitation of recording. Once the video hits 2 minutes, the video data is lost and outputs a blank file.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder 2009-01-12 141733.png‎|alt=Precorder Main View|This is the initial view upon launching Precorder]]
[[Image:Precorder 2009-01-12 141738.png|alt=Precorder Recording View|This is the display during audio/video capture]]
[[Image:Precorder_2009-01-12_141805.png|alt=Precorder Preferences View|This is the preferences selection screen]]
[[Image:Launcher_2009-24-11_164206.png|alt=Palm OEM video app|All videos are viewable on the device via the Palm OEM video application]]

}}

File:Precorder 2009-01-12 141805.png

2009-12-01T19:27:03Z

Sacherjj:

File:Precorder 2009-01-12 141738.png

2009-12-01T19:25:56Z

Sacherjj:

File:Precorder 2009-01-12 141733.png

2009-12-01T19:23:02Z

Sacherjj:

File:Precorder 2009-24-11 164140.png

2009-12-01T19:21:07Z

Sacherjj: uploaded a new version of "Image:Precorder 2009-24-11 164140.png"

Patch webOS Roam Control

2009-07-24T18:40:14Z

Sacherjj: /* Procedure */

[[Image:Roam-control.jpg|right]]

= Roam Control=

=== Creating a "Roam Only" mode===

By default, the Pre has no "Roam Only" mode. For fringe Sprint service areas, this can be very annoying, as the phone will tend to prefer a weak Sprint signal versus a strong Verizon/Other CDMA signal. We can enable this mode fairly easily.

=== Procedure===

SSH in to rooted Pre
Mount filesystem as r/w, navigate to phoneprefs folder and create a backup of current preflist-assistant.js
<pre><nowiki>
mount -o remount,rw /
cd /usr/palm/applications/com.palm.app.phoneprefs/app/controllers
cp preflist-assistant.js preflist-assistant.js.bak
</nowiki></pre>

Edit preflist-assistant.js

<pre><nowiki>
vi preflist-assistant.js
</nowiki></pre>

line 208 (WebOS 1.1 line 227), find:
<pre><nowiki>
{label : $L("Automatic"),value: "any"}
</nowiki></pre>
* and replace with:
<pre><nowiki>
{label : $L("Automatic"),value: "any"},
{label : "Roam Only",value: "roamonly"}
</nowiki></pre>

line 994-1003 (WebOS 1.1 lines 1229-1233) find:
<pre><nowiki>
if(payload.extended.mode == 'any') {
this.voiceRoamingModel.currentVoiceRoaming = "any";
$('dataroamingrow').show();
$('voiceRoamingRow').removeClassName('last');
}
</nowiki></pre>
* and add below:
<pre><nowiki>
else if(payload.extended.mode == 'roamonly') {
this.voiceRoamingModel.currentVoiceRoaming = "roamonly";
$('dataroamingrow').show();
$('voiceRoamingRow').removeClassName('last');
}
</nowiki></pre>

Mount the filesystem as r/o, reboot the phone and, from the dialer, go to Preferences and test out your new mode!

<pre><nowiki>
mount -o remount,ro /
reboot
</nowiki></pre>

=== Credit===
w5mw