[TOOLS] Touchpad Toolbox (updated 2015-02-25)

Touchpad Toolbox (aka tptoolbox) is a completely self-contained and user-friendly system for the low-level management of the HP Touchpad.

TPToolbox replaces:

• ACMEInstallers
• ACMEUninstallers
• Various methods of resizing volumes (erroneously called partitions)
• Various methods of reflashing the A6 battery monitoring chip
• Various methods of completely wiping/recreating volumes

TPToolbox adds:

• A straightforward, reliable and easy-to-use method of installing all versions (ICS to LP) of Android on the Touchpad.
• The ability to completely remove webOS.

User Interface
As the toolbox name implies, there are several tools in tptoolbox. These tools are accessible via a menu-driven interface:



The interface consists of three primary panes: menu, help and output. The menu pane is toward the top left. The help pane is toward the top right. The output pane is at the bottom.

When a tool runs, output (and possible error messages) will appear in the output pane (doh!). Also, the very bottom of the menu pane will have a "WORKING" status indicator. When a tool fails to complete successfully, the status indicator will change to "FAILED." When a tool completes successfully, the status indicator will change to "DONE." The DONE/FAILED status indicator will remain until the next user input (i.e. VolUp/VolDn/Home is pressed).

Most tools, however, are not simple one-step operations. They may require additional confirmation or input during the process. In those cases, the "WORKING" indicator will disappear (without a DONE/FAILED) after part of the process completes and a new menu will appear. You will be guided through these processes with appropriate information in the help pane. Also, if an operation is cancelled (i.e. you say 'no' to a confirmation, etc.), the status indicator will be reset (be blank).

The VolumeUp, VolumeDown and Home buttons are used to select menu items.

The screen will automatically blank if there is no user input for 20 mins. The Power button can be used to blank/unblank the screen.


Installing Android
Although the on-screen help will guide you through the process when you select "Install Android", I'll give an overview of the process here and how it differs from previous methods. Unlike previous methods of installing Android, you do not need to copy any files onto the Touchpad prior to running TPToolbox. After you select "Intstall Android" it will do some basic checks on the volumes and filesystems on the device. Then, it will share the "media" volume to your PC allowing you to copy the installation files (ROM, Recovery and GApps) to the Touchpad. It will then check these install files to make sure they are compatible and have no obvious errors (i.e. basic zip integrity check). Assuming those tests pass, it will create a set of volume resizing criteria based on the type of Android being installed (i.e. DataMedia vs Non-DataMedia) and confirm that you have availablespace on the device. Next, you will be presented a menu allowing you to confirm to proceed with the installation. It will then install moboot (which is included in TPToolbox) and recovery and resize the volumes. Then it will generate an "install script" for recovery and boot into recovery to complete the installation of the ROM and GApps. After recovery completes it's installation of the ROM and GApps, the Touchpad should boot into the newly installed ROM.

TL;DR: Select "Install Android," Copy files when it asks, Confirm when it asks

For more information on compatible ROM/Recovery/Gapps, etc., see post #3.

Complete Data Reset, webOS Removal and Android Uninstall
One of the tools available is "Complete Data Reset". This will completely wipe all OSes and Data from the Touchpad and rebuild the volumes fresh (actually, there will only be one volume after this, 'media') and rebuild /boot with a minimal set of programs (provided by tptoolbox) that are required by Android to boot. After doing a "Complete Data Reset," you can then "Install Android" (i.e. without webOS). Or, you can re-install webOS (see "Create webOS Volumes" in post #4) and then (optionally) "Install Android." Note that there are no separate "remove webOS" or "remove Android" (This is by design!).

See Also
Post #2 - Loading TPToolbox
Post #3 - Installing Android via TPToolbox
Post #4 - Other TPToolbox Tools
Post #5 - TPToolbox Limitations/FAQs/etc.

Loading TPToolbox

The latest version of TPToolbox is v42 released on 2015-01-08.

It can be downloaded from:
http://downloads.codefi.re/jcsullins/cmtouchpad/tptoolbox/TPToolbox-2015-01-08-v42.zip or
http://www.mediafire.com/download/kuz6e3itpudl9q2/TPToolbox-2015-01-08-v42.zip or
https://www.androidfilehost.com/?fid=95887005526788942

Loading TPToolbox is as simple as A, B, C

A) Have novacom installed
To load TPToolbox, you will need novacom to be installed on your PC.
You can download novacom drivers from: http://downloads.codefi.re/jcsullins/webos/novacom
Or, you can download and run a java-based "universal installer" from http://123haynes.github.io/universal-novacom-installer


B) Put the Touchpad into webOS recovery mode and connect via USB cable to PC
NOTE: Even if webOS is removed, webOS recovery will still exist as it's built into the bootloader.
If you have moboot already installed, just select "webOS recovery" there.
Or, power the Touchpad off via webOS, then with the Touchpad is off, hold VolumeUp (closest to Power) and Power until you see the USB symbol.
Or, hold Power+Home until the screen changes (about 10 secs) and then start holding the VolumeUp button until you see the big USB symbol.


C) Run the script provided with TPToolbox
Extract the contents of the TPToolbox zip file from above.
Navigate to the tptoolbox_v42 directory that was extracted from the zip.
On Windows, run the batch file named tptb_v42_win.bat
On Linux, run the script named tptb_v42_nix.sh
On Mac, run the script named tptb_v42_mac.command

Installing Android via TPToolbox

Installation Overview
For the most reliable install, it is suggested that you consider doing a "Complete Data Reset" (as mentioned in the OP) prior to doing the install as it's the best way to "start fresh."

The OP gave an overview of the process that TPToolbox uses to install Android.

From a user perspective, it's pretty simple: copy three files (ROM, Gapps and Recovery) when and where TPToolbox asks and then select "yes" when asked to confirm the install details.

Below is the list of Recoveries that you can use with TPToolbox. Those marked with "DM" are for data-media ROMs and those marked with "NODM" are for non-datamedia ROMs. Unless the developer has specified otherwise, you can assume that any KK or LP ROM is datamedia and ROMs previous to KK are non-datamedia. However, TPToolbox checks to make sure that the ROM and Recovery are compatible and will tell you if they are not.

Compatible DataMedia (DM) recoveries

Download traditional CWM (DM):
http://downloads.codefi.re/jcsullins/cmtouchpad/recovery/update-CWM-jcs-dm-tenderloin-20141231.zip or
https://www.androidfilehost.com/?fid=95887005526788938 or
http://www.mediafire.com/download/eyugz1w6twld313/update-CWM-jcs-dm-tenderloin-20141231.zip

Download Philz-CWM (DM):
http://downloads.codefi.re/jcsullin...date-PhilZ_CWM-jcs-dm-tenderloin-20140612.zip or
https://www.androidfilehost.com/?fid=23610159112654007 or
http://www.mediafire.com/download/vvldbc3380y4pl1/update-PhilZ_CWM-jcs-dm-tenderloin-20140612.zip

Download TWRP (DM):
http://downloads.codefi.re/jcsullins/cmtouchpad/recovery/update-TWRP-jcs-dm-tenderloin-20140612b.zip or
https://www.androidfilehost.com/?fid=95784891001615841 or
http://www.mediafire.com/download/d155um5531ymp3h/update-TWRP-jcs-dm-tenderloin-20140612b.zip

Download flintman's Dec. 23, 2014 build of TWRP (DM):
http://evervolv.com/get/FLINTMAN-TWRP-touch-data_media-SELINUX-2.8.3.0-12-23-14.zip

Compatible Non-DataMedia (NODM) recoveries

Download traditional CWM (NODM):
http://downloads.codefi.re/jcsullins/cmtouchpad/recovery/update-CWM-jcs-nodm-tenderloin-20141231.zip or
https://www.androidfilehost.com/?fid=95887005526788937 or
http://www.mediafire.com/download/y7xqj521a76z4ml/update-CWM-jcs-nodm-tenderloin-20141231.zip

Download Philz-CWM (NODM):
http://downloads.codefi.re/jcsullin...te-PhilZ_CWM-jcs-nodm-tenderloin-20140614.zip or
https://www.androidfilehost.com/?fid=23610159112654008 or
http://www.mediafire.com/download/eb602915di0gcuc/update-PhilZ_CWM-jcs-nodm-tenderloin-20140614.zip

Download TWRP (NODM):
http://downloads.codefi.re/jcsullin...update-TWRP-jcs-nodm-tenderloin-20140614b.zip or
https://www.androidfilehost.com/?fid=95784891001615842 or
http://www.mediafire.com/download/r4grp5bu6brsl6l/update-TWRP-jcs-nodm-tenderloin-20140614b.zip

Other TPToolbox Tools

Mount Media Volume allows you to access the 'media' volume from your PC

Reflash A6 Firmware allows you to reflash the A6 firmware.

Resize Android Volumes
This allows you to interactively resize the Android (and media) volumes.
This is not needed to "Install Android", but can be used at other times to 'tweak' the volume sizes as needed.

Repair Android Volumes
If a fsck (file system check) determines that there are non-trivial errors on a filesystem, then this can be used to attempt to fix those errors.

Create webOS Volumes
If you want to re-install webOS following a "Full Data Reset," you will need to run this prior to running webOS doctor.
At this time, re-installing webOS should only be done prior to installing Android. Tools to assist re-installing webOS after
Android has been installed (without detriment to the Android install) may be provided in the future.

TPToolbox Limitations/FAQs/etc.

Limitations

• This thread
• Re-install of webOS after Android installed is not supported yet. (i.e. after a "Complete Data Reset", you must re-install webOS before Android)
• Method for permanently installing TPToolbox (always available via moboot) not available yet
• Installation of a "3rd OS" (i.e. luneOS) not supported yet
• Installation of Android without Gapps not supported yey