README.md
############## Ubuntu for HTC HD2 v0.3 ##############
Ubuntu Linux for HTC's HD2 cell phone aka HTC LEO
INSTALL
#######
1)Extract the linux folder to the main directory(!) of your Storage Card.
If the linux folder is not located in the main directory of the Card,
it will not work.
Note: This will not touch your phone's internal memory (WinMO remains unchanged).
QUICKY
######
1) Save all your current work and start the HaRET exectuable to boot Linux.
2) Watch the system boot up fully until you see a graphical desktop interface.
3) Have fun.
4) Use shutdown icon in the home menu to bring the system down savely.
BASIC USAGE
###########
*TOUCHSCREEN
There is an On Screen Keyboard enabled by dafult.
-hide it using the minimize button
-make it appear again using the yellow/blue icon in the top left corner
-drag it around by pressing and holding on its title bar
-if you close it accidentally, open it again using keyboard icon in top bar
-Multitouch is in the making. We have some exclusive HD2 patches in Ubuntu for that :)
It will support two finger gestures (pinch, drag, rotate, etc.) in loads of apps.
*MULTIMEDIA
A video player is included. You can put videos on your storage card,
(see SD Card icon on the desktop) and play them back by tapping them.
I installed a firefox plugin to download youtube videos. To try it
visit a youtube video url and look for the download menu below the yt
window. You can save them in your Download folder and play them back
by tapping them in file browser.
There is no built in audio support. You can only use USB audio devices for now.
*PERFORMANCE
In the midst of the top bar you will see an item that displays
the current CPU frequency. Tap it to set the highest clock setting
for fast CPU speeds or chose powersaving or ondemand mode for less
battery drain. By default it is in ondemand mode.
Check the battery percentage using the power icon in the top bar.
The stuff reported by the default gui is wrong. It will claim your battery
is critical soon as you unplug usb.
*LANGUAGE SUPPORT
For size reasons the only language included is english.
It is possible to install any extra language supported by Ubuntu.
Visit http://www.ubuntu.com/wiki for such information and much more.
*SECURITY
You will be automatically logged in as user 'htc-linux'. I set the /etc/sudoers
file up to let it gain sudo automatically. This eases many things.
openssh-server is ran on startup to allow usbnet connectivity.
*LOGIN
user: 'htc-linux'
passwort: 'ubuntu'
It is recommended to change the password.
*KEYPAD
SORRY - OUT OF ORDER !! - I can't get the keypad going in Ubuntu Maverick 10.10
Something is wrong with Xorg . Driver didn't change vs hd2-ubuntu_0.2 .
[Hold down the "home button" to move windows around
for example when something is OFF SCREEN.
Mapping: (Also see included keymapping.png picture)
Volume Up = Left
Volume Down = Right
Dial Button = Enter
Home Button = Alt (hold down to move windows with touchscreen)
Windows Button = Down
Back Button = Up]
CONNECTIVITY
############
*3G DATA
To connect to the internet via 3G DATA connection, tap the "3G Connection"
icon in the home menu. You will be asked for your 3G Access Point Name,
user name and password. Enter this information exactly as provided by your
cell phone network provider.
Wait until it says it's done.
*WiFi
To connect to a WiFi network, tap the "WiFi mode" icon on the home screen.
After seeing the success message, you can scan start scanning for networks.
Tap the networking icon (two monitors) in the top right of your display
(only once!) It takes a while until the window appears and until network
scan is complete.
If you don't see the icon in the top right and no window will appear
automatically just run the "Wicd" program (same icon as WiFi mode).
*PHONE
To send and view SMS and make phone CALLS, tap the signal quality
indiciator icon located in the top right of your display.
Unfortunately there is no sound during calls yet. But you can dial :P
To send SMS you can alternatively tap the TUX icon on the desktop.
A window will pop up when you receive an SMS message or a call.
3 USB MODI
##########
There are 3 USB modi avilable: Ethernet and adb - both excellent for diagnostics
and file transfers with a host computer - and there is usb host mode.
Each usb mode requires a different kernel image. Thast's what the three
included zImages are for.
Please see startup.txt for further information on switching them.
*USB ETHERNET
In usb ethernet mode you will be able to establish a network connection
with your linux based host computer and ssh in.
If you are using the usb-ether zImage you will have the hd2 ready
to connect on boot. If you have been using 3G Mode or Wifi Mode after boot,
you can get back to USB Mode by tapping the according icon in the home menu.
On your host computer you can do the following to connect after plugging in the cable:
ifconfig usb0 up 192.168.0.200
ssh -Y htc-linux@192.168.0.206
*ADB
ADB (Anroid Debug Bridge) is weak. ssh is better. But it is useful when you
only have a windows PC handy.
To get the adb program for your windows or linux based host pc google for
anroid sdk and have a look inside the tools folder.
After booting with the adb zImage, adbd should be ready to accept connections.
Connect the USB cable with your host pc and try:
adb shell
*USB HOST MODE
This release comes with the requirements to attach all kinds of peripheral devices
via USB including but not limited to:
-keyboards
-mice
-printers
-flash disks and HDDs
-audio devices
-network devices (wifi, wired, bluetooth)
-display devices
-secret gps devices
You will have to supply power from an external source.
See below link for instructions on how to do this.
http://htc-linux.org/wiki/index.php?title=Msm_Usb_Host
RELEASE INFORMATION
###################
v0.3
####
released on December 27th, 2010
*ROOTFILESYSTEM
New base: Ubuntu Maverick Meerkat 10.10
-Comes with mega fancy netbook gui and totally updated everything.
-It supports all the nice armv7 CPU instuctions, NEON acceleration etc.
=>Much better performance!
-New versions of apps
-Improved scripts
*LINUX KERNEL
htc-msm-2.6.32 base.
Improvements:
-Support for usb net
-adb
-usb host mode
(in one release)
-Battery Charging and monitoring
-Backlight toggeling
Lots of details on this release documented at
http://htc-linux.org/wiki/index.php?title=Ubuntu/Leo
v0.2
####
released on July 28th, 2010
*LINUX KERNEL
-Improve touchscreen driver (still not perfect)
-Add WiFi driver
-Add 3G DATA driver (using serial channel directly)
-Add vibrator driver
STATUS NOTE: The linux kernel is based on what is available as source code.
Features not available in source are not included in this release:
-Battery driver
-Panel driver
-Bluetooth
Also some features are currently only available in Google Android(tm).
"Android is a trademark of Google Inc. Use of this trademark is
subject to Google Permissions."
-Audio has a driver that works with Android(tm) only. It is being worked on.
-Camera too (V4L drivers might be available at some point)
-Also 2d and 3d accerlation (very difficult)
*ROOTFILESYSTEM
(Based on v0.1 rootilfesystem Ubuntu Karmic for ARM)
*Add scripts for wifi, data, screen rotation and other things
*Add on screen keyboard
*Add application to handle phone functions (see sphone below)
etc.
*Add gnome-mplayer graphical interface to the included mplayer (see below)
For Status info visit
http://htc-linux.org/wiki/index.php?title=Leo/Status
v0.1
####
June 30th, 2010
initial release.
DEVELOPMENT INFORMATION
#######################
*PROJECT INFORMATION
http://twitter.com/htc_linux
http://htc-linux.org/wiki
http://facebook.com/HTCLinux
http://forum.xda-developers.com/showthread.php?t=719646#2
*KERNEL
Included sources:
linux_htc-msm-2.6.32_2.6.32.9-38182-g6ad7e77.tar.gz inside this archive contains the entire kernel
source code including configurations in arch/arm/configs/htcleo-*
Development tree:
git://git.linuxtogo.org/home/groups/mobile-linux/kernel.git htc-msm-2.6.32
Git revision used in this release: "6ad7e773a614e532740a98fc3a054d05dab8d2a2"
How to compile the kernel:
http://htc-linux.org/wiki/index.php?title=QuickDeveloperStartGuide#Kernel
*GOOD GENERAL WEBSITE FOR HTC PHONES
http://www.xda-developers.com
*UBUNTU LINUX
The rootfilesystem is based on stock Ubuntu 10.10 Maverick Meerkat release for ARM
Website: http://www.ubuntu.com
Ubuntu is based on debian. http://www.debian.org
*mplayer
mplayer is the best multimedia player available for Linux: http://www.mplayerhq.hu
The mplayer installed in this release was compiled using http://openembedded.org buildsystem not.
*MOZILLA
firefox has the 'grab and drag' addon installed:
https://addons.mozilla.org/de/firefox/addon/1250/
as well as greasemonkey with a youtube downloader script.
*PHONE
ofono mobile phone framework: http://ofono.org/
sphone: ofono GUI created by XDA user 'amiPro' http://wiki.github.com/amipro/sphone/
DISCLAIMER
##########
Although I don't know about any HTC destroyed by Linux, I can not be
held responsible for any damages caused by this. So use at own risk!
If I accidentally break any licenses please don't hesitate to contact me. Thanks
CREDIT
######
This Ubuntu for HTC HD2 release was made by Lukas-David Gorris (aka dcordes)
Note that the possiblity to boot the Linux kernel on the HTC HD2 is based on the effort of many!
Others also participating in the kernel development for HTC HD2:
cr2, NetRipper, Cotulla, LeTama, Markinus et al.
For any feedback you can send me a mail: 'lukas.gorris <at> gmail.com'
Please be aware that this is an early version and that it is not complete.
