├── .gitignore ├── README.md └── default.xml /.gitignore: -------------------------------------------------------------------------------- 1 | # Built application files 2 | *.apk 3 | *.ap_ 4 | 5 | # Files for the ART/Dalvik VM 6 | *.dex 7 | 8 | # Java class files 9 | *.class 10 | 11 | # Generated files 12 | bin/ 13 | gen/ 14 | out/ 15 | 16 | # Gradle files 17 | .gradle/ 18 | build/ 19 | 20 | # Local configuration file (sdk path, etc) 21 | local.properties 22 | 23 | # Proguard folder generated by Eclipse 24 | proguard/ 25 | 26 | # Log Files 27 | *.log 28 | 29 | # Android Studio Navigation editor temp files 30 | .navigation/ 31 | 32 | # Android Studio captures folder 33 | captures/ 34 | 35 | # Intellij 36 | *.iml 37 | .idea/workspace.xml 38 | 39 | # Keystore files 40 | *.jks 41 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Android4Beagle 2 | 3 | Android4Beagle aims to provide a vanilla AOSP-based Android for 4 | [Beagleboard.org](http://beagleboard.org/) boards, starting with the BeagleBone Black. Hopefully 5 | I will get round to adding the other colours of BeagleBone later, 6 | and maybe even the BeagleBoard-xM and BeagleBoard-X15. All of these 7 | make great platforms for **embedded Android**, by which I mean Android being 8 | used to control ... I don't know ... a printer, a robot, maybe some 9 | kind of test or medical equipment. 10 | 11 | If you would like to know how it is done, and how you can apply this 12 | knowledge to your own products, then you might be interested in 13 | what I do for my day-time job 14 | [www.2net.co.uk/training.html](http://www.2net.co.uk/training.html) 15 | 16 | ## Board support matrix 17 | 18 | | Board | AOSP | Kernel | Cape manager | SGX | Tag | 19 | | -------------- | ----- | ------ | ------------ | --- |----------------- | 20 | |BeagleBone Black| 4.4.4 | 3.2 | N | Y | android-4.4.4_r2 | 21 | | | 5.1.1 | 3.8 | Y | N | android-5.1.1 | 22 | | | 6.0.1 | 4.1 | Y | N | android-6.0 | 23 | 24 | ## Preparation 25 | 26 | Make sure that you have a system capable of building AOSP in a reasonable 27 | amount of time, as described here: 28 | [http://source.android.com/source/building.html](http://source.android.com/source/building.html). 29 | Then set it up following the steps given here: 30 | [http://source.android.com/source/initializing.html](http://source.android.com/source/initializing.html) 31 | 32 | You will need in addition the U-Boot **mkimage tool**. On Ubuntu run 33 | `sudo apt-get install u-boot-tools` 34 | 35 | ## Getting Android4Beagle 36 | 37 | The majority of the code comes directly from android.googlesource.com. 38 | The only board-specific components are U-Boot, the Linux kernel, the PowerVR 39 | SGX GPU driver and the scripts needed to put it all together. 40 | 41 | Begin by getting the Android4Beagle repo, using the appropriate tag from the 42 | product matrix: 43 | 44 | ``` 45 | $ mkdir ~/a4b 46 | $ cd ~/a4b 47 | $ repo init -u https://github.com/csimmonds/android4beagle -b android-6.0 48 | $ repo sync -c 49 | ``` 50 | The googlesource repositories are always growing. The last time I checked, 51 | the total download was 55 GiB, so please 52 | make sure that you have enough disk space, bearing in mind that the 53 | build will generate another 25 GiB of intermediate object files 54 | and the final images. 55 | 56 | # Building for BeagleBone Black 57 | There are two product variants: 58 | 59 | * beagleboneblack_sd-eng: if you want to run from a micro SD card 60 | * beagleboneblack-eng: if you want to install Android in internal flash 61 | 62 | ## Build 63 | ``` 64 | $ source build/envsetup.sh 65 | $ lunch 66 | ``` 67 | Select either **beagleboneblack-eng** or **beagleboneblack_sd-eng**. Then 68 | ``` 69 | $ ./build-beagleboneblack.sh 70 | ``` 71 | The build will take at least one hour, possibly much longer if 72 | your build machine is a little below spec. 73 | 74 | ## Running Android from the micro SD card 75 | 76 | You will need a micro SD card of at least 4 GB. Ideally it should 77 | be class 10 or better. 78 | 79 | Plug the card into your card reader. Run command `lsblk` to find which 80 | device it is. Then run the script below, giving the device name as the 81 | parameter. For example, if the card reader is `/dev/mmcblk0`, the 82 | command would be: 83 | ``` 84 | $ scripts/write-sdcard-beagleboneblack.sh mmcblk0 85 | ``` 86 | When done, plug the card into your BeagleBone Black, press the 87 | "boot" button and power up. 88 | 89 | ## Running Android from internal eMMC flash memory 90 | 91 | In this case, you begin by making a bootable SD card which contains 92 | only U-Boot. You boot from it, and then use fastboot to format 93 | the eMMC chip and then copy the Android images to it. 94 | 95 | Plug a micro SD card into your card reader. Run command `lsblk` to find which 96 | device it is. Then run the script below, giving the device name as the 97 | parameter. For example, if the card reader is /dev/mmcblk0, the 98 | command would be 99 | ``` 100 | $ croot 101 | $ scripts/write-fastboot-sdcard-beagleboneblack.sh mmcblk0 102 | ``` 103 | When done, plug the card into your BeagleBone Black, press the 104 | "boot" button and power up. 105 | 106 | The "fastboot LED" (user LED0) should come on, indicating that it 107 | is in fastboot mode. Now use fastboot to program the internal flash: 108 | ``` 109 | $ croot 110 | $ cd u-boot 111 | $ fastboot oem format 112 | $ fastboot reboot 113 | ``` 114 | This will force U-Boot to read the new partition table. When the 115 | fastboot LED comes on again, continue (still in directory u-boot/): 116 | ``` 117 | $ fastboot flash spl MLO 118 | $ fastboot flash bootloader u-boot.img 119 | $ fastboot flash userdata 120 | $ fastboot flash cache 121 | $ fastboot flash system 122 | $ fastboot flash boot 123 | $ fastboot flash recovery 124 | ``` 125 | Power off, **remove the SD card** and power on. It should boot Android... 126 | 127 | If something goes wrong while flashing the images, the best diagnostic 128 | tool is to plug a serial to USB connector into the BeagleBone and see what 129 | U-Boot is doing. You can force it into fastboot mode from the U-Boot prompt 130 | by typing the command `fastboot` 131 | -------------------------------------------------------------------------------- /default.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 5 | 8 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 | 186 | 187 | 188 | 189 | 190 | 191 | 192 | 193 | 194 | 195 | 196 | 197 | 198 | 199 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | 213 | 214 | 215 | 216 | 217 | 218 | 219 | 220 | 221 | 222 | 223 | 224 | 225 | 226 | 227 | 228 | 229 | 230 | 231 | 232 | 233 | 234 | 235 | 236 | 237 | 238 | 239 | 240 | 241 | 242 | 243 | 244 | 245 | 246 | 247 | 248 | 249 | 250 | 251 | 252 | 253 | 254 | 255 | 256 | 257 | 258 | 259 | 260 | 261 | 262 | 263 | 264 | 265 | 266 | 267 | 268 | 269 | 270 | 271 | 272 | 273 | 274 | 275 | 276 | 277 | 278 | 279 | 280 | 281 | 282 | 283 | 284 | 285 | 286 | 287 | 288 | 289 | 290 | 291 | 292 | 293 | 294 | 295 | 296 | 297 | 298 | 299 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 309 | 310 | 311 | 312 | 313 | 314 | 315 | 316 | 317 | 318 | 319 | 320 | 321 | 322 | 323 | 324 | 325 | 326 | 327 | 328 | 329 | 330 | 331 | 332 | 333 | 334 | 335 | 336 | 337 | 338 | 339 | 340 | 341 | 342 | 343 | 344 | 345 | 346 | 347 | 348 | 349 | 350 | 351 | 352 | 353 | 354 | 355 | 356 | 357 | 358 | 359 | 360 | 361 | 362 | 363 | 364 | 365 | 366 | 367 | 368 | 369 | 370 | 371 | 372 | 373 | 374 | 375 | 376 | 377 | 378 | 379 | 380 | 381 | 382 | 383 | 384 | 385 | 386 | 387 | 388 | 389 | 390 | 391 | 392 | 393 | 394 | 395 | 396 | 397 | 398 | 399 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 419 | 420 | 421 | 422 | 423 | 424 | 425 | 426 | 427 | 428 | 429 | 430 | 431 | 432 | 433 | 434 | 435 | 436 | 437 | 438 | 439 | 440 | 441 | 442 | 443 | 444 | 445 | 446 | 447 | 448 | 449 | 450 | 451 | 452 | 453 | 454 | 455 | 456 | 457 | 458 | 459 | 460 | 461 | 462 | 463 | 464 | 465 | 466 | 467 | 468 | 469 | 470 | 471 | 472 | 473 | 474 | 475 | 476 | 477 | 478 | 479 | 480 | 481 | 482 | 483 | 484 | 485 | 486 | 487 | 488 | 489 | 490 | 491 | 492 | 493 | 494 | 495 | 496 | 497 | 498 | 499 | --------------------------------------------------------------------------------