Peter: 1 Version importiert

2023-10-31T08:03:07Z

1 Version importiert

← Nächstältere Version	Version vom 31. Oktober 2023, 10:03 Uhr
(kein Unterschied)

en>Peter: 1 Version importiert

2023-08-22T19:35:49Z

1 Version importiert

Neue Seite

[[Image:SBC-i.MX51 V2.1 Top W300.png|right]]

== NEWS ==
;2011-11-11 - New Release v1.0
:We have released a new version of the Linux BSP!
:Highlights: Support for COMM and DISP extension boards; Bluetechnix ISM camera module drivers; Pre-configured SD card images for download. See [[SBC-i.MX51_Software_User_Manual#v1.0|here]] for details!

;2011-07-07 - Third-party support for 2.6.35 Linux kernel
:Thanks to Simon Vogl, who has brought the 2.6.35 kernel to the SBC-i.MX51! See [[#Development]]

;2010-10-08 - New Release v0.9
:We have released a new version of the Linux BSP!
:Highlights: Linux 2.6.31 kernel, full hardware codecs support in GStreamer, accelerated X server. See [[SBC-i.MX51_Software_User_Manual#v0.9|here]] for details!

;2010-09-28 - Public key no longer needed
:Due to customer request we have ceased to require a public key for downloading software. All software is now freely available for the public.

;2010-08-23 - OpenEmbedded Redboot recipe
:Redboot can now be built with OpenEmbedded. Run
bitbake sbc-imx51-redboot
:to build RedBoot. The files ''redboot.bin'' and ''redboot.bin_nopadding'' are placed into
btmxc/tmp/deploy/glibc/images/sbc-imx51
:after building.
:All the SBC-i.MX51 images build RedBoot automatically from now on.

;2010-08-17 - Please re-check out the ''btmxc'' repository!
:We've moved away the release files from the ''btmxc'' GIT repository to keep the size small. Because the repository ID changed, please make a fresh checkout of this repository as follows:
mv btmxc btmxc.bak
git clone ssh://gitosis@git.becom-group.com/btmxc
cd btmxc
git checkout origin/i.fly -b i.fly
mv ../btmxc.bak/tmp .
:Do not make a "git pull" on the old repository!
:To download release files, just follow the links on this page.

== Quick Start ==

You have just received your SBC-i.MX51. It comes with Linux software installed in the NAND flash.
# Connect a monitor to the HDMI connector.
# Connect USB mouse and keyboard to the USB-A plugs.
# Make sure that the DIP switches are set for NAND boot: {{dipswitch|0|0|1|1|0|1|1|0}}
# Connect 6-24V to the power plug (v1.2 Boards: 6-12V). You should immediately see either the blue or the red LED.
# The first boot takes about 15 minutes, subsequent boots are faster. Don't worry if the screen gets blank during first boot, the board is not dead!! (With 2.6.31 Linux, you may unblank the screen with a USB keyboard. However, current boards are delivered with BSP v0.2.)
# Login: Try one of: ''"root"/"sbc"'', ''"sbc"/"sbc"'', ''"root"/empty'' (depends on the BSP version)

== Setting up your development environment ==

* Set up a [[Serial console]]. (WARNING: Do not connect the USB cable for the serial terminal if the SBC-i.MX51 is not powered!)
* Install a [[TFTP Server]].
* It is recommended to set up an [[NFS Server]] to be able to mount the target's root file system via NFS.
* Optionally, you may set up a [[DHCP Server]].

'''JTAG devices'''
* The i.MX51 is supported by the [[PEEDI Configuration (SBC-i.MX51)|PEEDI JTAG]].

== Software Releases ==

=== Overview ===

* Redboot boot loader
* Linux kernel, Freescale and Bluetechnix patches
* Angstrom Linux distribution, built with OpenEmbedded
* GNU Toolchain, built with OpenEmbedded

=== Disclaimer ===

Software is provided AS-IS with no warranties.

Access to the software source is granted through our GIT repositories. Please note that although most parts are bound to license agreements defined by the GPL, there are some packages which are licensed through Freescale proprietary licenses or other license models. When applicable, the license agreement can be found in the according bitbake recipe. Bluetechnix does not guarantee that the list of licenses is exhaustive or complete.

By connecting to our GIT repositories, you agree to the terms and conditions outlined above.

=== Releases ===

====v1.0====
;Release date
:2011-11-11

;Supported Hardware Revision
:v2.1

;Linux kernel version
:2.6.31
:based on Freescale's Linux BSP L2.6.31_10.07.11

;Available images
:sbc-imx51-gnome-image: [[Gnome demo image (SBC-i.MX51)|GNOME v2.30 demo image]]
:sbc-imx51-qtembedded-image: Qt4 Embedded v4.6.2 demo image (Start ''qtdemo -qws'' to start QT DEMO!)
:sbc-imx51-console-image: Console demo image

;Files
:Download location: https://support.becom-group.com/releases/imx/sbc-imx51/v1.0-hw2.1/
:
:{| rules="all" frame="box" cellpadding="3" style="text-align:left"
|-
! File !! Content
|-
|redboot.bin || Redboot boot loader (with padding); for copying to NAND boot partition
|-
|redboot.bin_nopadding || Redboot boot loader (no padding); for SD card setup
|-
|-
|zImage.bin || Linux kernel 2.6.31 image
|-
|-
|console-image-sbc-imx51.jffs2 || JFFS2 image of root file system; for copying to NAND flash partition
|-
|console-image-sbc-imx51.tar.bz2 || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
|qtembedded-image-sbc-imx51.jffs2 || JFFS2 image of root file system; for copying to NAND flash partition
|-
|qtembedded-image-sbc-imx51.tar.bz2 || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
|GNOME-image-sbc-imx51.tar.bz2 || TAR/BZIP2 archive of root file system; for unpacking to SD card and NAND or for NFS
|-
|-
|console-sdcard-1gb.img.bz2 || SD card image containing the CONSOLE demo image and also the files for NAND setup. Decompress it with ''bunzip2'' and copy it to an SD card with ''dd if=console-sdcard-1gb.img.bz2 of=/dev/sdX''.
|-
|qtembedded-sdcard-1gb.img.bz2 || SD card image containing the QtEmbedded demo image and also the files for NAND setup. Decompress it with ''bunzip2'' and copy it to an SD card with ''dd if=qtembedded-sdcard-1gb.img.bz2 of=/dev/sdX''.
|-
|gnome-sdcard-1gb.img.bz2 || SD card image containing the GNOME demo image and also the files for NAND setup. Decompress it with ''bunzip2'' and copy it to an SD card with ''dd if=gnome-sdcard-1gb.img.bz2 of=/dev/sdX''.
|-
|}

;GIT tag
:''sbc-imx51-v1.0-hw2.1'', available in repositories ''btmxc'', ''btmxc-linux'', ''redboot-i.fly'', ''openembedded''

;New features
:Added Freescale i.MX51 PLL patch (Redboot; Linux)
:Support for Bluetooth, GPS, GSM/GPRS modules on EXT-SBC-i.MX51-COMM (Linux)
:ISM-MT9M131 camera module device driver (Linux)
:ISM-MT9M024 camera module device driver, including capture (capture-mt9m024) and BAYER-to-UYVY applications (Linux)
:SD card setup scripts now supports ''/dev/mmcblkX'' device files (Build)
:Switch liveness LED to red during shutdown, and switch off LED at shutdown (Linux)

;Changes
:Default configuration of SD cards sets a fixed IP address instead of waiting for a DHCP address (Redboot)
:Improved PMIC (Power Management IC) initialization sequence (Slower I2C speed; try harder) to fix the rare failure that some voltages are not turned on at boot (Redboot)
:Smooth blinking of the liveness LED (Linux)
:Fixed unintentional blanking of PWM backlight with DI0 framebuffer output (Linux)
:Ready-to-use SD card images contain pre-configured rootfs and do not need additional time for configuration at first boot; also the packed rootfs used for NAND setup on these SD cards is pre-configured (Build)

;Open issues
:Camera on EXT-SBC-i.MX51-DISP is not supported by ''Cheese'', Gnome's webcam application
:Audio recording does not work with Gnome's audio recorder, but with arecord.

====v0.9====
;Release date
:2010-10-08

;Supported Hardware Revision
:v2.1
:(v1.2: Use v0.2 Redboot)

;Linux kernel version
:2.6.31
:based on Freescale's Linux BSP L2.6.31_10.07.11

;Available images
:sbc-imx51-gnome-image: [[Gnome demo image (SBC-i.MX51)|GNOME v2.30 demo image]]
:sbc-imx51-qtembedded-image: Qt4 Embedded v4.6.2 demo image
:sbc-imx51-console-image: Console demo image

;Files
:{| rules="all" frame="box" cellpadding="3" style="text-align:left"
|-
! File !! Size !! Content
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/console-image-sbc-imx51.jffs2 console-image-sbc-imx51.jffs2] || 39 MiB || JFFS2 image of root file system; for copying to NAND flash partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/console-image-sbc-imx51.tar.bz2 console-image-sbc-imx51.tar.bz2] || 29 MiB || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/GNOME-image-sbc-imx51.tar.bz2 GNOME-image-sbc-imx51.tar.bz2] || 171 MiB || TAR/BZIP2 archive of root file system; for unpacking to SD card and NAND or for NFS
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/qtembedded-image-sbc-imx51.jffs2 qtembedded-image-sbc-imx51.jffs2] || 92 MiB || JFFS2 image of root file system; for copying to NAND flash partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/qtembedded-image-sbc-imx51.tar.bz2 qtembedded-image-sbc-imx51.tar.bz2] || 70 MiB || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/redboot.bin redboot.bin] || 197 KiB || Redboot boot loader (with padding); for copying to NAND boot partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/redboot.bin_nopadding redboot.bin_nopadding] || 196 KiB || Redboot boot loader (no padding); for SD card setup
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/zImage.bin zImage.bin] || 2.2 MiB || Linux kernel 2.6.31 image
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.9-hw2.1/sdcard-gnome-2gb.img.bz2 sdcard-gnome-2gb.img.bz2] || 347 MiB || SD card image containing the GNOME demo image and also the files for NAND setup. Decompress it with ''bunzip2'' and copy it to an SD card with ''dd if=sdcard-gnome-2gb.img.bz2 of=/dev/sdX''.
|-
|}

;GIT tag
:''sbc-imx51-v0.9-hw2.1'', available in repositories ''btmxc'', ''btmxc-linux'', ''redboot-i.fly'', ''openembedded''

;New features
:Linux kernel 2.6.31
:Updated GStreamer framework that supports the i.MX51 VPU and IPU. Totem supports the hardware codecs now and is the default media player.
:Accelerated X video driver that uses the i.MX51 internal GPU
:Support of EXT-DISP extension board (1 TFT, 1 LVDS display, 1 camera)
:Redboot displays logo onto HDMI at boot
:Liveness LED
:Time synchronization works now

;Open issues
:Camera on EXT-SBC-i.MX51-DISP is not supported by ''Cheese'', Gnome's webcam application
:Audio recording does not work with Gnome's audio recorder, but with arecord.

;SBC V1.x compatibility
:The BSP is compatible to SBC V1.x, but you have to use Redboot from the v0.2 release (because of different SDRAM chips)

====v0.3====
This release equals v0.2, but supports hardware revision 2.1.
The only difference is the DDR-RAM setup in Redboot.

No binary packages are available from this release.

====v0.2====
;Release date
:2010-07-08

;Supported Hardware Revision
:v1.2

;Linux kernel version
:2.6.28

;Available images
:sbc-imx51-gnome-image: [[Gnome demo image (SBC-i.MX51)|GNOME v2.30 demo image]]
:sbc-imx51-qtembedded-image: Qt4 Embedded v4.6.2 demo image
:sbc-imx51-console-image: Console demo image

;Files
:{| rules="all" frame="box" cellpadding="3" style="text-align:left"
|-
! File !! Size !! Content
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/console-image-sbc-imx51.jffs2 console-image-sbc-imx51.jffs2] || 40 MiB || JFFS2 image of root file system; for copying to NAND flash partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/console-image-sbc-imx51.tar.bz2 console-image-sbc-imx51.tar.bz2] || 29 MiB || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/GNOME-image-sbc-imx51.jffs2 GNOME-image-sbc-imx51.jffs2] || 268 MiB || JFFS2 image of root file system; for copying to NAND flash partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/GNOME-image-sbc-imx51.tar.bz2 GNOME-image-sbc-imx51.tar.bz2] || 182 MiB || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/qtembedded-image-sbc-imx51.jffs2 qtembedded-image-sbc-imx51.jffs2] || 93 MiB || JFFS2 image of root file system; for copying to NAND flash partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/qtembedded-image-sbc-imx51.tar.bz2 qtembedded-image-sbc-imx51.tar.bz2] || 70 MiB || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/redboot.bin redboot.bin] || 189 KiB || Redboot boot loader (with padding); for copying to NAND boot partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/redboot.bin_nopadding redboot.bin_nopadding] || 188 KiB || Redboot boot loader (no padding); for SD card setup
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.2-hw1.2/zImage.bin zImage.bin] || 1.8 MiB || Linux kernel 2.6.28 image
|-
|}

;GIT tag
:''sbc-imx51-v0.2-hw1.2'', available in repositories ''btmxc'', ''btmxc-linux'', ''redboot-i.fly'', ''openembedded''

;Open issues
:FSL Gstreamer playbin not available; Players like Totem do not work yet.
:If using .jffs2 Gnome image on NAND, Network Manager refuses to start and some icons in menus are missing

====v0.1====
;Release date
:2010-05-27

;Supported Hardware Revision
:v1.2

;Linux kernel version
:2.6.28

;Available images
:sbc-imx51-gnome-image: GNOME v2.30 demo image

;Files
:{| rules="all" frame="box" cellpadding="3" style="text-align:left"
|-
! File !! Size !! Content
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.1-hw1.2/GNOME-image-big-sbc-imx51.jffs2 GNOME-image-big-sbc-imx51.jffs2] || 284 MiB || JFFS2 image of root file system; for copying to NAND flash partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.1-hw1.2/GNOME-image-big-sbc-imx51.tar.bz2 GNOME-image-big-sbc-imx51.tar.bz2] || 194 MiB || TAR/BZIP2 archive of root file system; for unpacking to SD card or for NFS
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.1-hw1.2/redboot.bin redboot.bin] || 189 KiB || Redboot boot loader (with padding); for copying to NAND boot partition
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.1-hw1.2/redboot.bin_nopadding redboot.bin_nopadding] || 188 KiB || Redboot boot loader (no padding); for SD card setup
|-
| [https://support.becom-group.com/releases/imx/sbc-imx51/v0.1-hw1.2/zImage.bin zImage.bin] || 1.8 MiB || Linux kernel 2.6.28 image
|-
|}

;GIT tag
:''sbc-imx51-v0.1-hw1.2'', available in repositories ''btmxc'', ''btmxc-linux'', ''redboot-i.fly'', ''openembedded''

;Open issues
:No ''mtdblock'' devices available
:Gnome media players: FSL Gstreamer plug-ins not yet integrated
:X server: Framebuffer console cursor visible
:AD9889: Rare flickering
:Long first boot time

== Setting up OpenEmbedded (OE) [https://www.openembedded.org] ==

* General [[OpenEmbedded: General Considerations|considerations]] about OpenEmbedded
* [[OpenEmbedded: Setting up the Bluetechnix OE Framework|Setting up]] the Bluetechnix OE Framework

== Development ==

=== Building, NFS root file system ===
Build Linux packages and images with OpenEmbedded
* [[OpenEmbedded: Development|OpenEmbedded development]]

Configure the target network and set up an NFS root file system
* [[Network and NFS setup]]

=== Redboot and Linux ===
Modify the Linux kernel according to your needs
* [[Linux kernel development]]
* There's support for SBC-i.MX51 in the 2.6.35 kernel. Thanks to Simon Vogl!
** The GIT repository is here: https://github.com/svogl/linux-2.6/tree/kernel-2.6.35-fsl-sbc51
** He also brought the Android patches to the SBC kernel, see https://www.voxel.at/embedded/imx51_android

Modify the RedBoot boot loader according to your needs
* [[Redboot (SBC-i.MX51)|Redboot development]]

=== FAQ ===
A collection of frequently asked questions
* [[FAQ (SBC-i.MX51)|FAQ]]

== Supported Hardware ==

===Hardware documentation===
Please follow this [[Hardware documentation (SBC-i.MX51)|link]].

=== On-Chip/On-Board components ===
Each page contains information about hardware, device drivers, tests, etc.

* [[Boot media (SBC-i.MX51)|Booting]] from NAND, SD card, USB/UART, NFS, ...
* [[DDR-RAM (SBC-i.MX51)|DDR2 SDRAM]]
* [[NAND flash (SBC-i.MX51)|NAND flash]] support
* [[Ethernet (SBC-i.MX51)|Ethernet]]
* High-capacity [[SDHC controller (SBC-i.MX51)|SD card controller]]
* [[HDMI (SBC-i.MX51)|HDMI]] video output
* [[USB Hub (SBC-i.MX51)|USB Hub]] and USB 2.0 Host controller
* [[USB-OTG (SBC-i.MX51)|USB On-The-Go]] controller
* Full color [[LED (SBC-i.MX51)|LED]]
* [[Serial terminal (SBC-i.MX51)|USB-UART converter]] for a serial terminal
* [[Power Control (SBC-i.MX51)|Power management]]
* [[Audio (SBC-i.MX51)|Audio I/O]]
* [[SPDIF out (SBC-i.MX51)|SPDIF]] output
* CVBS [[TV Out (SBC-i.MX51)|TV Out]]

===Extension boards===

* [[EXT-SBC-i.MX51-COMM/DISP|EXT-SBC-i.MX51-COMM]], featuring
** two connectors for TFT displays
** a connector for a Bluetechnix Image Sensor Module
** a Bluetooth module
** a GPS module
** a GSM/GPRS module
* [[EXT-SBC-i.MX51-COMM/DISP|EXT-SBC-i.MX51-DISP]], featuring
** two connectors for TFT displays
** a connector for a Bluetechnix Image Sensor Module

== Software Description ==

There are some important and i.MX51-specific libraries and applications in the SBC board support package in order to employ the i.MX51 hardware features (IPU, VPU, etc).
Libraries and/or source code come from Freescale in their Linux BSP. We have re-integrated the required packages into OpenEmbedded. They are installed by default as needed in the SBC demo images.

=== i.MX specific support in Linux ===
* [[Multimedia codecs (SBC-i.MX51)|Audio/Video codecs]] and GStreamer plug-ins
* [[GPU support (SBC-i.MX51)|Acceleration]] with the i.MX51 GPU (Graphic processing unit)
* [[Unit tests (SBC-i.MX51)|Unit tests]] provided by Freescale

=== How-Tos ===
* [[Changing the splash screen picture]]
* [[Configure touch screen in Gnome]]

=== Watchdog ===
The i.MX51 has an integrated watchdog timer that can be enabled to reset the processor once the application or the board crashes.

Typically, one wants to enable the watchdog already in the boot loader (Redboot). If the Linux kernel is not booted correctly, the watchdog timer will reset the processor and run the boot loader again. Therefore, in the Linux kernel, a small daemon is needed which continuously resets the timer. You may also add this functionality directly into your application.

====Enable the watchdog in Redboot====
*Set the watchdog register in the boot script
fconfig boot_script_data
* As the first command, enter the following:
mfill -b 0x73f98000 -l 2 -p 0x5077 -2

The MSB of the above 16-bit value is the timeout (value is seconds * 2). Hence, the above command sets the watchdog timeout to 0x50/2 = 40 seconds. Note that within these 40 seconds, the Linux kernel plus the Linux application that resets the watchdog timer must be started! Adapt the timeout according to your needs.
* Once enabled, the i.MX51 watchdog cannot be disabled!

====Set the watchdog timeout of Linux====
* The default timeout within Linux is 60 seconds.
* To change it, you must supply an additional kernel argument in Redboot. Run
fconfig boot_script_data
* Then copy line after line, and add the following to the ''e'' or ''exec'' line:
e -c "... mxc_wdt.timer_margin=<seconds>"
* Once the watchdog timer driver is loaded in Linux, it will use the specified timeout.

====Linux watchdog daemon====
A simple daemon application that resets the watchdog timer periodically:
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <linux/watchdog.h>
#include <sys/ioctl.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>

int main(int argc, char **argv)
{
int watchdog;
FILE *log;
int keepalive = 0;
const char *logmsg = "Start wdt-daemon at ";
int ret;

if (argc != 2) {
fprintf(stderr, "Usage: %s <keep-alive-interval>\n",argv[0]);
return 0;
}

watchdog = open("/dev/watchdog",O_NONBLOCK,O_RDWR);
log = fopen("/home/root/wdt-daemon-log.txt","a");
fwrite(logmsg, strlen(logmsg), 1, log);
fclose(log);
system("date >> /home/root/wdt-daemon-log.txt");
system("sync");

keepalive = strtol(argv[1], NULL, 10);

while (1) {
ret = ioctl(watchdog, WDIOC_KEEPALIVE, 0);
sleep(keepalive);
}

return 0;
}

;Compilation
arm-angstrom-linux-gnueabi-gcc -o wdt_daemon wdt_daemon.c

;Usage
:For example, set '''mxc_wdt.timer_margin=10''' and let the daemon wake up each 5 seconds to reset the timer.

;Autostart
: Assuming, the daemon is at ''/wdt_daemon'', add the following line to ''/etc/inittab'' (bottom):
5:2345:respawn:/wdt_daemon 5

[[Category:SBC-i.MX51]]
[[Category:i.MX]]

SBC-i.MX51 Software User Manual - Versionsgeschichte

Peter: 1 Version importiert

en>Peter: 1 Version importiert