Compile Software for the Humax - Revision history

Prpr: Fix cross-compiler link and other grammar/punctuation

2023-06-12T23:23:23Z

Fix cross-compiler link and other grammar/punctuation

MymsMan: /* Cross compiling on an external host */

2015-07-21T14:16:22Z

‎Cross compiling on an external host

MymsMan: Added Cross compilation information

2015-07-21T14:14:05Z

Added Cross compilation information

Drutt: /* Compiling on-box */

2011-08-18T19:58:15Z

‎Compiling on-box

Af123: /* Compiling on-box */

2011-08-18T16:53:23Z

‎Compiling on-box

Af123: /* Example - compiling the GNU zip (gzip) program */

2011-08-18T16:53:04Z

‎Example - compiling the GNU zip (gzip) program

Af123: /* Example - compiling the GNU zip (gzip) program */

2011-08-18T16:52:29Z

‎Example - compiling the GNU zip (gzip) program

Af123: /* Example - compiling the GNU zip (gzip) program */

2011-08-18T16:52:07Z

‎Example - compiling the GNU zip (gzip) program

Af123 at 16:51, 18 August 2011

2011-08-18T16:51:17Z

Af123 at 16:50, 18 August 2011

2011-08-18T16:50:11Z

@@ Line 1: / Line 1: @@
 == Compiling on-box ==
-It is possible to compile some software directly on the Humax itself, however due to the limited amount of CPU horsepower available, this is only recommended for fairly small packages.
+It is possible to compile some software directly on the Humax itself, however, due to the limited amount of CPU horsepower available, this is only recommended for fairly small packages.
-First you need to install the ''gcc'' and ''gawk'' packages. ''gcc'' is the compiler itself and automatically pulls in dependant packages, ''gawk'' is needed to properly support packages which use GNU autoconf, which most do.
+First you need to install the ''gcc'' and ''gawk'' packages. ''gcc'' is the compiler itself and automatically pulls in dependant packages. ''gawk'' is needed to properly support packages which use GNU autoconf, which most do.
 <pre>
@@ Line 9: / Line 9: @@
 </pre>
-After this, close your telnet session and create a new one to properly set up the environment, and you are ready to compile your first piece of software on the Humax.
+After this, close your telnet session, open a new one to set up the environment properly, and you are ready to compile your first piece of software on the Humax.
-=== Warning: Problems with floating point ===
+=== Warning: Problems with floating-point numbers ===
-Whilst programs that use floating point number functions such as rint() may compile OK on the Humax box they may not produce the correct results on execution.
+Whilst programs that use floating-point number functions such as rint() may compile OK on the Humax box, they may not produce the correct results on execution.
-This appears to be because the on box compilers are configured to use software floating point libraries rather than hardware floating point.
+This appears to be because the on-box compilers are configured to use software floating-point libraries rather than hardware floating-point.
-You can use compiler option -mhard-float to overcome the problem but this does generate warning messages from the compiler.
+You can use compiler option ''-mhard-float'' to overcome the problem, but this does generate warning messages from the compiler.
-Until this problem is resolved it is best to use the cross compiler (see below) for code that requires floating point numbers.
+Until this problem is resolved it is best to use the cross-compiler (see below) for code that requires floating-point numbers.
 === Example - compiling the GNU zip (gzip) program ===
@@ Line 61: / Line 61: @@
 </pre>
-== Cross compiling on an external host ==
+== Cross-compiling on an external host ==
-To cross compile code to run on the Humax you need another Linux system on which to run the compiler, if you don't have another spare linux box laying around you can run it on a standard Windows system using Virtual Box.   Oracle provide a number of [http://www.oracle.com/technetwork/server-storage/linux/downloads/vm-for-hol-1896500.html pre-configured Linux systems] which can be downloaded to prevent  the need for a full linux install.  You may need to update BIOS settings to enable the virtual machine to run (on HP System Configuration -> Device Configurations Enable Virtualization technology VT-x)
+To cross-compile code to run on the Humax you need another Linux system on which to run the compiler. If you don't have another spare Linux box lying around, you can run it on a standard Windows system using VirtualBox.   Oracle provide a number of [http://www.oracle.com/technetwork/server-storage/linux/downloads/vm-for-hol-1896500.html pre-configured Linux systems] which can be downloaded to prevent the need for a full Linux install.  You may need to update BIOS settings to enable the virtual machine to run (on HP System Configuration -> Device Configurations Enable Virtualization technology VT-x)
-The actual cross compiler is available from the [http://www.humaxdigital.com/uk/opensource.php HUMAX open source download site] with the specific package needed being entitled '''crosstools_hf-linux-2.6.18.0_gcc-4.2-11ts_uclibc-nptl-0.9.29-20070423_20090508.tar.bz2'''
+The actual cross-compiler is available from the [https://uk.humaxdigital.com/open-source/ HUMAX open source download site] with the specific package needed being entitled '''crosstools_hf-linux-2.6.18.0_gcc-4.2-11ts_uclibc-nptl-0.9.29-20070423_20090508.tar.bz2'''
-Before downloading you are required to create an account - very simple process
+Once downloaded to your Linux system, the file needs to be extracted under ''/opt/toolchains/'' and your path set up appropriately.
-Once downloaded to your linux system the file needs to be extracted under /opt/toolchains/ and set up your path appropriately.
+Hint: due to the excessively long path and file names, use symlinks to create shortcuts.
-Hint: due to the excessively long path and file names use symlinks to create shortcuts.
+To reduce the hassle of building software libraries such as ''libsndfile'', copy the relevant headers and libraries across from the Humax box.
-To reduce the hassle of building software libraries such as libsndfile copy the relevant headers and libraries across from the Humax box.
+If running on a 64 bit Linux system you may experience error messages when compiling such as "bad ELF interpreter: No such file or directory" due to missing 32 bit libraries. See [http://www.howtodoityourself.org/how-to-fix-libld-linux-so-2-bad-elf-interpreter-no-such-file-or-directory.html here] for how to fix.

@@ Line 65: / Line 65: @@
 To cross compile code to run on the Humax you need another Linux system on which to run the compiler, if you don't have another spare linux box laying around you can run it on a standard Windows system using Virtual Box.   Oracle provide a number of [http://www.oracle.com/technetwork/server-storage/linux/downloads/vm-for-hol-1896500.html pre-configured Linux systems] which can be downloaded to prevent  the need for a full linux install.  You may need to update BIOS settings to enable the virtual machine to run (on HP System Configuration -> Device Configurations Enable Virtualization technology VT-x)
-The actual cross compile is available from the [http://www.humaxdigital.com/uk/opensource.php HUMAX open source download site] with the specific needed being entitled '''crosstools_hf-linux-2.6.18.0_gcc-4.2-11ts_uclibc-nptl-0.9.29-20070423_20090508.tar.bz2'''
+The actual cross compiler is available from the [http://www.humaxdigital.com/uk/opensource.php HUMAX open source download site] with the specific package needed being entitled '''crosstools_hf-linux-2.6.18.0_gcc-4.2-11ts_uclibc-nptl-0.9.29-20070423_20090508.tar.bz2'''
 Before downloading you are required to create an account - very simple process

@@ Line 10: / Line 10: @@
 After this, close your telnet session and create a new one to properly set up the environment, and you are ready to compile your first piece of software on the Humax.
 === Example - compiling the GNU zip (gzip) program ===
@@ Line 53: / Line 62: @@
 == Cross compiling on an external host ==

@@ Line 6: / Line 6: @@
 <pre>
-humax# opkg install gcc gawk make
+humax# opkg install gcc gawk gmake
 </pre>

@@ Line 6: / Line 6: @@
 <pre>
-humax# opkg install gcc gawk
+humax# opkg install gcc gawk make
 </pre>

@@ Line 13: / Line 13: @@
 === Example - compiling the GNU zip (gzip) program ===
-<syntaxhighlight lang='bash'>
+<pre>
 humax# cd /mod/tmp
 humax# wget http://ftp.gnu.org/gnu/gzip/gzip-1.4.tar.gz
@@ Line 50: / Line 50: @@
 gzip 1.4
 Copyright (C) 2007 Free Software Foundation, Inc.
-</syntaxhighlight>
+</pre>
 == Cross compiling on an external host ==

@@ Line 34: / Line 34: @@
 humax# cd gzip-1.4
-humax# CFLAGS="-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64" ./configure --prefix=/mod
+humax# CFLAGS="-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64" \
 checking for a BSD-compatible install... /mod/bin/busybox/install -c
 checking whether build environment is sane... yes