WebOS Internals - User contributions [en]

Touchpad Bluetooth Keyboard

2011-09-25T20:28:34Z

Lunohod: /* Keyboard layouts */

== HP Touchpad Bluetooth Keyboard ==
=== Keycode/Scancode for Media/Specialty Keys ===
Hopefully this information will make it easier to implement support for the HP Touchpad Bluetooth Keyboard on other devices such as a Pre2 or Veer.

{| class="wikitable"
|-
! Key
! Keycode
! Scancode (Decimal)
! Scancode (Hex)
|-
| Notifications
| 1
|
|
|-
| Search
| 217
| 786977
| 0xC0221
|-
| Keyboard
| 204
|
|
|-
| Brightness Down
| 224
|
|
|-
| Brightness Up
| 225
|
|
|-
| Rewind
| 168
| 786612
| 0xC00B4
|-
| Play/Pause
| 164
| 786637
| 0xC00CD
|-
| Forward
| 208
| 786611
| 0xC00B3
|-
| Mute
| 113
| 786658
| 0xC00E2
|-
| Volume Down
| 114
| 786666
| 0xC00EA
|-
| Volume Up
| 115
| 786665
| 0xC00E9
|-
| Power
| 142
| 65666
| 0x10082
|}

Using various tools under Ubuntu 11.04, I haven't been able to get info for Keyboard, Brightness Down, and Brightness Up. These keys may need a Touchpad device to get the information for, as the keys are known working there.
--[[User:SineOtter|SineOtter]] 07:34, 9 September 2011 (UTC)

=== Keyboard layouts ===

The keymaps are located in the /usr/share/qt4/keymaps directory. There are 3 of them: keymap-us.qmap, keymap-de.qmap, keymap-fr.qmap. The keymap is loaded after the keyboard was successfully paired with the touchpad.

kmap2qmap is a tool to generate keymaps in qmap format (http://doc.qt.nokia.com/latest/qt-embedded-kmap2qmap.html). Original kmap2qmap source file was downloaded from http://svn.netlabs.org/repos/qt4/trunk/tools/kmap2qmap/main.cpp, then some changes from http://palm.cdnetworks.net/opensource/3.0.2/qt4-4.7.1-patches.gz were applied.
Download the patched kmap2qmap.cpp[http://users.openinkpot.org/~lunohod/kmap2qmap.cpp] and compile it:

'''gcc -o kmap2qmap kmap2qmap.cpp -I/usr/include/qt4 -I/usr/include/qt4/QtCore -lQtCore'''

Now grab the kmap[http://users.openinkpot.org/~lunohod/us.kmap] file, modify it if you want and generate the qmap file with:

'''./kmap2qmap us.kmap keymap-us.qmap'''

The us.kmap file was generated with ckbcomp (it's in the console-setup package in Debian) and then the touchpad related keys were added:

'''ckbcomp -keycodes evdev -layout us -compact > us.kmap'''

There is also a modified kmap file[http://users.openinkpot.org/~lunohod/us_modified.kmap] with CapsLock changed to Control key, added AltGr and germanic umlauts mapped to AltGr+[aous]. You can take this kmap as a reference or just diff it with the us.kmap to see what should be changed.

It is possible to create new layouts (with dvorak, colemak, cyrillic or whatever you want), but there is still no way to switch layouts on the fly.

Touchpad Bluetooth Keyboard

2011-09-25T20:28:01Z

Lunohod: /* Keyboard layouts */

== HP Touchpad Bluetooth Keyboard ==
=== Keycode/Scancode for Media/Specialty Keys ===
Hopefully this information will make it easier to implement support for the HP Touchpad Bluetooth Keyboard on other devices such as a Pre2 or Veer.

{| class="wikitable"
|-
! Key
! Keycode
! Scancode (Decimal)
! Scancode (Hex)
|-
| Notifications
| 1
|
|
|-
| Search
| 217
| 786977
| 0xC0221
|-
| Keyboard
| 204
|
|
|-
| Brightness Down
| 224
|
|
|-
| Brightness Up
| 225
|
|
|-
| Rewind
| 168
| 786612
| 0xC00B4
|-
| Play/Pause
| 164
| 786637
| 0xC00CD
|-
| Forward
| 208
| 786611
| 0xC00B3
|-
| Mute
| 113
| 786658
| 0xC00E2
|-
| Volume Down
| 114
| 786666
| 0xC00EA
|-
| Volume Up
| 115
| 786665
| 0xC00E9
|-
| Power
| 142
| 65666
| 0x10082
|}

Using various tools under Ubuntu 11.04, I haven't been able to get info for Keyboard, Brightness Down, and Brightness Up. These keys may need a Touchpad device to get the information for, as the keys are known working there.
--[[User:SineOtter|SineOtter]] 07:34, 9 September 2011 (UTC)

=== Keyboard layouts ===

The keymaps are located in the /usr/share/qt4/keymaps directory. There are 3 of them: keymap-us.qmap, keymap-de.qmap, keymap-fr.qmap. The keymap is loaded after the keyboard was successfully paired with the touchpad.

kmap2qmap is a tool to generate keymaps in qmap format (http://doc.qt.nokia.com/latest/qt-embedded-kmap2qmap.html). Original kmap2qmap source file was downloaded from http://svn.netlabs.org/repos/qt4/trunk/tools/kmap2qmap/main.cpp, then some changes from http://palm.cdnetworks.net/opensource/3.0.2/qt4-4.7.1-patches.gz were applied.
Download the patched kmap2qmap.cpp[http://users.openinkpot.org/~lunohod/kmap2qmap.cpp] and compile it:

'''gcc -o kmap2qmap kmap2qmap.cpp -I/usr/include/qt4 -I/usr/include/qt4/QtCore -lQtCore'''

Now grab the kmap[http://users.openinkpot.org/~lunohod/us.kmap] file, modify it if you want and generate the qmap file with:

'''./kmap2qmap us.kmap keymap-us.qmap'''

The us.kmap file was generated with ckbcomp (it's in the console-setup package in Debian) and then the touchpad related keys were added:

'''ckbcomp -keycodes evdev -layout us -compact > us.kmap'''

There is also a modified kmap file[http://users.openinkpot.org/~lunohod/us_modified.kmap] with CapLock changed to Control key, added AltGr and germanic umlauts mapped to AltGr+[aous]. You can take this kmap as a reference or just diff it with the us.kmap to see what should be changed.

It is possible to create new layouts (with dvorak, colemak, cyrillic or whatever you want), but there is still no way to switch layouts on the fly.

Touchpad Bluetooth Keyboard

2011-09-25T19:26:39Z

Lunohod: Describe keyboard layouts

== HP Touchpad Bluetooth Keyboard ==
=== Keycode/Scancode for Media/Specialty Keys ===
Hopefully this information will make it easier to implement support for the HP Touchpad Bluetooth Keyboard on other devices such as a Pre2 or Veer.

{| class="wikitable"
|-
! Key
! Keycode
! Scancode (Decimal)
! Scancode (Hex)
|-
| Notifications
| 1
|
|
|-
| Search
| 217
| 786977
| 0xC0221
|-
| Keyboard
| 204
|
|
|-
| Brightness Down
| 224
|
|
|-
| Brightness Up
| 225
|
|
|-
| Rewind
| 168
| 786612
| 0xC00B4
|-
| Play/Pause
| 164
| 786637
| 0xC00CD
|-
| Forward
| 208
| 786611
| 0xC00B3
|-
| Mute
| 113
| 786658
| 0xC00E2
|-
| Volume Down
| 114
| 786666
| 0xC00EA
|-
| Volume Up
| 115
| 786665
| 0xC00E9
|-
| Power
| 142
| 65666
| 0x10082
|}

Using various tools under Ubuntu 11.04, I haven't been able to get info for Keyboard, Brightness Down, and Brightness Up. These keys may need a Touchpad device to get the information for, as the keys are known working there.
--[[User:SineOtter|SineOtter]] 07:34, 9 September 2011 (UTC)

=== Keyboard layouts ===

The keymaps are located in the /usr/share/qt4/keymaps directory. There are 3 of them: keymap-us.qmap, keymap-de.qmap, keymap-fr.qmap. The keymap is loaded after the keyboard was successfully paired with the touchpad.

kmap2qmap is a tool to generate keymaps in qmap format (http://doc.qt.nokia.com/latest/qt-embedded-kmap2qmap.html). Original kmap2qmap source file was downloaded from http://svn.netlabs.org/repos/qt4/trunk/tools/kmap2qmap/main.cpp, then some changes from http://palm.cdnetworks.net/opensource/3.0.2/qt4-4.7.1-patches.gz were applied.
Download the patched kmap2qmap.cpp and compile it:

'''gcc -o kmap2qmap kmap2qmap.cpp -I/usr/include/qt4 -I/usr/include/qt4/QtCore -lQtCore'''

Now grab the kmap file, modify it if you want and generate the qmap file with:

'''./kmap2qmap us.kmap keymap-us.qmap'''

The us.kmap file was generated with ckbcomp (it's in the console-setup package in Debian) and then the touchpad related keys were added:

'''ckbcomp -keycodes evdev -layout us -compact > us.kmap'''

There is also a modified kmap file with CapLock changed to Control key, added AltGr and germanic umlauts mapped to AltGr+[aous]. You can take this kmap as a reference or just diff it with the us.kmap to see what should be changed.

It is possible to create new layouts (with dvorak, colemak, cyrillic or whatever you want), but there is still no way to switch layouts on the fly.

Building Apps and Kernels

2011-09-23T22:29:40Z

Lunohod: Fixed link to the How_To_Build_Xecutah

If you are looking for instructions for building apps and kernels for WebOS, you have come to the right place. If you have not run through the [[WebOS Internals PDK]] wiki page, you should start there.

== '''Setup''' ==
Depending on what you're building you might need some of the prereq's from [[WebOS Internals PDK]] installation.

Create the directory structure for the source:
<pre>
sudo mkdir -p /srv/preware
cd /srv/preware
sudo chmod 777 .
</pre>

Pull down the app source with git.
<pre>
git clone git://git.webos-internals.org/preware/build.git
</pre>

After you have the source, you need to build the toolchain — this can take some time or if you already have the toolchain installed, please see below
<pre>
cd build
make toolchain
</pre>

Please see the notes if you already have the correct toolchain installed and do not want to download it again.

== '''Apps''' ==

Package up preware.
<pre>
cd /srv/preware/build/apps/preware
make package
</pre>

== '''Kernels''' ==

Package up UberKernel.
<pre>
cd /srv/preware/build/kernels/uber-kernel-touchpad
make package
</pre>

Testing your kernel
you will find your kernel in
<pre>
build/src-3.0.2-22/linux-2.6.35/arch/arm/boot
</pre>
you can boot it using memboot. to do this do the following <br>
1) turn off the touchpad<br>
2) connect it to your machine<br>
3) press the Volume Up key and power on the device, you should see a giant USB logo on the device<br>
4) novacom boot mem:// < uImage

== '''Libraries''' ==
Once you have your toolchain configured and you have had a chance to get your SB2 cross compiler working with one of the applications above, you might be looking to add libraries or compile libraries and "stage" them into your cross compiler /usr directory. The /usr directory in your toolchain is the directory that contains the lib files and include files necessary to compile libraries or applications against the toolchain. Since the TouchPad is targeting armv7, we have to compile libraries to target the armv7 architecture and stage them into the architecture's root /usr/lib and include directories.

Don't worry, once you get the hang of it, it's pretty straight forward. You just have to trust that this is the fastest and easiest way to pull down code, compile dependencies, and get the ball rolling on your own library or application.

You might also be interested in using additional libraries in your projects. Your best bet for getting the latest source is to look in the locations of the existing libraries used in other packages.

It's a good idea to first take a look at the directories for all of the common libraries that were downloaded when you setup your toolchain:
<pre>
cd /srv/preware/cross-compile/packages/common/x
ls
</pre>
Each directory here is a separate library. The library folder contains a Makefile, which links to other Makefiles. The Makefiles download source for the library and compile the various dependencies of the library that kicked off the make command.

Let's start by simply compiling libxcb and take a look at the different pieces involved in getting the library to compile properly. If you crack open the Makefile for libxcb:
<pre>
nano /srv/preware/cross-compile/packages/common/x/libxcb/Makefile
</pre>

You should see the name of the project, the version number for libxcb (this is used to download the package from the tar) and the SRC_BZ2 url. The SRC_BZ2 url can be changed to point to the package that you're looking to compile.
<pre>
NAME = libxcb
VERSION = 1.7

DEPENDS = x/xcbproto \
x/libpthread-stubs \
x/xau

SRC_BZ2 = http://xcb.freedesktop.org/dist/${NAME}-${VERSION}.tar.bz2
...
</pre>

For most instances, the above text is the only text you will need to modify (for most cases where you need to compile your own library folder in the packages directory). The process is pretty straight forward from here. Keep in mind, any folder you list in the DEPENDS section will need to exist and have a Makefile containing similar logic as the makefile you created for the library that lists it in its Makefile depends section.

If you want to test out compiling and staging (installing the library into your target architecture /usr/lib and include folder like we mention above), just type:
<pre>
make stage package
</pre>
'''Note:''' some packages might need additional work to compile (e.g. compiling libxcb requires that you create the full path for the documentation before it will install properly /usr/local/share/doc/libxcb/tutorial).

Now when you want to configure your own application or library outside of the toolchain or preware directory (such as a library or application you downloaded or are using Eclipse to develop) simply cd into that source directory and enter the toolchain:
<pre>
sb2 -M /srv/preware/cross-compile/staging/mapping-armv7
./configure
make all
</pre>
or
<pre>
cmake .
make
</pre>

Making and packaging builds the goods, packages them for you in a neat little ipkg and places the code where it needs to go for other apps and libraries to link to. That's about all there is to it!

== '''Notes''' ==

If you already have the correct version of the toolchain installed for the device you are targeting you can symlink it to the proper location (e.g. the touchpad needs the Sourcery G++ Lite 2009q1-203 toolchain).

If it is already installed you can symlink it into the build area:

<pre>
cd toolchain/cs09q1armel
mkdir build
cd build
ln -s <location of toolchain> arm-2009q1
</pre>

== '''Samples''' ==

After you run through the WIDK and setup your toolchain, take a look at [[How_To_Build_Xecutah]] for details on building X Server and the process for building an application.

Touchpad Bluetooth Keyboard

2011-09-23T21:26:39Z

Lunohod: Add missing keycodes