board/lego/ev3/readme.txt

   1 Lego Mindstorms EV3
   2
   3 Intro
   4 =====
   5
   6 This is the buildroot basic board support for the Lego Mindstorms EV3
   7 programmable brick.
   8
   9 The Lego Mindstorms EV3 brick comprises a Texas Instruments AM1808 SoC, with
  10 an ARM 926EJ-S main processor running at 300 MHz.
  11 See:
  12 - https://en.wikipedia.org/wiki/Lego_Mindstorms_EV3
  13 - http://www.lego.com/en-us/mindstorms/products/ev3/31313-mindstorms-ev3/
  14 - http://www.ti.com/product/am1808
  15
  16 The buildroot configuration uses the Linux kernel of the ev3dev project.
  17 See:
  18 - https://github.com/ev3dev/ev3-kernel/
  19 - https://github.com/ev3dev/lego-linux-drivers/
  20 - http://www.ev3dev.org/
  21
  22 How it works
  23 ============
  24
  25 Boot process :
  26 --------------
  27
  28 The EV3 boots from an EEPROM. This loads whatever is on the built-in 16MB flash
  29 (usually U-Boot) and runs it. The U-Boot from the official LEGO firmware and
  30 mainline U-Boot will attempt to boot a Linux kernel from the external µSD card.
  31 It will try to load a uImage (and optional boot.scr) from the first µSD card
  32 partition, which must be formatted with a FAT filesystem. If no µSD is found or
  33 it does not contain a uImage file, then the EV3 will boot the uImage from the
  34 built-in 16MB flash.
  35
  36 How to build it
  37 ===============
  38
  39 Configure Buildroot
  40 -------------------
  41
  42 The lego_ev3_defconfig configuration provides basic support to boot on the Lego
  43 Mindstorms EV3 programmable brick:
  44
  45   $ make lego_ev3_defconfig
  46
  47 Build everything
  48 ----------------
  49
  50 Note: you will need to have access to the network, since Buildroot will
  51 download the packages' sources.
  52
  53   $ make
  54
  55 Result of the build
  56 -------------------
  57
  58 After building, you should obtain this tree:
  59
  60     output/images/
  61     ├── boot.vfat
  62     ├── flash.bin
  63     ├── rootfs.ext2
  64     ├── rootfs.ext3 -> rootfs.ext2
  65     ├── rootfs.squashfs
  66     ├── sdcard.img
  67     ├── u-boot.bin
  68     └── uImage
  69
  70 Installation
  71 ============
  72
  73 You can use either flash.bin or the sdcard.img. To load flash.bin, use the
  74 official Lego Mindstorms EV3 programming software firmware update tool to load
  75 the image. To use sdcard.img, use a disk writing tool such as Etcher or dd to
  76 write the image to the µSD card.
  77
  78 Finish
  79 ======
  80
  81 To have a serial console, you will need a proper USB to Lego serial port
  82 adapter plugged into the EV3 sensors port 1.
  83 See:
  84 - http://botbench.com/blog/2013/08/15/ev3-creating-console-cable/
  85 - http://botbench.com/blog/2013/08/05/mindsensors-ev3-usb-console-adapter/
  86
  87 The serial port config to use is 115200/8-N-1.