hummingboard/README at master · larseje/hummingboard · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
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
Name:

   Hummingboard Mini Distribution

About:

   A basic GNU/Linux distribution for the Hummingboard from solid-run.com

Main features:

   * Arm Cortex A9, Neon, FPU optimized toolchain
   * Glibc C library
   * Systemd init system
   * GNU/Linux system utilities (no busybox)
   * Ethernet network support
   * OpenSSH client/server
   * Gstreamer-1.4.x (including iMX HW enc/dec plugins)
   * Vivante GPU drivers (including samples)
   * QT5 (including examples)

Main builds:

   fs      - Filesystem
   linux   - Linux kernel
   u-boot  - Bootloader

Quick build guide:

   $ git clone --recursive git://github.com/mini-distribution/hummingboard.git
   $ cd hummingboard
   $ buildgear build fs
   $ buildgear build u-boot

Prebuilt images:

   For demo purpose, prebuilt images are available here:
   http://mini-distribution.io/prebuilds/hummingboard

Login details:

    Username: root
    Password: root

Example feature tests:

   * Gstreamer video output test:

       $ gst-launch-1.0 videotestsrc ! imxipuvideosink

   * Gstreamer H264/AAC decoding:

       $ echo 0 > /sys/class/graphics/fbcon/cursor_blink
       $ wget http://mirrorblender.top-ix.org/peach/bigbuckbunny_movies/big_buck_bunny_1080p_h264.mov
       $ gst-launch-1.0 playbin uri=file:///root/big_buck_bunny_1080p_h264.mov video-sink=imxipuvideosink

   * QT5 CinematicExeperience technology demo (QML/GLESv2):

       $ cd /opt/qt5/CinematicExperience
       $ ./Qt5_CinematicExperience

   * QT5 demos are available in /opt/qt5/examples/*

Installation:

   To install on SD card simply follow the steps below:

   (replace X with the device number of your SD card)

   1. Install 1st stage bootloader:
      $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1

   2. Install 2nd stage bootloader:
      $ sudo dd if=u-boot.img of=/dev/sdX bs=1K seek=42

   3. Create a single primary partition (default to 2048 start sector):
      $ echo -e "n\np\n1\n\n\nw\n" | sudo fdisk /dev/sdX

   4. Install ext4 type filesystem:
      $ sudo mkfs.ext4 -L rootfs /dev/sdX1

   5. Install root filesystem (includes kernel in /boot directory):
      <mount your new rootfs partition>
      $ cd <your rootfs mount point>
      $ sudo tar xf fs.tar.xz

Build system requirements:

   Tested on Ubuntu 15.04 (64-bit x86) with the following additional packages
   installed:

   $ sudo apt-get install unzip groff bison flex gperf texinfo xsltproc \
                          libtool-bin libncurses5-dev gawk libexpat1-dev \
                          gettext u-boot-tools libglib2.0-dev intltool \
                          libxml2-utils docbook-xml cmake g++ pixz lzop \
                          u-boot-tools docbook-xml ruby


   Also requires reconfiguring "/bin/sh" to use bash:

   $ sudo dpkg-reconfigure dash

   Fact: Many software distributions fail to build using the dash shell.

Known issues:

   None

Filesystem layout:

   /usr/bin/            User binaries
   /usr/sbin/           System binaries (daemons, system utilities, etc.)
   /usr/lib/            Libraries
   /usr/lib/<prog>/     Program specific libraries (plug-ins, addons, etc.)
   /usr/include/        Header files
   /usr/share/man/      Man pages
   /usr/share/<prog>/   Program data files shared across all architectures
   /usr/etc/<prog>/     Configuration files for user programs
   /etc/                Configuration files for system programs

   The filesystem directory hierachy is arranged according to the FHS 2.3
   standard with the exceptions that /bin and /sbin are unused. Instead all
   software make use of /usr/bin and /usr/sbin. For backwards compatibility
   /bin and /sbin remain links to /usr/bin and /usr/sbin respectively.

   See http://www.pathname.com/fhs/pub/fhs-2.3.html for more details.

Maintainer:

   Martin Lund <martin.lund@keep-it-simple.com>