mfgtools: new package

This package contains the Freescale manufacturing tool.
It is designed to program firmware to i.MX boards during production.
The communication is done over USB using the Freescale UTP protocol.

The project is maintained on NXPMicro Github repository:
https://github.com/NXPmicro/mfgtools

Signed-off-by: Gary Bisson <gary.bisson@boundarydevices.com>
[Thomas:
 - remove dependency on host-cmake, this is handled by the
   host-cmake-package infrastructure
 - add quotes around $(HOSTCXX)
 - add CPOL.htm to <pkg>_LICENSE_FILES.
 - tweaks to the readme.txt file.]
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>

diff --git a/package/Config.in.host b/package/Config.in.host
index 1140c70c82ce082dce37b9782f972f18cf1def4d..e33cbb57e94200e94ea0f6a39e798983d34f4aa4 100644 (file)
--- a/package/Config.in.host
+++ b/package/Config.in.host
@@ -22,6 +22,7 @@ menu "Host utilities"
        source "package/jq/Config.in.host"
        source "package/jsmin/Config.in.host"
        source "package/lpc3250loader/Config.in.host"
+       source "package/mfgtools/Config.in.host"
        source "package/mke2img/Config.in.host"
        source "package/mkpasswd/Config.in.host"
        source "package/mtd/Config.in.host"

diff --git a/package/mfgtools/Config.in.host b/package/mfgtools/Config.in.host
new file mode 100644 (file)
index 0000000..8bba9e2
--- /dev/null
+++ b/package/mfgtools/Config.in.host
@@ -0,0 +1,10 @@
+config BR2_PACKAGE_HOST_MFGTOOLS
+       bool "host mfgtools"
+       depends on BR2_arm
+       help
+         This package contains the Freescale manufacturing tool.
+         It is designed to program firmware to i.MX boards during
+         production. The communication is done over USB using the
+         Freescale UTP protocol.
+
+         https://github.com/NXPmicro/mfgtools

diff --git a/package/mfgtools/mfgtools.hash b/package/mfgtools/mfgtools.hash
new file mode 100644 (file)
index 0000000..e73a7fa
--- /dev/null
+++ b/package/mfgtools/mfgtools.hash
@@ -0,0 +1,2 @@
+# locally computed
+sha256  6ce93a33c269282df305cf7e517d2d14fde78203537d8ea75b064966afe48464  mfgtools-b219fc219a35c365010897ed093c40750f8cdac6.tar.gz

diff --git a/package/mfgtools/mfgtools.mk b/package/mfgtools/mfgtools.mk
new file mode 100644 (file)
index 0000000..cc24352
--- /dev/null
+++ b/package/mfgtools/mfgtools.mk
@@ -0,0 +1,34 @@
+################################################################################
+#
+# mfgtools
+#
+################################################################################
+
+MFGTOOLS_VERSION = b219fc219a35c365010897ed093c40750f8cdac6
+MFGTOOLS_SITE = $(call github,NXPmicro,mfgtools,$(MFGTOOLS_VERSION))
+MFGTOOLS_SUBDIR = MfgToolLib
+MFGTOOLS_LICENSE = BSD-3c or CPOL
+MFGTOOLS_LICENSE_FILES = LICENSE CPOL.htm
+HOST_MFGTOOLS_DEPENDENCIES = host-libusb
+
+HOST_MFGTOOLS_CFLAGS = \
+       $(HOST_CFLAGS) $(HOST_LDFLAGS) -std=c++11 -lpthread \
+       -L$(@D)/MfgToolLib -lMfgToolLib -I$(@D)/MfgToolLib \
+       -lusb-1.0 -I$(HOST_DIR)/usr/include/libusb-1.0 \
+       -fpermissive -Wno-write-strings
+
+define HOST_MFGTOOLS_CLI_BUILD
+       $(HOST_CONFIGURE_OPTS) $(MAKE) CC="$(HOSTCXX)" \
+               CFLAGS="$(HOST_MFGTOOLS_CFLAGS)" -C $(@D)/TestPrgm
+endef
+
+HOST_MFGTOOLS_POST_BUILD_HOOKS += HOST_MFGTOOLS_CLI_BUILD
+
+define HOST_MFGTOOLS_INSTALL_CMDS
+       $(INSTALL) -D -m 755 $(@D)/MfgToolLib/libMfgToolLib.so \
+               $(HOST_DIR)/usr/lib/libMfgToolLib.so
+       $(INSTALL) -D -m 755 $(@D)/TestPrgm/mfgtoolcli \
+               $(HOST_DIR)/usr/bin/mfgtoolcli
+endef
+
+$(eval $(host-cmake-package))

diff --git a/package/mfgtools/readme.txt b/package/mfgtools/readme.txt
new file mode 100644 (file)
index 0000000..d54781f
--- /dev/null
+++ b/package/mfgtools/readme.txt
@@ -0,0 +1,69 @@
+MfgTools Howto
+==============
+
+1. Build your mfgtool image
+
+Make sure to enable the following Buildroot options:
+
+BR2_PACKAGE_FREESCALE_IMX=y
+BR2_PACKAGE_IMX_UUC=y
+BR2_TARGET_ROOTFS_CPIO=y
+BR2_TARGET_ROOTFS_CPIO_GZIP=y
+BR2_TARGET_ROOTFS_CPIO_UIMAGE=y
+
+Also modify your kernel configuration to have:
+
+CONFIG_USB_GADGET=y
+CONFIG_USB_MASS_STORAGE=y
+CONFIG_FSL_UTP=y
+CONFIG_MMC_BLOCK_MINORS=16
+
+2. Go into the output and create the necessary folders
+
+$ cd output
+$ mkdir -p "Profiles/Linux/OS Firmware/firmware"
+
+3. Create your XML update script named ucl2.xml
+
+You can find a sample XML at:
+
+$ wget https://storage.googleapis.com/boundarydevices.com/ucl2.xml \
+  -O Profiles/Linux/OS\ Firmware/ucl2.xml
+
+4. Copy the U-Boot, Kernel and initramfs images to the appropriate
+folder
+
+$ cp images/u-boot.imx images/zImage images/imx6q-sabrelite.dtb \
+  images/rootfs.cpio.uboot Profiles/Linux/OS\ Firmware/firmware/
+
+5. Copy the prebuilt binaries to be flashed
+
+Depending on your ucl2.xml file, the sample doesn't flash anything.
+
+6. Run the MfgTools client:
+
+$ ./host/usr/bin/mfgtoolcli -l mmc -s uboot_defconfig=imx \
+  -s dtbname=imx6q-sabrelite.dtb -s initramfs=rootfs.cpio.uboot \
+  -s mmc=1 -p 1
+
+For more information about the tools options, please read the
+"Manufacturing Tool V2 Quick Start Guide.docx" documentation contained
+in every mfgtools package from NXP website[1].
+
+Note: All the above commands require your Linux host user to have
+permissions to access the USB devices. Please make sure to have udev
+rules that allow the user to communicate with the BootROM IDs
+(Freescale USB recovery) as well as the one used for the UTP Linux
+image (0x066F:0x37FF).  Using 'sudo' in front of the mfgtoolcli
+command would also grant you the necessary permission but it is *not*
+recommended.
+
+Also, if your U-Boot environment doesn't include mfgtools bootargs,
+make sure to set the following:
+
+setenv bootargs "console=${console},${baudrate} g_mass_storage.stall=0 \
+       g_mass_storage.removable=1 g_mass_storage.idVendor=0x066F \
+       g_mass_storage.idProduct=0x37FF g_mass_storage.iSerialNumber=\"\" \
+       g_mass_storage.file=/fat"
+
+[1] http://www.nxp.com/products/software-and-tools/software-development-tools/i.mx-software-and-tools/i.mx-6-series-software-and-development-tool-resources:IMX6_SW