summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--src/SW/tf101/.gitignore2
-rw-r--r--src/SW/tf101/document.en.rest.txt103
-rw-r--r--src/SW/tf101/document.it.rest.txt106
l---------src/SW/tf101/du2html.xsl1
4 files changed, 212 insertions, 0 deletions
diff --git a/src/SW/tf101/.gitignore b/src/SW/tf101/.gitignore
new file mode 100644
index 0000000..08d33d4
--- /dev/null
+++ b/src/SW/tf101/.gitignore
@@ -0,0 +1,2 @@
+/document.en.du.xml
+/document.it.du.xml
diff --git a/src/SW/tf101/document.en.rest.txt b/src/SW/tf101/document.en.rest.txt
new file mode 100644
index 0000000..7f426e7
--- /dev/null
+++ b/src/SW/tf101/document.en.rest.txt
@@ -0,0 +1,103 @@
+========================
+Asus "Transformer" TF101
+========================
+:CreationDate: 2011-07-15 17:54:21
+:Id: SW/tf101
+:tags: - software
+ - hardware
+ - keyboard
+
+Some time ago I bought an `Asus TF101`_, together with its keyboard
+dock. It's a nice gadget: recent Android, updated often, fast, good
+screen, and the keyboard (which includes an additional battery) allows
+to use it like a laptop (mostly).
+
+Of course, I had to modify it my way :)
+
+The operating system
+====================
+
+I installed the alternative image `PRIME`_, that looks to me to be
+well supported, and has minimal changes w.r.t. the stock Asus one. It
+obviously provides ``root`` access.
+
+The keyboard
+============
+
+It could not be one of my computers without a `Dvorak
+keyboard`_. Searching the 'net it's easy to discover that the files
+that describe the physical keyboard layout are
+``/system/usr/keychars/asusec.kcm`` and
+``/system/usr/keylayout/asusec.kl``. The format of these files is
+quite easy to understand, although I still have some questions. Sadly,
+not having the source code for Android 3, we are left to guess. `My
+changes`_ are simple enough.
+
+.. note::
+
+ Mine is a UK model. It's possible that TF101 sold outside the UK
+ have different keyboards; I'm pretty sure that the US one has one
+ fewer key. Don't use my modifications without checking first!
+
+Since the keys are of different sizes / shapes, I couldn't just move
+the keycaps around. So, I wrote a `LaTeX file to print key labels`_, I
+printed it on adhesive labels (Avery L7165, 8 on an A4 sheet), I
+painted the sheet with transparent spray, I cut the key labels, and
+attached them on the keys. It works. (The "esc" key is below the
+"back" key, on the left of "1").
+
+ConnectBot and the physical keyboard
+------------------------------------
+
+Most Android applications have no problems with the physical keyboard,
+ma some get confused by complicated keys like "control" or
+"escape". In particular, `ConnectBot`_ completely ignores them. Since
+in a terminal emulator such keys are *very* useful, I looked around
+for a version that supported them. I found a couple of them on GitHub,
+but they were a bit behind w.r.t. to the main ConnectBot development,
+so I forked `"my own" version`_. If you want, you can `get it from
+GitHub`_.
+
+.. note::
+
+ There's very little of mine: I took two branches other people had
+ written, merged them, and updated the project files. If it works,
+ it's thanks to the original authors; if it breaks, it's my fault.
+
+The battery
+===========
+
+The internal battery in the tablet lasts several hours of continuous
+use; with the light use I make of it, I only have to charge it every
+couple of days.
+
+There was, though, a rather strange problem: the battery inside the
+dock was not charging. This became particularly obvious with the
+latest version of `PRIME`_, which includes a charge indicator for both
+batteries. On the 'net you can find quite a few threads about charging
+problems, but I was very intrigued when reading a `tear-down`_:
+there's a battery disconnection switch!
+
+I opened the dock, flipped the switch, closed everything up again, and
+now the battery charges perfectly. No, I don't know if they sold it to
+me that way, or if it magically flipped itself.
+
+The cable is short
+------------------
+
+The cable that Asus sells in the box, to connect the power supply to
+the tablet, is very short. A normal USB extension does not seem to
+work: you need a USB 3.0 extension, because some the 5 additional
+wires is used to carry the higher voltage needed to charge the
+battery.
+
+.. _`Asus TF101`: http://www.asus.com/Eee/Eee_Pad/Eee_Pad_Transformer_TF101/
+.. _`PRIME`: http://forum.xda-developers.com/showthread.php?t=1052380
+.. _`Dvorak keyboard`: /SW/my-layout/
+.. _`My changes`: http://www.thenautilus.net/cgit/tf101-dvorak-keyboard/commit/?h=dvorak&id=67bbe0db664ff57a0cb0a770f8b92fda9c50a152
+.. _`LaTeX file do print key labels`: http://www.thenautilus.net/cgit/tf101-dvorak-keyboard/tree/tasti-tf101.tex?h=keycaps
+.. _`ConnectBot`: http://connectbot.org/
+.. _`"my own" version`: https://github.com/dakkar/connectbot
+.. _`get it from GitHub`: https://github.com/downloads/dakkar/connectbot/Connectbot.apk
+.. _`tear-down`: http://forum.xda-developers.com/showthread.php?t=1120114&page=2
+
diff --git a/src/SW/tf101/document.it.rest.txt b/src/SW/tf101/document.it.rest.txt
new file mode 100644
index 0000000..d5cfeb8
--- /dev/null
+++ b/src/SW/tf101/document.it.rest.txt
@@ -0,0 +1,106 @@
+========================
+Asus "Transformer" TF101
+========================
+:CreationDate: 2011-07-15 17:54:21
+:Id: SW/tf101
+:tags: - software
+ - hardware
+ - keyboard
+
+Tempo addietro ho comprato un `Asus TF101`_, completo di tastiera. È
+un bell'oggetto: Android recente, aggiornato spesso, veloce, buono
+schermo, e la tastiera (con batteria aggiuntiva integrata) permette di
+usarlo come un portatile (quasi).
+
+Ovviamente ho dovuto modificarlo a modo mio :)
+
+Il sistema operativo
+====================
+
+Ho installato l'immagine alternativa `PRIME`_, che mi sembra ben
+supportata, e ha modifiche minime rispetto a quella di serie
+Asus. Chiaramente fornisce l'accesso a nome di ``root``.
+
+La tastiera
+===========
+
+Non può essere un computer mio senza `una tastiera Dvorak`_. Cercando
+in rete si scopre rapidamente che i file che descrivono la mappatura
+della tastiera fisica sono ``/system/usr/keychars/asusec.kcm`` e
+``/system/usr/keylayout/asusec.kl``. Il formato di questi file è
+abbastanza chiaro, anche se mi restano alcune perplessità. Purtroppo,
+non avendo il codice sorgente di Android 3, bisogna tirare a
+indovinare. `Le mie modifiche`_ sono abbastanza semplici.
+
+.. note::
+
+ Il mio è un modello UK. È possibile che i TF101 venduti fuori dal
+ Regno Unito abbiano una tastiera diversa; sono abbastanza sicuro
+ che il modello americano ha un tasto in meno. Non applicate le mie
+ modifiche senza controllare!
+
+Siccome i tasti non sono tutti della stessa forma / dimensione, non ho
+potuto semplicemente spostarli. Di conseguenza, ho scritto `un file
+LaTeX per etichettare i tasti`_, l'ho stampato su un foglio di
+etichette autoadesive (Avery L7165, 8 per foglio A4), ho verniciato il
+foglio con spray trasparente, ho ritagliato le etichettine, e le ho
+attaccate sui tasti. Funziona. (Il tasto "esc" è sotto al tasto
+"back", a sinistra del "1").
+
+ConnectBot e la tastiera fisica
+-------------------------------
+
+Le applicazioni Android non hanno grossi problemi con la tastiera
+fisica, ma alcune non si aspettano cose complicate tipo i tasti
+"control" o "escape". In particolare, `ConnectBot`_ non li sente
+proprio. Siccome in un terminale certi tasti fanno *tanto* comodo, mi
+sono messo a cercare una versione che li supportasse. Ne ho trovate
+alcune su GitHub, ma erano rimaste un po' indietro rispetto allo
+sviluppo principale di ConnectBot, quindi ne ho fatta `una versione
+"mia"`_. Se volete, potete `scaricarla da GitHub`_.
+
+.. note::
+
+ Di mio c'è poco: ho preso due branch altrui, le ho fuse assieme, e
+ ho aggiornato i file di compilazione. Se funziona è merito degli
+ autori originari, se non funziona è colpa mia.
+
+La batteria
+===========
+
+La batteria della tavoletta dura svariate ore di uso continuo; per
+quel poco che la uso io, mi basta ricaricarla ogni paio di giorni.
+
+C'era però un problema piuttosto strano: la batteria integrata nella
+tastiera non ne voleva sapere di caricarsi. Il fatto è diventato
+particolarmente evidente con l'ultima versione di `PRIME`_ che include
+un indicatore di carica per entrambe le batterie. In rete si trovano
+tantissime discussioni su problemi di carica, ma l'illuminazione mi è
+venuta leggendo di uno `smontaggio`_: c'è un interruttore che stacca
+la batteria!
+
+Ho aperto la tastiera, cambiato la posizione dell'interruttore,
+rimontato il tutto, e ora la batteria si carica perfettamente. No, non
+so se me l'hanno venduto in quel modo, o se si è magicamente spostato
+da solo.
+
+Il cavo è corto
+---------------
+
+Il cavo che Asus include nella scatola, per collegare l'alimentatore
+alla tavoletta, è molto corto. Una prolunga USB normale non sembra
+funzionare: serve una prolunga USB 3.0, perché qualcuno dei 5 fili
+aggiuntivi è usato per mandare la tensione più alta necessaria a
+caricare la batteria.
+
+.. _`Asus TF101`: http://www.asus.com/Eee/Eee_Pad/Eee_Pad_Transformer_TF101/
+.. _`PRIME`: http://forum.xda-developers.com/showthread.php?t=1052380
+.. _`una tastiera Dvorak`: /SW/my-layout/
+.. _`Le mie modifiche`: http://www.thenautilus.net/cgit/tf101-dvorak-keyboard/commit/?h=dvorak&id=67bbe0db664ff57a0cb0a770f8b92fda9c50a152
+.. _`un file LaTeX per etichettare i tasti`: http://www.thenautilus.net/cgit/tf101-dvorak-keyboard/tree/tasti-tf101.tex?h=keycaps
+.. _`ConnectBot`: http://connectbot.org/
+.. _`una versione "mia"`: https://github.com/dakkar/connectbot
+.. _`scaricarla da GitHub`: https://github.com/downloads/dakkar/connectbot/Connectbot.apk
+.. _`smontaggio`: http://forum.xda-developers.com/showthread.php?t=1120114&page=2
+
+
diff --git a/src/SW/tf101/du2html.xsl b/src/SW/tf101/du2html.xsl
new file mode 120000
index 0000000..e2487e0
--- /dev/null
+++ b/src/SW/tf101/du2html.xsl
@@ -0,0 +1 @@
+../../../templates/du2html.xsl \ No newline at end of file