Friday 14 September 2012

Mini210S has now got a wiki!

Armworks have put up a wiki for it's devices, you can find it here.  It's a mediawiki based site, so it should be familiar to anyone that's used elinux or any other mediawiki based wiki.

You can jump straight to the mini210S pages here, I've spent a few days adding content with tutorials on things I've managed to discover since I got my lovely mini210S in the post :)  I'm sure over the coming weeks and months the mini210S page will fill out nicely with community contributed code, projects and information.

I will probably start to do a mixture of wiki posts and link back to them here with a bit of background around the tutorial/how to, makes sense rather than blogging about it then having to reformat it for the wiki as well.

The tutorials to note so far are:
How to burn a rootfs image to nand
How to root Android 4.0.3 on the mini210S
How to install google apps into the android 4.0.3 img and burn to nand
How to install google apps on the mini210S Android 4.0.3
How to access android debug bridge via tcpip

Burning your own rootfs to nand is obviously going to be a useful skill :D  FriendlyArm provided a prebuilt rootfs for us, so if you haven't got the time or inclination to build your own, you can just dump your working project binaries and scripts into a known working rootfs and just test them out.  Of course once you work out how to build your own rootfs you can make your own from scratch and burn it quite easily.

Rooting Android 4.0.3 seems odd that you'd have to root a development device until of course you consider it's 'rooted' from a development point of view but not rooted from an end user viewpoint.  so if you want to run around android treating it like you would any other device that you own, then you'll want to root it :)  Of course this won't be the case if you're doing an installation of some kind, so use this with caution as rooting has serious security implications.

Google Apps, there are a couple tutorials for getting google apps. onto a mini210S, if you're developing android software on a mini210S, you're probably going to want some kind of access to google play (formally android market) this has to be done by installing google apps (gapps), if you are 'into' using google's web software then you will need to install google apps.  Google apps. provides youtube, gmail, maps, play apps. for android, unfortunately the mini210S doesn't have them installed as standard so we have no way of installing them normally, so a tutorial is needed, I did 2, to cover 2 different methods.

Android debug Bridge via tcp/ip, this tutorial gives a quick and simple way to connect to adb on the mini210S via LAN/Wifi, saves digging around for a usb cable and could end up being a very powerful remote debugging feature, works nicely on a standard home network, I wonder how well it would cope across the internet?

There's also a tutorial on installing flash player on the mini210S, only really of any interest to UK mini210S owners, I did this one so that I could watch iplayer through the mini210S :D

They are mainly Android tutorials at the moment, should have more linux tutorials coming up.  I will also have some info on booting the kernel and rootfs from an SD card soon too!!

Sunday 9 September 2012

Mini210S, flash player, iplayer and google play

I live in the UK, so I get access to bbc TV/Radio video/audio streaming services for free via their iPlayer service, this needs adobe flash player, unfortunately, flash player isn't installed on the 210S and we don't have access to the android market/google play.  Follow these instructions to quickly and simply install adobe flash player on the mini210S.

1. go to the adobe flashplayer archives and download a version appropriate for the version of android, http://helpx.adobe.com/flash-player/kb/archived-flash-player-versions.html I downloaded the latest version (Flash Player 11.1.for Android 4.0 (11.1.115.17)) as I have android 4.0.3 (Ice cream Sandwich) installed.

2. Save it to the Download dir on your SD card, using the ES file explorer, browse to the Download folder on the card, tap on install_flash_player_ics.apk, (if it complains about not being set to install apps that aren't downloaded from the android market, click on the settings button and scroll down and make sure 'unknown sources' is ticked, then press the back button and try again!).

3. once it's installed you can click done or open, if you click open, it will open the web browser and take you to the flash settings page, it was oversized on my LCD, so I don't think it was showing me the whole screen, probably something to do with screen pixel density maybe?  Either way, you should see something legible on screen, if all you see is a little block with a ? in it, then something went wrong somewhere and I have no idea where :D

If everything went ok and you're in the UK you can test flashplayer by going to http://www.bbc.co.uk/mobile/iplayer and play a tv show. 

Obviously this will use data, make sure you use it via wifi or it will use up your download quota if you're connected via mobile networks!! 

You can still test it by doing going to the shows page but don't actually play the video, if it's working you will see all of the user controls and the video itself, if it's not working you will probably see the blue box with the ? in it or just a black area.

Unfortunately, android and flash player is a well trodden subject on the internet, you will find many forum posts on the subject and many apk files to download, I tried loads of different methods until I stumbled across the the developer archive!!  I think this is probably going to be a bit of a commonly recurring theme while trying to track down issues with android.

Another unfortunate thing with the mini210S at the time of writing, there is no google play/android market support, it appears there are chinese app market tools on the device but nothing to cater for the continental markets.  For the time being at least we will probably have to use an alternative market, it's been suggested to me to use this:

http://www.1mobile.com/app/market/

I haven't tried it myself yet but it will do until I can work out how to get 'gapps' (google applications) installed on the mini210S, which will give us gmail and other google associated goodies including access to the market.

Burning an OS image to the nand of the mini210S

I decided it was about time I played with linux on the mini210S, so I used the user manual guide to burn linux to the nand and this is what I found out :)

things you will need
  • 1x micro SD card (4GB recommended, backup any data on teh card before starting, if you're on vista/win7 it will wipe the card)
  • 1x mini210S dvd iso downloaded from the friendlyarm ftp, opened in your favorite iso mounter/editing app or burned to dvd
  • 1x Windows PC
They recommend to use a 4GB sd card, formatted to fat32, this is purely for card compatibility, in reality, the images folder on the mini210S dvd iso is under 1GB in size, so if you've only got a 1GB card, it's worth a try :)
 
 
Burning Superboot to the SD card
 
Make sure that your SD card is formatted to fat32 and backed up before you start!

Go to the tools\ directory on the mini210S dvd, if you're using win7/vista, right click on SD-Flasher.exe and choose 'run as administrator', i you're using XP, just run the app. as normal, in the small window that pops up, click the radio button next to 'mini210S' then click 'next'.

You will now see the main window of the SD-Flasher app, click on the button with '...' on it, browse to the mini210S dvd, then go into the images folder, then select the superboot210.bin file and click the open button. SD-Flasher needs this file to be able to burn it to your SD card.

Next click on the 'Scan' button, after a few seconds, the section marked 'SD Drive(s)' will become populated with your SD cards details.  If you're on XP you can skip this step and just go onto the next one, if you're on Vista/win7 then continue reading.  For vista/win7 we need to use a slightly different method to get superboot210.bin burnt to the SD card, so click on the 'ReLayout!' button, this will wipe all of the data from the card, click 'yes' if you've backed your data up or it's a freshly formatted card. Click on the 'Scan' button again and you should see your card again.

This next step is the same for XP or win7/vista, simply click on the 'Fuse' button to burn superboot210.bin to the SD card.  That's it for burning superboot to the SD card, the next step is to copy the necessary files to burn linux to the nand onto the SD card.

Dumping the image files onto the SD card
 
In the manual, it suggests that you can test whether you burnt superboot to the SD card by putting it into the  uSD socket, flipping the boot mode switch (left hand switch as the ethernet port faces you) and it should show you 2 flashing leds when you boot, which didn't happen in my case, all I got was a screaming banshee, which I believe indicates either a card not present, or no valid images files found.
 
The manual also says to dump the whole images folder onto your SD card but we're only messing with linux, so we don't need all the extra stuff :)

On your SD card fat32 partition, create a folder called images, next open the images folder on your mini210S dvd iso, select the linux folder, superboot210.bin and friendlyarm.ini, copy them and paste them into the SD card images folder.

Setting up friendlyarm.ini to install linux

We're nearly done, now all we need to do is setup the friendlyarm.ini file so that superboot burns the image onto nand, so go to your sd card and open \images\friendlyarm.ini in your favourite text editor.
As far as I know, superboot only works with one image at a time, so we're just concentrating on linux, only thing to do is change line 5 from:
 
OS = Android
to:
OS = Linux

Save friendlyarm.ini and close your text editor.

That's it for setting up the SD card.  I believe the methods are slightly different for android and win ce, with winCE you have the option to run the image from SD card instead of burning (I think), for Android, depending on which version you want to install, 2.3 or 4.0.3, you'll have to comment out the irrelevant android section in the friendlyarm.ini file.

 Burning it all to nand

Now we've setup the SD card with superboot where the bootloader can find it, got the kernel zImage and and rootfs image where superboot can find it, it's time to burn it all to nand, fun times!

Make sure the mini210S is turned off, insert your uSD card into the uSD socket, switch S2 to SD (left hand side switch, switched to the back) and power on the mini210S, you should hear a quick beep.

You will now be presented with superboot, giving you various information about the mini210S (cpu, ram, nand, TS and LCD type), at this point the burning process is totally automatic, you should see it quickly burn superboot and the zImage to nand, then it will start burning the rootfs image, this will take some time, you should see the progress bar fill up, you will also notice that the led 4 is flashing and as the progress bar goes over 25%, 50%, 75%, it will make a led go solid and start to flash the next one until it's finished.

Once the burning process has finished, the mini210S will beep twice and you will see some instructions in yellow on the lcd, you will also notice that your mini210S is now doing a knightrider impression!

Testing it worked
 
Follow the instructions on screen and switch S2 back to nand boot mode and power cycle the mini210S, after a few seconds you will be greeted with Tux, after about 25 seconds, you will see a few services go live on the lcd and then you should be presented with the TS calibration screen, as is standard with these devices, touch the calibration points (boxes with crosshairs in them!) one by one to calibrate the touchscreen.

Next up pick your language (You can have any language you like apparently, as long as it's english:us :D), setup the time and timezone and you're done.

Changing the language
 
You should now be presented with a window with a number of tabs, unfortunately, it's all in chinese, as I'm english I needed to change the language.

To do this yourself, tap on the 2nd tab, then using the scroll bar, scroll down, until you can see a icon that has a chinese flag over the top of a british flag and tap it, in the app. that opens, click on your preferred language (english, chinese or japanese), then click OK, qtopia will now restart and you should now be able to see all the tabs and icons in your chosen language.

That's about it for my testing, the rest is down to you to have a look around in the menus and see what it can do, don't forget to refer back to the manual for more information about the apps/options that you can configure.