Eee BIOS upgrade

I was getting occasional errors from my RunCore SSD where the partition when read only and would not write and I needed to update my Eee PC 1000 BIOS.

This is a bit trickier than you might think as you need a FAT-16 formatted USB stick of less than 2GB, otherwise the Eee updater gives you error messages saying it cannot read 1000.ROM or that it is in the wrong format.

Anyway, to save time for anyone else who is searching how to do this, see http://wiki.eeeuser.com/howto:updatebios.

From Windows, you can right click a mounted USB and choose Format / FAT to get the correct FAT-16 format, then download the latest Eee 1000 BIOS .ZIP file from the Asus site (mine was 1000-ASUS-1003.zip), unzip it and rename the 1000-asus-1003.rom file to 1000.ROM before copying to the USB stick. Put it in your Eee then power on with ALT-F2 held down, making sure you are running on mains power and have a fully charged battery. It takes about 5 minutes to flash update the BIOS ROM.

Make your Asus Eee 900/1000 run 4x faster

Previously, I described how to set up an Asus Eee 1000 to run Eeebuntu and described the 8GB / 32GB Solid State Disk setup it has. What I didn't realise then is that the 32GB SSD provided was much slower than the 8GB SSD, and that the 8GB SSD wasn't particularly fast either.

You can now purchase a much faster "Runcore" drop-in replacement for the 32GB SSD.

It is 4-6x faster for read/write and makes apps that were sluggish before, such as Firefox, respond quickly. Boot and shutdown time and noticeably faster too.

The Runcore is sized at either 64GB or 128GB. I went for the 64GB option (enough for me!)

The full title for Googling is RunCore 64GB PATA Mini PCI-e PCIe SSD for ASUS EEE PC 901 and 1000. Phew.

In the US you can buy it from mydigitaldiscount.com ($220) and in the UK I bought mine from memoryc.com for £160 inc. VAT. Check out the comments on there from other happy customers :-)

Installation is simple. Backup all your data to a USB stick (usual warnings about proceeding at your own risk). Shutdown and unplug your Eee PC. Turn it over. On the back there is a panel (red rectangle below) retained by two precision screws (red circles). One of these on mine was hidden under a silver "EeePC" sticker which I had to peel up for access.

Unscrew these using the (provided) precision screwdriver and lift off the panel. You can then remove two screws to release the existing 32GB memory card. It is simple to push in the replacement one and screw it down. Replace the panel and screw that down. Here's my old Asus 32GB card in the box the RunCore card came in from memoryc.com:

Now power back up and on the BIOS boot screen press F2. Go to Advanced, IDE Configuration and you should see [RunCore 64G-C SSD] as the new drive.

What I did was install Eeebuntu 3.0.1 (Ubuntu 9.04) to the 64GB RunCore SSD (format it and use 100% of space for root / partition) and use the Asus 8GB SSD as the Linux swap space (select manual configuration at install time to be able to do this). After that I restored my user files from the backup.

Works like a charm!

Asus Eee 1000 using Ubuntu 9 Jaunty with INQ1 Phone as a Bluetooth Modem

This article follows on from my earlier blog post on how to install Eeebuntu (Ubuntu 8.10 Intrepid) on an Asus Eee 1000 and use it with an INQ1 phone as a bluetooth modem.

I have reinstalled with Eeebuntu 3.0.1 NBR (Ubuntu 9.04 Jaunty) and it's a big improvement. It now comes with EeePC Tray working right out of the box and you can skip most of the setup I gave previously. There are a couple of tricky points and the procedure for getting an INQ1 phone to work as a bluetooth modem is slightly different (and easier) and I outline these below.

Install Eeebuntu

First, install Eeebuntu 3.0.1 NBR onto a USB stick and then onto your Eee 1000 using the same approach as described in my earlier blog post. Run Administration / Update Manager and make sure you have the latest updates installed.

I found the latest acpi utilities were showing up as grey on the Update Manager (it ends up with an interim version that doesn't handle the screen mode switching properly from the EeeControl tray icon). There was also some debris from the install. To fix this do:
$ sudo -s
# apt-get autoremove
# apt-get install eeepc-acpi-utilities

Install Dropbox

The Dropbox package available under Administration / Synaptic does not work with Eeebuntu 3.0.1. When I tried that I got an error:

The program 'dropbox' received an X Window System error.
This probably reflects a bug in the program.
The error was 'BadIDChoice (invalid resource ID chosen for this connection)'.
(Details: serial 722 error_code 14 request_code 53 minor_code 0)

There is a fix described here.
To make it work I downloaded nautilus-dropbox_0.6.1_i386_ubuntu_9.04.deb and http://dl.getdropbox.com/u/17/dropbox-lnx.x86-0.6.510.tar.gz then installed the patched version manually with:

$ sudo dpkg -i nautilus-dropbox_0.6.1_i386_ubuntu_9.04.deb
$ cd; rm -fr .dropbox-dist
$ tar xfz dropbox-lnx.x86-0.6.510.tar.gz
$ .dropbox-dist/dropbox --sync
(enter login details)

On a restart, Dropbox was integrated and working with Eeebuntu nautilus.

Install Blueman

To install Blueman you need to add their repository. Start a terminal session and type:
$ gpg --keyserver=wwwkeys.eu.pgp.net --recv-keys 6B15AB91951DC1E2
$ gpg --export --armor 6B15AB91951DC1E2 | sudo apt-key add -

Then go to Administration / Software Sources, click the Third Party Software tab and click "Add...". Where it says "APT line:" type in on one line:

deb http://ppa.launchpad.net/blueman/ppa/ubuntu jaunty main

Click 'Add Source', click Close, click Reload. Close the window.
Run Administration / Update Manager and apply updates and restart.
Run Administration / Synaptic Package Manager and search for and install "blueman".

Note - if you follow the instructions I gave in my previous blog for Ubuntu 8.10, you will get an older version of Blueman that gives a Python error complaining it cannot find 'Constants.py'. In that case, do an 'apt-get remove blueman' then follow the instructions above.

On the main menu select Preferences / Bluetooth Manager. If it prompts you to start Bluetooth, say Yes. Now do a Search and bond and trust with your INQ1. As mentioned in the previous blog, if you cannot see your phone check you have turned on bluetooth networking on the INQ1 phone:

menu Settings / Bluetooth = Switch - on ; Visibility - show your phone

menu Settings / Advanced / Connectivity / Modem Connect - via Bluetooth

In Blueman you should see your phone's name below the button bar. Click on it, then click the Setup button at the top. Choose Dialup Networking (DUN) and click Forward. It will prompt you to add a profile type. dropbox-lnx.x86-0.6.510.tar.gzSelect "3 (Handsets)". It should then connect to your phone and report a working connection. Try running menu Internet / Firefox and browsing to a website to test it.

If I find any more issues, I will add them to this blog.

YAPC::EU::2009 Lisbon

I'm back from the European Perl conference in Lisbon.

Man, that was fun. Lisboa is a great city, with plenty of tourist sights to see before the conference itself. I was staying in Hotel Alif, the main conference hotel, along with many other Perlmongers. The metro system was good and easy to use (wish I could say the same about London ;-) and it was simple getting to the conference venue at the Faculty of Sciences, Lisbon University.

The standard of talks this year was very high and I attended more than usual. In particular, I wanted to hear more about Moose the meta-object protocol based extension to Perl 5.

Moose in Perl 5.10 brings in the best language features of Perl 6, Common Lisp, Smalltalk, Java, Ruby etc. while still being compatible with older Perl 5 code such as the huge library at CPAN.

It lets you handle in a simple, powerful and intuitive way:

• classes
• data members and accessors
• method parameter signatures and type-checking (no more @_ unrolling)
• roles
• traits
• mix-ins

Giving shorter, easier-to-read and more expressive code that is much easier to maintain.

Moose's core features are now stable and production-ready and any self-respecting Perl 5 programmer should consider switching to using it as soon as possible.

Piers Cawley told us about how he moved from Perl to Ruby then was lured back to Perl by the cutting-edge language features that have been added to Perl 5. The joy of it was apparently enough to make him sing! Either that or is was the sight of beautiful teutonic youths ;-)

Yuval Kogman filled in the details of using Moose and some MooseX modules and is running a long best practices Moose training session today in the post-conference training slot.

Paul Fenwick of Perl Training Australia gave us a good run through of modern Perl programming using Moose and autobox with some interesting asides on autodie, PAR::Repository for automatic deployment and updating of applications, and application speed profiling using Devel::NYTProf.

To get you started with Moose I can recommend the Moose book by Dave Rolsky and Stevan Little.

Well done to the organisers, and I look forward to next year's event in Pisa, Italy.

Testing with Perl Catalyst

One of the things I really like about Catalyst is how easy it makes writing tests for your applications. There is documentation about testing in the Catalyst tutorial and a more generic book on Perl Testing. Going into more detail, I suppose I would classify these tests at several levels: Model unit, Controller unit, Integration, End-To-End.

Firstly, Model unit tests. The Model encapsulates business logic and access to data serialisation, typically via DBIx::Class Object-Relational Mapper to a database. Strictly speaking, these tests exist outside of Catalyst although you may need to pick up database access credentials from your Catalyst application configuration file (conf/myapp.yml or similar) using Config::JFDI. This replicates what Catalyst::Plugin::ConfigLoader does but works outside Catalyst.

Usually, I'd expect to start off with tests named 00_setup_database.t and zz_teardown_database.t. These create a known database before unit testing and then tear it down after. You can use a utility like DBIx::Class::Fixtures to do this.

Then I'd have 10_schema.t (and 11_schema2.t if I am using more than one schema) to test that I can connect to a database schema, that the sources (tables) are as expected and that I can retrieve a sample datum.

use Test::More tests => 4;  

BEGIN { use_ok 'MyApp::Model::MyModel' }  

BEGIN { use_ok 'MyApp::Schema' }   

my $connect_info = MyApp::Model::MyModel->config->{connect_info};  

diag "connecting schema2 to ".$connect_info->[0]."\n";  

my $schema = MyApp::Schema->connect( @$connect_info );   

my @sources = $schema->sources();  

ok( scalar @sources > 0, 'found schema sources :-  '.join(", ",@sources) );   

my $cl;  

ok($cl = $schema->resultset('Client')->find({ client_code => 'TEST01' }),

      'find client with code TEST01');  

ok ($cl->name eq 'A Test Client', 'client name as expected');

To this I'd add 20_user.t, 21_client.t (and so on), one per business object. Often these directly relate to a database table, but sometimes they can be a virtual class and use several tables with tricky logic built in, for example to calculate matching availability of resources over time. With a DBIx::Class schema you can do this and hide the details of the implementation inside the class or other classes it calls using a chained recordset approach. But back in the unit test, you'd test the public interface each schema class is exposing. For example, create a client record, then check to make sure subsidiary records have been created in other tables. Once you obtain a DBIC $schema handle, as above, the rest is straightforward.

Secondly, Controller unit tests. In the Catalyst world you use Catalyst::Test to achieve this. It sets up a fake Catalyst context so you can test actions. The manual page and the tutorial above explain this clearly so I won't go into detail. You add a unit test for each public action URL to ensure it dispatches to handlers as expected.

use Test::More tests => 2; 

BEGIN { use_ok 'Catalyst::Test', 'MyApp' } 

ok( request('/web/login')->is_success, 'Request should succeed' );

Thirdly, Integration testing. By this I mean running through some typical business workflow scenarios. In effect, expressing the functional requirements and specification of the system in the form of unit tests that will exercise the system as a whole (database, controller, model code, subsidiary library code, view templates).

For a web application (bear in mind Catalyst does not purely have to be used for writing web apps) you can use Test::WWW::Mechanize::Catalyst. This sets up a fake HTTP request object so you can test a sequence of actions as if you were going through a web server. So you might login, retrieve a list of records, view the detail for one of them, update a record, then check the list of records reflects that. After the WWW::Mechanize tests you could then check the database manually to ensure the records are as expected from the system functional specification.

use Test::More;   

eval "use Test::WWW::Mechanize::Catalyst 'MyApp'";  

plan $@ ? ( skip_all => 'Test::WWW::Mechanize::Catalyst required' )      

  : ( tests => 36 ); 

ok( my $mech = Test::WWW::Mechanize::Catalyst->new, 'Created mech object' );   

# logout screen redirects to login screen  

$mech->get_ok( 'http://localhost/web/logout', 'logout' );  

$mech->content_contains('Log on using', 'logout redirects to login screen'); 

diag "check login authentication is required to access extranet screens";  

# turn off automatic redirect follow so we can check response code  

$mech->requests_redirectable([]); 

# 1. check redirect code and location

$mech->get( 'http://localhost/web/extranet/list/booking' ); 

is($mech->response->headers->{status}, 302, 'unauthed user is redirected away from page requiring auth'); 

like($mech->response->headers->{location}, qw|/web/login/|, 'redirect is to login page');

# 2. check all protected paths 

for (qw|     index     home     booking     |) {
  my $path = '/web/extranet/'.$_;   
  $mech->get( 'http://localhost/'.$path);   
  is($mech->response->headers->{status}, 302, 'unauth redirect for '.$path); } 
# allow automatic redirect again  
$mech->requests_redirectable([qw/ GET HEAD POST /]); 
# 3. business workflow tests 
# get login screen  
$mech->get_ok( 'http://localhost/web/login', 'get login' );  
$mech->content_contains('Log on using', 'login contains Log on using');  
# login
$mech->submit_form( fields => { username => 'cust', password => 'cust' } );  
# check logged in successfully  
$mech->content_contains('Welcome to the', 'successfully logged in screen');  
diag "screen tests";  
$mech->get_ok( 'http://localhost/web/extranet/home', 'get home' );  
$mech->content_contains('Welcome to the', 'home contains welcome'); 
$mech->get_ok( 'http://localhost/web/extranet/list/booking', 'list/booking' ); 
$mech->content_contains('25843011', 'booking list contains booking 25843011');

Having written a range of unit tests then use Devel::Cover and run them all to check how well you have covered your code.

Fourthly, End-To-End testing. This is using a set of Integration tests to exercise the whole system in use by feeding in data and user actions and then checking the output data and files to make sure they are consistent. In the past, I worked on a meter reading and billing system and as part of a major release one of the tests was a manual one to set up a fixture database then type a set of pre-determined meter readings into the system from real remote handsets communicating over a WAN, process some batch runs in the central server, perform a few edits from the central server Oracle screens, then generate output billing records. You would expect the financial totals to be in balance and for selected bills to reflect the combination of the meter readings over a time period. Most systems are not that complex but the principle is to use real kit and real life scenarios. You might use several versions and releases of real web browsers against a copy of your live environment on a staging server and check the resulting screens, any PDFs generated and the figures totals on your database.

That's it for today. Happy testing!

Cheers, Peter

Complex databases with DBIx::Class

One thing that is tricky is combining the use of an Object-Relational Mapper, such as DBIx::Class or Rose::DB::Object with complex real world situations. Simple database queries are easy in SQL, but there's still a big gain from using an ORM to handle them as there are fewer lines of code and you can abstract away physical database changes to field names or relations without the calling code even knowing it has happened. Adding in complex joins and the use of database extensions inside triggers or stored procedures makes it difficult to get plain old SQL right, let alone in extra business methods to an ORM class that depend on the physical database structure and engine.

Here is where some examples come in handy.

Matt Trout has written a useful talk on how he implemented a combination of DBIx::Class ORM, custom queries and OO database extensions in a talk he gave to PostgreSQL WEST 2008 (note: requires Firefox to view).

The Catalyst Wiki MojoMojo implements a complex Entity-Relationship schema including hierarchical page nodes. It is well worth looking at the MojoMojo source code to see how it was done.

Catalyst Perl looking good

I have used Catalyst Perl to develop a number of sites such as recruitment extranets and shopping carts over the past 3 years. But how is it looking?

I would say:

Catalyst and the database Object Relational Mapper (ORM) DBIx::Class have really come of age.

Firstly, the ORM rocks. I was laughing to myself the other day at a conversation some Java programmers were having about using Hibernate and generating database accessor stubs. OMG, lots of extra lines of code you need to maintain and that can get out of date. And with an ActiveRecord style approach you don't get cool features that DBIx::Class has. To see why "Chained Result Sets are what make DBIC Great" check out jshirley's slideshow "Demystifying DBIx::Class". 

Then this week a colleague was asking about generating JSON from a Web REST-dispatching framework. He'd lashed together something with CGI::Application and Template::Toolkit. He could have just used the Catalyst plugin Catalyst::Controller::REST and his job would have been done in a few lines of code. You put in a few action handlers that correspond to your REST verbs, e.g. programme to handle a URI like /programme/id/123/keywords,  and then the framework dispatches them and generates JSON (or XML or YAML...) for you automatically. The number of lines of code correspond to how maintainable an application is, right? That's a no-brainer of a win for you right there.

Catalyst has evolved to become a scalable, reliable product and is now being used to run the BBC's iPlayer 2 site. Marina Kalkanis comments on how the BBC uses Catalyst to serve 1000 hits per second.

To finish off with here are a couple of new Catalyst Perl sites

http://www.catalyzed.org/about.html

http://catalyzed.ideascale.com/

Enjoy :)

Asus Eee 1000 Setup With Eeebuntu Linux and 3 INQ1 phone as a Bluetooth modem

I bought an Asus Eee 1000 40GB SSD Linux netbook in December 2008 to use for software development on the move. This article describes how I set it up with Eeebuntu Linux as a development environment and configured it to use an INQ1 mobile phone from three.co.uk as a Bluetooth broadband modem.

Why Three?

Three have the best 3G coverage in the UK and offer a cheap 18 month contract deal for phone and broadband access at £12 + £5 (for up to 5GB of data traffic) per month with a free INQ1 phone which you can use for bluetooth wireless broadband from an Eee. The INQ1 handles both 3G and HSDPA access and is an evolution of the 3 Skypephone, which you should also be able to use as a 3G modem following the instructions below.

Why Eee 1000?

The screen is big enough to watch movies, the battery lasts 8 hours (unlike an Acer Aspire, which was the other netbook I considered), its Atom processor is reasonably fast, the solid state disk means you can drop the netbook without breaking it and the keys are large enough for my big fingers. Plus it can run either Linux or Windows XP.

Xandros Linux

The Eee 1000 comes pre-installed with Asus' Xandros Linux, a proprietary Linux originally based on Debian. This is aimed at Linux novices and has an easy to use always-on full screen menu. It has extensions built in to handle hardware features of the Eee 1000 such as power-saving and keys for volume and to turn WiFi and Bluetooth on or off. Its /etc/apt/sources.list is set up to pull down updates and fixes from Asus's Xandros update repository.

Eee SSD

The 40GB solid state disk is shockproof and fast. You have the option to buy an Eee with a 120GB spinning disk, but this uses more power and is not as robust. The SSD is actually split into 32GB of user space and 8 GB of system restore space. The idea is if the user breaks their installed Linux, they can press F9 at boot time and re-image the 32GB partition with a fresh install of Xandros. This is a good idea for first time Linux users who might well break it once they start tinkering under the hood. You can also press F2 at boot time to enter the BIOS setup and configure hardware and boot options. It's possible you could format and mount the 8GB space as an extra partition using device /dev/sda1 though I haven't tried that yet.

Xandros Drawbacks

There are some major drawbacks to Asus' Xandros.

• The software versions installed, such as StarOffice, are rather old.

• The simplified netbook screen menu is restrictive for an experienced Linux user.

• Fatally, for a developer, installing the supplied Firefox update from Asus' repo installs a b0rked version of the libc6 library that breaks the dependencies required to later install the build-essential package using apt-get or the synaptic package manager. This means you don't have a C compiler.

Xandros Hacks

Experienced Linux users can get much information from the Eee wiki. For example, you can add a normal KDE menu popup by following the advanced desktop instructions. You can also add repos to access later debian software, provided you set up a pinning list to prevent the installation of packages incompatible with Xandros.

However, on my Eee 1000 (bought December 2008) I was unable to get the build-essentials package installed even following the instructions on the wiki about applying it before the Firefox 3 update. Perhaps the broken libc6 now comes pre-installed?

Installing Eeebuntu

Developers can solve this by installing Eeebuntu. At present this is Ubuntu 8.10 Intrepid with Eee hardware-specific extensions to support the on-board WiFi, bluetooth and the hot keys on the keyboard, for example to toggle the screen on and off. An alternative is Ubuntu-eee, now known as EasyPeasy. I couldn't see much to choose between them so went for Eeebuntu.

You don't need to worry about this going wrong and breaking your Eee. Simply backup any user files you want to keep onto a USB stick and then install Eeebuntu as follows. If it goes wrong, re-image the disk by pressing F9 at boot time, select recover and you will be back to Xandros.

1. Prepare USB stick with bootable Eeebuntu

You will need a USB stick with 1GB or more capacity. Following the instructions on this linked guide you can create a bootableEeebuntu USB stick from another Windows or Ubuntu PC. I've summarised the points below but check out the linked page for screenshots if you get stuck. There are three versions of Eeebuntu. I'd recommend NetBook Remix as the interface is optimised for the smaller screen of a netbook.

Download URL for eeebuntu NBR

Download URL for bootable imager

Insert the USB stick into your other PC, run the imager, select the .iso file you downloaded and leave it running for 10-15 minutes until complete. Remove the now-bootable USB stick.

2. Boot Eeebuntu from USB stick and try it out

Shut down your Eee 1000. Insert the USB stick. Press the Eee power on button. The Eee will now boot Eeebuntu off the USB stick and run it in memory (i.e. not off your solid state disk). If it boots off the SSD instead, try pressing F2 at boot time for the BIOS setup and go to Boot / Boot Device Priority and move [Removable Dev.] to the first position.

You can try out Eeebuntu and see whether you like the interface. Because it's running in memory, you can make any changes you like without it affecting your installed Xandros.

3. Install Eeebuntu

If you decide you like it, go to the Administration menu and choose install. Tell it to overwrite the whole of the 32GB SSD and not keep the existing Xandros partition.

4. Configure Eeebuntu To Boot Before Recovery Disk

After it finishes installing, select reboot and remove the USB stick. When the boot screen comes up, press F2 to enter the BIOS setup and go to Boot / Hard Disk Drives. You will see two SSD drives listed, the master 8GB partition [HDD:SM-ASUS-PHISON] and the slave 32GB partition [HDD:SS-ASUS-PHISON]. The “SM” one is the 8GB recovery disk. The “SS” is the 32GB disk where you just installed Eeebuntu. Select the SS one and move it up above the SM one in the order then press F10 to save and exit.

The Eee should now boot up into Eeebuntu and you will have to enter the first run configuration information of your name, location and desired user login/password.

Configuring Ubuntu

Download this free pocket guide to setting up and using Ubuntu: Ubuntu pocket guide (PDF)

That explains in detail how to use and administer Ubuntu. I've put some points below that will get you started and set up some useful utilities.

Root Access

To log on as root, run Accessories / Terminal and type

$ sudo bash

Alternatively, you can add a root terminal to the menu with: System / Control Centre – Section Look and Feel / Main Menu, go to System Tools and tick Root Terminal

Repository Settings

For reference, here is a record of the settings I have in /etc/apt/sources.list:

deb http://gb.archive.ubuntu.com/ubuntu/ intrepid main restricted   deb-src http://gb.archive.ubuntu.com/ubuntu/ intrepid main restricted   deb http://gb.archive.ubuntu.com/ubuntu/ intrepid-updates main restricted   deb-src http://gb.archive.ubuntu.com/ubuntu/ intrepid-updates main restricted    deb http://gb.archive.ubuntu.com/ubuntu/ intrepid universe   deb-src http://gb.archive.ubuntu.com/ubuntu/ intrepid universe   deb http://gb.archive.ubuntu.com/ubuntu/ intrepid-updates universe   deb-src http://gb.archive.ubuntu.com/ubuntu/ intrepid-updates universe    deb http://gb.archive.ubuntu.com/ubuntu/ intrepid multiverse   deb-src http://gb.archive.ubuntu.com/ubuntu/ intrepid multiverse   deb http://gb.archive.ubuntu.com/ubuntu/ intrepid-updates multiverse   deb-src http://gb.archive.ubuntu.com/ubuntu/ intrepid-updates multiverse    deb http://security.ubuntu.com/ubuntu intrepid-security main restricted   deb-src http://security.ubuntu.com/ubuntu intrepid-security main restricted   deb http://security.ubuntu.com/ubuntu intrepid-security universe   deb-src http://security.ubuntu.com/ubuntu intrepid-security universe   deb http://security.ubuntu.com/ubuntu intrepid-security multiverse   deb-src http://security.ubuntu.com/ubuntu intrepid-security multiverse   deb http://linux.getdropbox.com/ubuntu intrepid main   deb-src http://linux.getdropbox.com/ubuntu intrepid main    deb http://ppa.launchpad.net/blueman/ubuntu intrepid main   deb-src http://ppa.launchpad.net/blueman/ubuntu intrepid main 

Install BootUp Manager

Run System / Administration / synaptic and install the “bum” package.

Using Eee control

Run System / Administration / BootUp Manager and set eee-control to run at run levels 3, 4 and 5. Start it now if not already running with Start / System Tools / Eee Control and an icon labelled “Eee” will appear in the top right menu bar.

To turn on/off WiFi and Bluetooth, move the mouse over the Eee icon, click once, then tick/untick options in the popup menu. To map keys, right click the Eee icon, select Preferences and map the special Eee 1000 keys to functions such as Bluetooth toggle. I found it useful to map Fn-F8 to "gnome-terminal" so I can press Fn and F8 together to start a command shell.

Install drop box

Dropbox is a file synchronisation utility that lets you store files in a secure, encrypted folder on the web that is reflected in a local copy on all the PCs you use. It's an easy way to share files between, say, a mobile netbook and a work PC without having to remember to copy files manually. It works on Windows, Linux and Mac.

Go to this link and follow the download for Linux: https://www.getdropbox.com/install

You want the Ubuntu 8.10 (x86) version. Once downloaded, either use the file explorer to navigate to your home directory and then the Desktop sub-directory and click on the nautilus-dropbox_0.5.0-1_i386_ubuntu_8.10.deb file to install it, or from a root shell go to your Desktop directory and type

# dpkg -i  nautilus-dropbox_0.5.0-1_i386_ubuntu_8.10.deb

Follow the instructions and you will end up with a Dropbox folder in your home directory. Anything you put in there will now be synced to the web storage and to any other PCs on which you have installed dropbox.

Install development tools

Run System / Administration / synaptic.

Install your preferred tools, e.g. apache, java, php, mysql / postgres, phpmyadmin, perl, python.

Set up INQ1 as a Bluetooth Modem

The stock bluez package does not give enough control over the bluetooth connection to set up dial up networking using a INQ1 or Skypephone as a broadband modem. However, blueman does so we will use that instead.

Install blueman

import repo key

# wget http://download.tuxfamily.org/blueman/blueman.gpg # apt-key add blueman.gpg

add repos using either Administration / Software Sources or by adding to /etc/apt/sources.list

  deb http://ppa.launchpad.net/blueman/ubuntu intrepid main   deb-src http://ppa.launchpad.net/blueman/ubuntu intrepid main

then install blueman with the command

# apt-get install blueman

if it says it wants to uninstall bluez or bluez-compat say 'yes'.

Configuration steps

1. Recognise bluetooth phone

Run Accessories / Blueman Bluetooth Manager. Click the "Scan for bluetooth devices" button. Your phone should appear in the list of names.

If not, check that you have turned on bluetooth networking on the INQ1 phone:

menu Settings / Bluetooth = Switch - on ; Visibility - show your phone

menu Settings / Advanced / Connectivity / Modem Connect - via Bluetooth

Click on the phone in the list of names. Click the padlock symbol to bond to it. Your phone should report a connection attempt from your Eee. Accept and enter a PIN there. On your Eee Blueman should ask you to repeat that PIN there. Then it should show as bonded. On the INQ1 set the Eee as an authorised device that it will remember.

Set up bluetooth phone as a dial-up networking service

Run Accessories / Blueman Bluetooth Manager. Click menu Edit / Services. After "serial" click the red button to turn it green if not already so. Click the configure button to the right of that. On the Serial Service screen click the Add New Serial Port checkbox. From the Host dropdown select your bluetooth phone's name. Click the Refresh icon next to the Service dropdown. Then click the dropdown and select Dial-up Networking. Tick the box next to "This is a GSM/GPRS/EDGE/3G dialup connection". Click Add Port. Back on the Service screen tick Autostart after the Serial service's green button.

Configure dialup networking service using bluetooth

Run Preferences / Network Configuration. Click the Mobile Broadband tab. Click Add to start the add wizard. Click Forward. Choose provider "3" and click Forward. Click Apply.

Some people have reported better performance by editing the settings for the connection and going to the IPv4 Settings tab and entering hard-coded DNS servers as: 208.67.222.222, 208.67.220.220.

Testing

Unplug any wired Ethernet. From the Eee control icon in the top right toolbar (the icon says "Eee") click and disable WiFi and enable Bluetooth in the hardware. Run Accessories / Blueman to start bluetooth services. Click the network icon in the top right toolbar (looks like two overlapping PCs) and click the name of the bluetooth service "3" to start connecting. After about 10 seconds it should report as connected. Try browsing to a page in Firefox to verify it works.

Finally, you might want to set blueman to run at boot time using the BootUp Manager as blueman needs to be running for you to be able to see bluetooth dialup options on the network icon.

Finish

That's it! You should have an Eee 1000 you can use for development on the move using an INQ1 for Internet connectivity. If you have any corrects or comments please add them below the blog and I'll update this guide.