====== Gentoo on N8x0 ======
This is the official page for the unofficial port of Gentoo to N8x0 internet tablets.

If you have any questions/troubles, you can find us on Freenode #maemo, #gentoo-embedded or just post your questions at the end of this page.

:!: **Now bootable with X, BlueTooth, WiFi, and GPS**.

===== Team =====
  * Luke Dashjr (luke-jr)
  * Marat Radchenko (slonopotamus)
===== Resources =====
  * :!: Downloadable stage3 tarball: [[http://www.gentoo.org/main/en/mirrors2.xml|any Gentoo mirror]] under **releases/arm/autobuilds/current-stage3/armv6j-unknown-linux-gnueabi** :!:
  * [[gentoo-on-n8x0:cflags|Choosing CFLAGS]]
  * [[gentoo-on-n8x0:boot|Booting]]
  * [[gentoo-on-n8x0:keyboard|Keyboard configuration (console)]]
  * [[gentoo-on-n8x0:x11|X11 setup]]
  * [[gentoo-on-n8x0:mbx|PowerVR MBX acceleration (OpenGL ES and OpenVG)]] FIXME Not working yet
  * [[gentoo-on-n8x0:wireless|Wireless setup]]
  * [[gentoo-on-n8x0:sound|Sound setup]]
  * [[gentoo-on-n8x0:gps|GPS setup]]
  * [[gentoo-on-n8x0:qemu|Running in QEMU]]
  * [[gentoo-on-n8x0:kernel|Custom Kernel]] FIXME Not working yet
  * [[gentoo-on-n8x0:issues|Known issues]]
  * [[gentoo-on-n8x0:cross-bootstrap|Initial cross-bootstrap]]
===== Overlay =====
We have an overlay where all tablet-related packages will be put.

You may [[http://github.com/slonopotamus/n8x0-overlay|browse it]] or clone from [[git://github.com/slonopotamus/n8x0-overlay.git]] (you'll need to install git in order to do that).

Overlay is also available via layman.

First, install layman and git:
<code>
USE=git emerge layman
</code>

Edit/update **/etc/make.conf** how layman told you.

Fetch overlay:
<code>
layman -a n8x0
</code>

You can now emerge the n8x0 ebuilds.

===== Subprojects =====
==== fb_text2screen ====
fb_text2screen is an opensource rewrite of text2screen - small tool for text drawing on framebuffer devices.

Sources: http://github.com/slonopotamus/fb_text2screen

Releases:

[[http://github.com/slonopotamus/fb_text2screen/zipball/v0.1.1|0.1.1]] (2009-08-04)
<code>
Changes:
	* fixed tarball script
	* write errors to stderr
	* added --version option</code>
[[http://github.com/slonopotamus/fb_text2screen/zipball/v0.1|0.1]] (2009-07-18)
<code>Initial release. Fully compatible with text2screen tool.</code>

==== opendsme ====
opendsme is an opensource rewrite of dsme/cal-related Maemo tools.

Sources: http://github.com/slonopotamus/opendsme

Releases:

[[http://github.com/slonopotamus/opendsme/zipball/v0.2|0.2]] (2009-08-04)
<code>Features added:
	* readonly libopencal
	* bt-cal functionality added to open-wlan-cal
	* semi-working open-cal-tool</code>
[[http://github.com/slonopotamus/opendsme/zipball/v0.1|0.1]] (2009-07-18)
<code>Initial release. Features open-wlan-cal utility.</code>

===== Credits =====
This project would not be possible without great advices from solar on #gentoo-embedded. Also, we'd like to thank Stskeeps from #maemo, one of core maintainers of Deblet project <del>(and, now, Mer)</del> (and, now, Meego).

christendoc began this project with his [[http://nosocomia.com:8099/n810-gentoo/|porting work]].

slonopotamus brought us a more correct CHOST along with much better Gentoo support in general.

Luke-Jr has worked on improving support on N810, especially GPS and newer kernels.

===== Using in chroot =====
  - Download stage3 tarball from [[#resources|Resources section]]
  - Create folder for Gentoo. **System and portage tree will take up 1GB**
  - cd in folder you just created
  - Run ''tar -xvjpf stage3-armv6j-*.tar.bz2'' to unpack stage.
  - Run <code>mount -t proc proc proc
mount -o bind /dev dev
mount -o bind /dev/pts dev/pts 
cp -L /etc/resolv.conf etc/
chroot . /bin/bash
env-update && source /etc/profile</code> to prepare environment and chroot into Gentoo.
  - Voila, you're inside Gentoo chroot.
(Note: the "mount -o bind /dev/pts dev/pts" bit prevents the 'out of pts' error when inside the chroot. In most other circumstances we could just 'mount -o rbind /dev dev' but busybox silently ignores the rbind option.)

Emerge any packages you want/tweak any settings you want.

You'll need to run <code>emerge --sync</code> before installing packages.

Read [[http://www.gentoo.org/doc/en/handbook/handbook-arm.xml?part=2&chap=1|A Portage Introduction]] if you don't have previous experience with Gentoo.