Archos gen8: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
[[Category:Devices]]<br />[toc align_right=&quot;yes&amp;quot; depth=&quot;3&amp;quot;]
[[Category:Devices]]
[toc align_right="yes" depth="3"]


The Archos gen8 tablets come with Android, but can be turned into complete Embedded Linux development platforms with the installation of the Special Developer Edition (SDE) firmware provided by Archos. They make a powerful development device with all the necessary peripherals and in an elegant packaging.
The Archos gen8 tablets come with Android, but can be turned into complete Embedded Linux development platforms with the installation of the Special Developer Edition (SDE) firmware provided by Archos. They make a powerful development device with all the necessary peripherals and in an elegant packaging.


&quot;KDAB&amp;quot;:http://www.kdab.com provides an open-source SDK for Qt4 (4.8.3-Lighthouse) and Qt5-beta1 development on the device, as well as BSPs with support for linuxfb and EGLFS, multi-touch input, remote debugging, and more.
"KDAB":http://www.kdab.com provides an open-source SDK for Qt4 (4.8.3-Lighthouse) and Qt5-beta1 development on the device, as well as BSPs with support for linuxfb and EGLFS, multi-touch input, remote debugging, and more.


== Archos gen8 70/101IT: Device Information ==
== Archos gen8 70/101IT: Device Information ==
Line 44: Line 45:
== Software Developer Edition Firmware ==
== Software Developer Edition Firmware ==


First you need to install the SDE firmware, which will enable the &quot;Developer mode&amp;quot; on the tablet. The firmware download and instructions can be found on the Archos website: http://www.archos.com/support/support_tech/updates_dev.html?country=us&amp;amp;lang=en
First you need to install the SDE firmware, which will enable the "Developer mode" on the tablet. The firmware download and instructions can be found on the Archos website: http://www.archos.com/support/support_tech/updates_dev.html?country=us&amp;amp;lang=en


Install the .aos file by following the instructions, you'll only need to do this once. Note that the SDE firmware doesn't erase the original Android image on the tablet, it just acts like a dual-boot.
Install the .aos file by following the instructions, you'll only need to do this once. Note that the SDE firmware doesn't erase the original Android image on the tablet, it just acts like a dual-boot.
Line 56: Line 57:
== Embedded Linux BSP and Qt SDK ==
== Embedded Linux BSP and Qt SDK ==


The SDK and BSPs are based on an &quot;Ångström distribution&amp;quot;:http://www.angstrom-distribution.org/ and built with &quot;OpenEmbedded&amp;quot;:http://www.openembedded.org/wiki/Main_Page using an overlay from Archos for the tablets.
The SDK and BSPs are based on an "Ångström distribution":http://www.angstrom-distribution.org/ and built with "OpenEmbedded":http://www.openembedded.org/wiki/Main_Page using an overlay from Archos for the tablets.


KDAB maintains an updated clone of the OpenEmbedded repository with the Archos overlay applied, and built-in support for Qt4 and Qt5, hosted on GitHub:
KDAB maintains an updated clone of the OpenEmbedded repository with the Archos overlay applied, and built-in support for Qt4 and Qt5, hosted on GitHub:


&quot;OpenEmbedded-Archos&amp;quot;:http://github.com/KDAB/OpenEmbedded-Archos
"OpenEmbedded-Archos":http://github.com/KDAB/OpenEmbedded-Archos


=== Supported Qt versions ===
=== Supported Qt versions ===
Line 91: Line 92:
You'll need the following packages installed before you start building:
You'll need the following packages installed before you start building:


<code><br />sudo apt-get install bitbake sed wget cvs subversion git-core  coreutils unzip texi2html texinfo docbook-utils  gawk python-pysqlite2 diffstat help2man make gcc build-essential g++  desktop-file-utils chrpath zlib1g-dev dpkg-dev libxml-parser-perl<br /></code>
<code>
sudo apt-get install bitbake sed wget cvs subversion git-core  coreutils unzip texi2html texinfo docbook-utils  gawk python-pysqlite2 diffstat help2man make gcc build-essential g++  desktop-file-utils chrpath zlib1g-dev dpkg-dev libxml-parser-perl
</code>


For other distributions, see http://www.openembedded.org/wiki/OEandYourDistro for details and equivalent command lines.
For other distributions, see http://www.openembedded.org/wiki/OEandYourDistro for details and equivalent command lines.


You also need to check that /bin/sh (ls -l /bin/sh) is not symbolically linked to dash. &quot;dash&amp;quot; is a POSIX compliant shell that is much smaller than &quot;bash&amp;quot; — however some broken shell scripts still make use of bash extensions while calling into /bin/sh.
You also need to check that /bin/sh (ls -l /bin/sh) is not symbolically linked to dash. "dash" is a POSIX compliant shell that is much smaller than "bash" — however some broken shell scripts still make use of bash extensions while calling into /bin/sh.


To work around this issue run <code>sudo dpkg-reconfigure dash<code> and select No when it asks you to install dash as /bin/sh.
To work around this issue run <code>sudo dpkg-reconfigure dash<code> and select No when it asks you to install dash as /bin/sh.
Line 103: Line 106:
It couldn't be simpler:
It couldn't be simpler:


</code><br />git clone -b qt5 git<code>github.com:KDAB/OpenEmbedded-Archos.git<br />cd OpenEmbedded-Archos<br />./build.sh<br /></code>
</code>
git clone -b qt5 git@github.com:KDAB/OpenEmbedded-Archos.git
cd OpenEmbedded-Archos
./build.sh
<code>


To build a Qt 4.8.3 image instead of Qt5, just replace &quot;-b qt5&amp;quot; with &quot;<s>b qt4&amp;quot;
To build a Qt 4.8.3 image instead of Qt5, just replace "-b qt5" with "-b qt4"
<br />h3. Build results
 
<br />Once the build has completed, you'll find the results in the build folder located in '''../build-archos-gen8''' relative to the source dir:
h3. Build results
<br />'''''' '''tmp/deploy/glibc/images/archos-gen8''': Images for kernel+initramfs+rootfs<br />'''''' '''tmp/cross/armv7a/bin''': Cross-toolchain (compiler, linker, debugger, etc.)<br />'''''' '''tmp/staging/armv7a-angstrom-linux-gnueabi''': cross-compiled tools and libraries, the Qt ones in particular. This is where you would find the qmake to add in Qt Creator.<br />'''''' '''tmp/rootfs''': the contents of the rootfs image as a folder structure (useful for troubleshooting issues with the generated rootfs images)<br />'''''' '''tmp/work''': build folders for the packages
 
<br />Note that you need to rename the image files when copying them to the tablet:
Once the build has completed, you'll find the results in the build folder located in '''../build-archos-gen8''' relative to the source dir:
<br />'''''' '''Kernel''': zImage</s>'''.bin <s>&gt; zImage<br />'''''' '''Initramfs''': initramfs</s>'''.cpio.gz <s>&gt; initramfs.cpio.gz<br />'''''' '''Rootfs''': Archos-image*.ext3</s>&gt; rootfs.img
 
'''''' '''tmp/deploy/glibc/images/archos-gen8''': Images for kernel+initramfs+rootfs
'''''' '''tmp/cross/armv7a/bin''': Cross-toolchain (compiler, linker, debugger, etc.)
'''''' '''tmp/staging/armv7a-angstrom-linux-gnueabi''': cross-compiled tools and libraries, the Qt ones in particular. This is where you would find the qmake to add in Qt Creator.
'''''' '''tmp/rootfs''': the contents of the rootfs image as a folder structure (useful for troubleshooting issues with the generated rootfs images)
'''''' '''tmp/work''': build folders for the packages
 
Note that you need to rename the image files when copying them to the tablet:
 
'''''' '''Kernel''': zImage-'''.bin -> zImage
'''''' '''Initramfs''': initramfs-'''.cpio.gz -> initramfs.cpio.gz
'''''' '''Rootfs''': Archos-image*.ext3-> rootfs.img


=== Deploying to the tablet ===
=== Deploying to the tablet ===


The tablet is flashed in two steps: you flash a kernel+initramfs first, and then the rootfs in a second step.<br />Afterwards, you can then flash them independently of each other. Usually you'll only flash the rootfs, since the kernel+initramfs rarely change.
The tablet is flashed in two steps: you flash a kernel+initramfs first, and then the rootfs in a second step.
Afterwards, you can then flash them independently of each other. Usually you'll only flash the rootfs, since the kernel+initramfs rarely change.


==== Flashing the kernel and initramfs ====
==== Flashing the kernel and initramfs ====


# In the SDE menu, go to &quot;Recovery System&amp;quot; <s>&gt; &quot;Developer Edition Menu&amp;quot;</s>&gt; &quot;Flash kernel and initramfs&amp;quot;
# In the SDE menu, go to "Recovery System" -> "Developer Edition Menu"-> "Flash kernel and initramfs"
# Plug the board to your computer, and mount the drive from the newly recognized device (normally called 101IT_REC)
# Plug the board to your computer, and mount the drive from the newly recognized device (normally called 101IT_REC)
# Copy both zImage and initramfs.cpio.gz on the mounted partition, directly at the root
# Copy both zImage and initramfs.cpio.gz on the mounted partition, directly at the root
Line 125: Line 144:
==== Flashing the rootfs ====
==== Flashing the rootfs ====


# In the SDE menu, go to &quot;Recovery System&amp;quot; <s>&gt; &quot;Repair System&amp;quot;</s>&gt; &quot;Start USB MSC&amp;quot;
# In the SDE menu, go to "Recovery System" -> "Repair System"-> "Start USB MSC"
# Plug the board to your computer, and mount the drive from the newly recognized device (normally called 101IT)
# Plug the board to your computer, and mount the drive from the newly recognized device (normally called 101IT)
# Copy rootfs.img on the mounted partition, directly at the root
# Copy rootfs.img on the mounted partition, directly at the root
Line 132: Line 151:
== SSH access to the tablet ==
== SSH access to the tablet ==


The tablet has the USB (slave) port set up with Ethernet-over-USB, using the g_ether gadget. See &quot;this page&amp;quot;:http://wiki.maemo.org/USB_networking for additional info and how to set up the network interface on the host computer.
The tablet has the USB (slave) port set up with Ethernet-over-USB, using the g_ether gadget. See "this page":http://wiki.maemo.org/USB_networking for additional info and how to set up the network interface on the host computer.


=== Interface setup ===
=== Interface setup ===


The interface on the tablet is set up with the static address '''192.168.0.202'''.<br />You should set up the usb0 interface on the host by adding the following to '''/etc/network/interfaces''':
The interface on the tablet is set up with the static address '''192.168.0.202'''.
You should set up the usb0 interface on the host by adding the following to */etc/network/interfaces''':


<code><br />auto usb0<br />iface usb0 inet static<br /># note: this is the ip address on the host side, not on the tablet<br /> address 192.168.0.201<br /> netmask 255.255.255.0<br /></code>
</code>
auto usb0
iface usb0 inet static
# note: this is the ip address on the host side, not on the tablet
address 192.168.0.201
netmask 255.255.255.0
<code>


No DCHP server is required.
No DCHP server is required.
Line 146: Line 172:
Once set up, you can connect to the tablet with the following credentials:
Once set up, you can connect to the tablet with the following credentials:


'''''' Username: '''root'''<br />'''''' Password: ''&lt;no password&amp;gt;''
'''''' Username: '''root'''
'''''' Password: ''<no password>''


== Creating a redistributable Qt SDK ==
== Creating a redistributable Qt SDK ==


You can also create a redistributable SDK package by running the '''pack-sdk.sh''' script.<br />The script creates an archive '''archos-gen8-sdk.tar.gz''' in the build folder at the top level. This archive contains two folders:<br />'''''' '''toolchain''': contains the compiler and associated tools for cross-compiling applications for the tablet<br />'''''' '''sysroot''': contains the Qt libraries, headers, qmake, and all the dependencies for the tablet
You can also create a redistributable SDK package by running the '''pack-sdk.sh''' script.
The script creates an archive '''archos-gen8-sdk.tar.gz''' in the build folder at the top level. This archive contains two folders:
'''''' '''toolchain''': contains the compiler and associated tools for cross-compiling applications for the tablet
'''''' '''sysroot''': contains the Qt libraries, headers, qmake, and all the dependencies for the tablet


== Installing the redistributable Qt SDK ==
== Installing the redistributable Qt SDK ==
Line 156: Line 186:
In addition to extracting the archive, you must run the '''setup-sdk.sh''' script, which sets up the proper paths in the toolchain and for Qt itself:
In addition to extracting the archive, you must run the '''setup-sdk.sh''' script, which sets up the proper paths in the toolchain and for Qt itself:


<code><br />tar xzf archos-gen8-sdk-qt5.tar.gz<br />cd archos-gen8-sdk<br />./setup-sdk.sh<br /></code>
</code>
tar xzf archos-gen8-sdk-qt5.tar.gz
cd archos-gen8-sdk
./setup-sdk.sh
<code>

Revision as of 10:10, 25 February 2015

[toc align_right="yes" depth="3"]

The Archos gen8 tablets come with Android, but can be turned into complete Embedded Linux development platforms with the installation of the Special Developer Edition (SDE) firmware provided by Archos. They make a powerful development device with all the necessary peripherals and in an elegant packaging.

"KDAB":http://www.kdab.com provides an open-source SDK for Qt4 (4.8.3-Lighthouse) and Qt5-beta1 development on the device, as well as BSPs with support for linuxfb and EGLFS, multi-touch input, remote debugging, and more.

Archos gen8 70/101IT: Device Information

Architecture *ARMv7a*
CPU Cortex A8
RAM 512MB (shared)
GPU PowerVR SGX530
OpenGL OpenGL ES 2.0
Screen Resolution (101IT) 1024x600 pixels (WXVGA), 10.1 TFT LCD
Screen Resolution (70IT) 800 x 480 pixels (WVGA), 7 TFT LCD
Touch Screen Capacitive multitouch screen
Peripherals G-Sensor, Front VGA camera, Built-in Microphone and Speaker
Networking Wi-fi, Ethernet-over-USB
Interfaces USB slave+host, MicroSD, MiniHDMI

Software Developer Edition Firmware

First you need to install the SDE firmware, which will enable the "Developer mode" on the tablet. The firmware download and instructions can be found on the Archos website: http://www.archos.com/support/support_tech/updates_dev.html?country=us&amp;lang=en

Install the .aos file by following the instructions, you'll only need to do this once. Note that the SDE firmware doesn't erase the original Android image on the tablet, it just acts like a dual-boot.

NOTE: You only need to download the .aos file, you don't need to download the modifications applied to the Angstrom distribution, as they have already been applied to the OpenEmbedded-Archos repository.

Once this is done, you can now boot the tablet in Developer Mode:

With the tablet turned off, press the power button with the volume-down button pressed, a few seconds after the Archos logo shows up you should now get to a white menu screen with various options.

Embedded Linux BSP and Qt SDK

The SDK and BSPs are based on an "Ångström distribution":http://www.angstrom-distribution.org/ and built with "OpenEmbedded":http://www.openembedded.org/wiki/Main_Page using an overlay from Archos for the tablets.

KDAB maintains an updated clone of the OpenEmbedded repository with the Archos overlay applied, and built-in support for Qt4 and Qt5, hosted on GitHub:

"OpenEmbedded-Archos":http://github.com/KDAB/OpenEmbedded-Archos

Supported Qt versions

The Archos gen8 tablet supports:

  • Qt 4.8.3 with the QPA (Lighthouse) embedded architecture
  • Qt 5.0.0-beta1

Included modules

  • qtbase
  • qtdeclarative
  • qtjsbackend
  • qtmultimedia
  • qtsensors
  • qtxmlpatterns
  • qt3d

Pre-built images and toolchains

Complete target images for Qt4 and Qt5, including kernel+initramfs+rootfs, as well as matching SDKs with toolchain and sysroot can be downloaded from github:

https://github.com/KDAB/OpenEmbedded-Archos/downloads

Build prerequisites

The BSP has been built and tested on Ubuntu 12.04 only. Other versions and distros may or may not work.

You'll need the following packages installed before you start building:

sudo apt-get install bitbake sed wget cvs subversion git-core  coreutils unzip texi2html texinfo docbook-utils  gawk python-pysqlite2 diffstat help2man make gcc build-essential g++  desktop-file-utils chrpath zlib1g-dev dpkg-dev libxml-parser-perl

For other distributions, see http://www.openembedded.org/wiki/OEandYourDistro for details and equivalent command lines.

You also need to check that /bin/sh (ls -l /bin/sh) is not symbolically linked to dash. "dash" is a POSIX compliant shell that is much smaller than "bash" — however some broken shell scripts still make use of bash extensions while calling into /bin/sh.

To work around this issue run

sudo dpkg-reconfigure dash<code> and select No when it asks you to install dash as /bin/sh.

=== Building the BSP and Qt SDK ===

It couldn't be simpler:

git clone -b qt5 git@github.com:KDAB/OpenEmbedded-Archos.git cd OpenEmbedded-Archos ./build.sh

To build a Qt 4.8.3 image instead of Qt5, just replace "-b qt5" with "-b qt4"

h3. Build results

Once the build has completed, you'll find the results in the build folder located in '''../build-archos-gen8''' relative to the source dir:

'''''' '''tmp/deploy/glibc/images/archos-gen8''': Images for kernel+initramfs+rootfs
'''''' '''tmp/cross/armv7a/bin''': Cross-toolchain (compiler, linker, debugger, etc.)
'''''' '''tmp/staging/armv7a-angstrom-linux-gnueabi''': cross-compiled tools and libraries, the Qt ones in particular. This is where you would find the qmake to add in Qt Creator.
'''''' '''tmp/rootfs''': the contents of the rootfs image as a folder structure (useful for troubleshooting issues with the generated rootfs images)
'''''' '''tmp/work''': build folders for the packages

Note that you need to rename the image files when copying them to the tablet:

'''''' '''Kernel''': zImage-'''.bin -> zImage
'''''' '''Initramfs''': initramfs-'''.cpio.gz -> initramfs.cpio.gz
'''''' '''Rootfs''': Archos-image*.ext3-> rootfs.img

=== Deploying to the tablet ===

The tablet is flashed in two steps: you flash a kernel+initramfs first, and then the rootfs in a second step.
Afterwards, you can then flash them independently of each other. Usually you'll only flash the rootfs, since the kernel+initramfs rarely change.

==== Flashing the kernel and initramfs ====

# In the SDE menu, go to "Recovery System" -> "Developer Edition Menu"-> "Flash kernel and initramfs"
# Plug the board to your computer, and mount the drive from the newly recognized device (normally called 101IT_REC)
# Copy both zImage and initramfs.cpio.gz on the mounted partition, directly at the root
# Unmount safely, then click ok on the board, and exit the menu reboot

==== Flashing the rootfs ====

# In the SDE menu, go to "Recovery System" -> "Repair System"-> "Start USB MSC"
# Plug the board to your computer, and mount the drive from the newly recognized device (normally called 101IT)
# Copy rootfs.img on the mounted partition, directly at the root
# Unmount safely, then click ok on the board, and exit the menu to reboot

== SSH access to the tablet ==

The tablet has the USB (slave) port set up with Ethernet-over-USB, using the g_ether gadget. See "this page":http://wiki.maemo.org/USB_networking for additional info and how to set up the network interface on the host computer.

=== Interface setup ===

The interface on the tablet is set up with the static address '''192.168.0.202'''.
You should set up the usb0 interface on the host by adding the following to */etc/network/interfaces''':

auto usb0 iface usb0 inet static

  1. note: this is the ip address on the host side, not on the tablet
address 192.168.0.201
netmask 255.255.255.0
No DCHP server is required.

=== SSH credentials ===

Once set up, you can connect to the tablet with the following credentials:

'''''' Username: '''root'''
'''''' Password: ''<no password>''

== Creating a redistributable Qt SDK ==

You can also create a redistributable SDK package by running the '''pack-sdk.sh''' script.
The script creates an archive '''archos-gen8-sdk.tar.gz''' in the build folder at the top level. This archive contains two folders:
'''''' '''toolchain''': contains the compiler and associated tools for cross-compiling applications for the tablet
'''''' '''sysroot''': contains the Qt libraries, headers, qmake, and all the dependencies for the tablet

== Installing the redistributable Qt SDK ==

In addition to extracting the archive, you must run the '''setup-sdk.sh''' script, which sets up the proper paths in the toolchain and for Qt itself:

tar xzf archos-gen8-sdk-qt5.tar.gz cd archos-gen8-sdk ./setup-sdk.sh