Changes between Version 45 and Version 46 of SettingUpMultiRootGen8

Timestamp:
05/26/13 15:26:31 (3 years ago)
Author:
gravgun
Comment:

Cosmetic changes & lighter way to tell Windows users to f*ck off

Legend:

Unmodified
Added
Removed
Modified

  • SettingUpMultiRootGen8

    v45 v46  
    7 7 }}} 
    8 8 == General Info == 
    9   First of all, note these steps are still experimental and '''not''' meant for end users, so if you don't know what you are doing, skip this and wait for something more end user friendly to come. [[BR]] 
    10   The "multi root" will let you choose between multiple rootfs images at the startup from your archos. [[BR]] 
    11   It uses the same kernel for your different {{{rootfs}}}es, namely a modified archos android kernel. [[BR]] 
    12   [[BR]] 
    13   The final goal is to be able to use for example kexec, so it would also be possible to boot different kernels. Sources for the kernel and initramfs are available on gitorious: [[BR]] 
    14   [http://gitorious.org/archos-buildroots/gen8-kernel] [[BR]] 
    15   [http://gitorious.org/archos-buildroots/gen8] 
      9 First of all, note these steps are still experimental and '''not''' meant for end users, so if you don't know what you are doing, skip this and wait for something more end user friendly to come. [[BR]] The "multi root" will let you choose between multiple rootfs images at the startup from your archos. [[BR]] It uses the same kernel for your different `rootfs`es, namely a modified archos android kernel. [[BR]] [[BR]] The final goal is to be able to use for example kexec, so it would also be possible to boot different kernels. Sources for the kernel and initramfs are available on gitorious: [[BR]] [http://gitorious.org/archos-buildroots/gen8-kernel] [[BR]] [http://gitorious.org/archos-buildroots/gen8] 
    16 10  
    17 11 == Installing Multi Root on Gen8 == 
    18 12 {{{ 
    19   #!html  
    20   If you are running Windows!  
    21  

       
    22  
  • This is experimental software, not an upgrade of any kind. If you are looking for one, ask Archos, not us!
    •   
    23  
  • When told to 'remove safely' you MUST ALWAYS safely remove the device, else it will NOT work. (missing zImage, initramfs or problems with starting the images are signs of this)
    •        
    24  
  • If something doesn't work then please kindly turn to one of the Archos forum sites. We are not able handle Windows problems on the chat.
    •  
    25    
    26    
      13 #!div style="border-left:4px #FFBF00 solid;background:#FFFFBF;padding:1px 0 1px .75em" 
      14 '''Attention Windows users:'''[[BR]] 
      15 When told to "remove/umount device", make sure you ''actually'' do it. (missing zImage or initramfs may occur else)[[BR]] 
      16 No Windows-related problems will be handled on the chat, ask on Archos forum sites. 
    27 17 }}} 
    28   First you have to install SDE from [http://www.archos.com/support/support_tech/updates_dev.html?country=nl&lang=en Archos]. [[BR]] 
    29   Don't worry, Archos provides instructions on how to install SDE. Once installed, you can proceed. 
      18 First, you have to install SDE from [http://www.archos.com/support/support_tech/updates_dev.html?country=nl&lang=en Archos] (65MB download). [[BR]] Instructions on how to install SDE are provided on the page. Once installed, you can proceed. 
    30 19  
    31   Download the initramfs.cpio.gz and zImage from [https://openaos.org/wp-upload/gen8/2012-12-25/kernel_gen8_20121225_093548.tar.gz]. [[BR]] 
    32   Unpack the archive (using 7zip/WinRar/"tar -zxvf"/…) and keep only initramfs.cpio.gz and zImage. [[BR]] 
      20 Download initramfs.cpio.gz and zImage from [https://openaos.org/wp-upload/gen8/2012-12-25/kernel_gen8_20121225_093548.tar.gz]. [[BR]] Unpack the archive (using 7zip/WinRar/"tar -zxvf"/…) and keep only initramfs.cpio.gz and zImage. [[BR]] 
    33 21  
    34 22 '''NOTE: Builds linked here can change and may have bugs''' 
    … …  
    36 24 Connect your archos to your PC with the usb cable. 
    37 25  
    38   Shutdown your archos by holding down the power button. Go into recovery by holding down the "volume down" button and switch on your archos. [[BR]] 
    39   Keep the button pressed until you see the white recovery menu. [[BR]] 
    40   Go to "Recovery system" ➔ "Developer Edition Menu" ➔ "Flash Kernel and initramfs" 
      26 Shutdown your archos by holding down the power button. Go into recovery by holding down the "volume down" button and switch on your archos. [[BR]] Keep the button pressed until you see the white recovery menu. [[BR]] Go to "Developer Edition Menu" ➔ "Flash Kernel and initramfs" 
    41 27  
    42 28 Copy the downloaded files to the archos and unmount safely. 
    43 29  
    44   When the boot-menu is started it will look for menu.lst on the internal storage of your archos. In menu.lst you will be able to define your boot menu. If it doesn't exists, it will create a default one for you with the following content. 
    45    
      30 When the bootmenu is started it will look for menu.lst on the internal storage of your archos.[[BR]]In menu.lst you will be able to define your boot menu. If it doesn't exists, it will create a default one for you with the following content: 
    46 31 {{{ 
    47 32 Archos|ARCHOS|ARCHOS|/init|0 
    … …  
    49 34  
    50 35 }}} 
    51   Note the blank line at the end; it is required. 
    52   Your rootfs image files are expected to be on the internal memory. 
      36 Note the blank line at the end; it is required. Your rootfs image files are expected to be on the internal memory. 
    53 37  
    54   '''NOTE:''' If you for some reason use Windows; which is ''not'' recommended, using a Linux distro is much better; then don't use Notepad to edit the menu.lst, use [http://notepad-plus-plus.org/ Notepad++] instead. [[BR]] 
    55   In Notepad++ go to Edit ➔ EOL conversion ➔ Unix. If it is grayed out you are ok, else click on it to set end of line to unix. Line endings should be in unix, because parsing the menu.lst on boot will screw up. 
      38 {{{ 
      39 #!div style="border-left:4px #06F solid;background:#EBF3FF;padding:1px 0 1px .75em" 
      40 If you use Windows, '''don't use Notepad''' to edit menu.lst, use [http://notepad-plus-plus.org/ Notepad++] instead.[[BR]]In Notepad++ go to Edit ➔ EOL conversion ➔ Unix. If the option is grayed, line endings already are in Unix format.[[BR]] 
      41 By the way, consider installing a Linux distribution such as (K)Ubuntu, Debian, Fedora or Linux Mint, many things are easier to do under Linux. 
      42 }}} 
    56 43  
    57   == Installing OSes (rootfs filesystems to install) == 
    58   If you are willing to install Android 2.3 "Gingerbread", please head to the "[wiki:AndroidInstall_CM7_Gingerbread Guidelines to install Gingerbread]" wiki page. 
      44 == Installing OSes (rootfs filesystems) == 
    59 45  
    60   '''Note: At the moment these images are far from being functional to an end user''' 
    61    
    62   ||'''Name:'''||'''Download:'''||'''Sources:'''||'''How to build your own:'''||'''How to install:'''|| 
    63   ||openAOS-Cyanogenmod (current: Degu)||https://openaos.org/wp-upload/gen8/2013-01-27/||[https://gitorious.org/openaos-cyanogenmod]||[wiki:AndroidBuildEnvironment Setting up buildenvironment Cyanogenmod gen7/gen8]||[wiki:AndroidInstall_CM7_Gingerbread Guidelines to install Gingerbread]|| 
    64   ||Debian LXDE||https://openaos.org/wp-upload/gen8/debian/||||[wiki:"Debian gen8" Debian gen8]||[wiki:"Debian gen8" Debian gen8]|| 
      46 ||'''Name:'''||'''How to install:'''||'''Download:'''||'''Sources:'''||'''How to build your own:'''|| 
      47 ||Android[[BR]][[span(openAOS-Cyanogenmod (Degu), style=color:gray;font-size:70%)]]||[wiki:AndroidInstall_CM7_Gingerbread Guidelines to install Gingerbread]||[https://openaos.org/wp-upload/gen8/2013-01-27/ openaos.org/wp-upload/gen8/2013-01-27/]||[https://gitorious.org/openaos-cyanogenmod gitorious.org/openaos-cyanogenmod]||[wiki:AndroidBuildEnvironment Setting up buildenvironment Cyanogenmod gen7/gen8]|| 
      48 ||Debian LXDE||[wiki:"Debian gen8" Debian gen8]||[https://openaos.org/wp-upload/gen8/debian/ openaos.org/wp-upload/gen8/debian/]||||[wiki:"Debian gen8" Debian gen8]|| 
    65 49  
    66 50 == Currently known problems: == 
    67    * No touchscreen support in the boot-menu 
    68    * Disabled removing archos init, because of startup issues with original archos firmware. So you will have to start the boot menu by going into recovery and choose developer edition. 
    69    * On Android, the on-touchscreen buttons of the Archos 24 and 32 won't work 
      51  * Archos init is not replaced because of issues with original archos firmware. You will have to start the boot menu by going into recovery and choose developer edition. 
      52  * On Android, the on-touchscreen buttons of the Archos 24 and 32 won't work (will be fixed in next release) 
    70 53  
    71 54 == More info on multiroot Bootmenu == 
    72 55 See [http://dev.openaos.org/wiki/SettingUpMultiRoot_BootMenu Multiroot Bootmenu Explained] 
    73 56  
    74   [[BR]] 
    75 57 {{{ 
    76 58 #!html 
    77 59

    If you are not a developer or not willing to debug and build things, consider this sentence as the end of the wiki page.

     
    78 60 }}} 
    79   [[BR]][[BR]] 
      61 {{{ 
      62 #!div style="border-left:4px #06F solid;background:#EBF3FF;padding:1px 0 1px .75em" 
      63 This part is for Linux only, i.e. NOT Windows! [[BR]] 
      64 Anyway a Windows user won't understand anything, because ''Windows has no bugs''^[citation needed] [proof needed] [f*ckmicrosoft needed]^ [[BR]] 
      65 }}} 
      66 == Debugging == 
      67 In the bootmenu, Advanced menu ➔ Debugging will bring you the serial menu where you can choose a debugging method: 
      68  * None = no debugging 
      69  * Serial = USB serial 
      70  * Ether = ethernet 
      71  * Both = USB + ethernet 
      72 If you enable serial, 3 connections will be available on your PC 
    80 73  
    81   == Debugging == 
    82   Just Download initramfs-debug.cpio.gz and rename it to initramfs.cpio.gz and flash it together with the zImage.  Leave the USB cable connected to your archos, it will be your serial connection. 
    83    
    84   '''Note:''' You can also use the normal initramfs.cpio.gz and choose Advanced menu ➔ Debugging to go to the serial menu. In the debug version it will boot straight to the serial menu. 
    85    
    86   Upon startup the bootmenu will ask for a type of debugging connection: 
    87    * None (no debugging) 
    88    * Serial (serial will be used) 
    89    * Ether (ethernet will be used) 
    90    * Both (serial and ethernet) 
    91    
    92   If you enable serial, you will see 3 connections available on your PC 
    93    
    94   On Ubuntu: 
    95    
      74 On a Debian-based distro (Ubuntu & others), in a shell, you should get: 
    96 75 {{{ 
    97   dmesg | grep cdc_acm 
    98   }}} 
    99   You will get an output like this 
    100    
    101   {{{ 
      76 coder@devpc~$ dmesg | grep cdc_acm 
    102 77 [3365540.510632] cdc_acm 1-4:2.0: This device cannot do calls on its own. It is not a modem. 
    103 78 [3365540.510749] cdc_acm 1-4:2.0: ttyACM0: USB ACM device 
    … …  
    107 82 [3365540.517222] cdc_acm 1-4:2.4: ttyACM2: USB ACM device 
    108 83 }}} 
    109    * /dev/ttyACM0 Not used in initramfs, but used for android console 
    110    * /dev/ttyACM1 Gives you a shell in initramfs 
    111    * /dev/ttyACM2 Output of kernel messages (/proc/kmsg) 
      84  * /dev/ttyACM0sed for android console 
      85  * /dev/ttyACM1 Gives you a shell in initramfs 
      86  * /dev/ttyACM2 Output of kernel messages (/proc/kmsg) 
    112 87  
    113   '''Some programs to connect to serial:''' 
    114    
    115    * minicom 
    116    * screen 
    117    * putty 
    118    
    119   '''Connection info:''' 
    120    
    121    * Speed: 115200 (This can be set higher or lower, it shouldn't matter much. I use 115200) 
      88 Use a serial terminal emulator such as ''minicom'', ''screen'' or ''putty'' to connect with the following parameters: 
      89  * Speed: 115200 (can be set higher or lower, doesn't matter much, we're on USB) 
    122 90  * Data bits: 8 
    123 91  * Stop bits: 1 
    … …  
    125 93  * Flow Control: none 
    126 94  
    127   '''How to use minicom:''' 
    128    
    129   Start your archos and choose serial in the first menu to enable it. It now boots to the main bootmenu. 
    130    
      95 '''Using minicom:''' 
      96 Enable USB serial debugging. [[BR]] 
    131 97 Start your shell by entering the following on your pc: 
    132    
    133 98 {{{ 
    134 99 $ minicom -D /dev/ttyACM1 
    … …  
    141 106 $ minicom -D /dev/ttyACM2 
    142 107 }}} 
      108  
    143 109 [[Image(minicom_shell.2.png)]] 
    144 110  
    … …  
    159 125 $ make dist 
    160 126 }}} 
    161   Everything including the zImage will be in openaos/target it will also create the md5sum files for you. As a bonus there is the modules tarball as well. 
      127 Everything including the zImage will be in openaos/target it will also create the md5sum files for you. As a bonus there is the modules tarball as well. 
    162 128  
    163   '''Note:''' See that you have all the dependencies installed. Below are the dependencies needed for Ubuntu 10.04. That should give you a good starting point for other distros. 
      129 '''Note:''' you have all the dependencies installed. Below are the dependencies needed for Ubuntu 10.04. That should give you a good starting point for other distros. 
    164 130  
    165 131 {{{ 
    166 132 sudo aptitude install autoconf automake bison build-essential cmake flex gawk gperf intltool libbz2-dev libcap-dev libglib2.0-dev libxml-simple-perl libxml2-dev lzma m4 rpm subversion texinfo x11-xkb-utils xmlto zlib1g-dev ncurses-dev expect libtool libmpfr-dev libgmp3-dev libgphoto2-2-dev 
    167 133 }}} 
    168   == Other usefull links for developers == 
      134 == Other useful links for developers == 
    169 135  * [wiki:InitramfsRepacking How to repack initramfs] 
    170    * [wiki:SplashImage How to make custom splash image] 
      136  * [wiki:SplashImage How to make custom splash image] 
    171 137  * [wiki:FBMenu FBmenu bootmenu] 
    172 138  * [wiki:aos-tools Unpacking original archos firmware]