Cross Compile to RasPi from Linux: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ### Introduction | |
| 2 | 2 | ||
| 3 | 3 | This page is about setting up a Cross Compiler from a Linux Box to a [[Lazarus on Raspberry Pi|Raspberry Pi]]. You should be able to select arm as the CPU in Lazarus or if just using FPC, choose to use the ppcrossarm compiler and produce v6 arm binaries. Raspberry Pi is just a specific example of arm, only small changes would seem necessary on other similar platforms. | |
| 4 | 4 | ||
| 5 | 5 | - Here we talk about making armhf software, not armel, there is a very brief discussion about that lower down. | |
| 6 | 6 | - Tested on an Ubuntu 21.04 and Debian Bullseye System. Its should be similar on most mainstream Linux platforms. | |
| 7 | 7 | - This recipe assumes **you already have a current FPC** and, possibly Lazarus installed. You MUST use packages downloaded from the FPC/Lazarus SourceForge site, its most likely that FPC and Lazarus packages from your Distribution will not work as expected. | |
| 8 | 8 | - A large part of this install is done as root. Working like that gives you the potential to make a real mess of your system, please be very careful. | |
| 9 | 9 | ||
| 10 | 10 | **This page is under development and the recipe presented is still being tested.** | |
| 11 | 11 | ||
| 12 | 12 | ### Getting the necessary libraries | |
| 13 | 13 | ||
| 14 | 14 | Firstly, we are going to need some reasonably current libraries from your Raspberry Pi, as near as I can determine this is the best way to get the necessary libraries. Make sure the libraries you will need (to cross compile) are already installed on your pi. | |
| 15 | 15 | ||
| 16 | 16 | > **Note:** It possibly makes good sense to choose to make Qt5 apps for the Raspberry Pi now that the basic install of the Raspberry Pi Operating System does not include GTK2 libraries anymore. Qt5 as a dependency is a lot smaller than GTK2. So, install the necessary Qt5 libraries on the Pi before the next step, libqt5pas1 and libqt5pas-dev, they will bring along the necessary dependencies hopefully. If you are using Lazarus Main (aka trunk) then look at <https://github.com/davidbannon/libqt5pas> | |
| 17 | 17 | ||
| 18 | 18 | On the pi, we will tar up what we need, this does not need to be done as root. | |
| 19 | 19 | ||
| 20 | - | ||
| 21 | - | ||
| 20 | + | ```text | |
| 21 | + | tar czf usr_lib_arm-linux-gnueabihf.tgz /usr/lib/arm-linux-gnueabihf | |
| 22 | + | tar czf lib_arm-linux-gnueabihf.tgz /lib/arm-linux-gnueabihf | |
| 23 | + | ``` | |
| 22 | 24 | ||
| 23 | 25 | Next, we need the crt files, first, find where they are, yours may be in a directory other than the '10' shown here (thats bullseye). | |
| 24 | 26 | ||
| 25 | - | ||
| 26 | - | ||
| 27 | - | ||
| 27 | + | ```text | |
| 28 | + | raspberrypi:~ $ find / -name "crtbegin.o" 2>null | |
| 29 | + | /usr/lib/gcc/arm-linux-gnueabihf/10/crtbegin.o | |
| 30 | + | raspberrypi:~ $ (cd /usr/lib/gcc/arm-linux-gnueabihf/10 && tar czf $HOME/crt.tgz crt*.o) | |
| 31 | + | ``` | |
| 28 | 32 | ||
| 29 | 33 | Note: is probably a good idea to take these libraries from a "minimal" install rather than one with all the bells and whistles. But do make sure the libraries (and the dev version) that you will need are installed. Messy otherwise. | |
| 30 | 34 | ||
| 31 | 35 | Take these three files, 248M (or 330M with Qt5), 7M and 3K respectively to the Intel box and put them in your home directory, then, we will deal with them as root further down. They will use up some 640M of disk and probably includes libraries you will never use but its easier than trying to work out exactly what you do need. | |
| 32 | 36 | ||
| 33 | 37 | ### Edit fpc.cfg | |
| 34 | 38 | ||
| 35 | 39 | **Evidence is this step is unnecessary, just ignore it for now, further research is indicated** Only one change is necessary, must tell the compiler which particular arm cpu we are targeting. | |
| 36 | 40 | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 41 | + | ```text | |
| 42 | + | #ifdef cpuarm | |
| 43 | + | -CpARMV6 | |
| 44 | + | -CfVFPV2 | |
| 45 | + | -OoFASTMATH | |
| 46 | + | #endif | |
| 47 | + | ``` | |
| 42 | 48 | ||
| 43 | 49 | If your fpc.cfg is in /etc and it probably is, you will need to do that edit as root, thats OK, we are about to do a whole load of stuff as root. So, from now on, you will be running as root, that means great care must be used. Note these instructions are meant to be copied and pasted, one by one. They are not a script ! | |
| 44 | 50 | ||
| 45 | 51 | ### sudo | |
| 46 | 52 | ||
| 47 | 53 | OK, here we must become root, that implies very careful ! Most linux systems allow sudo, if not, try su - | |
| 48 | 54 | ||
| 49 | 55 | If you do not have the root password (or don't want to use it), then reconside this whole operation, you can install the base compiler into user space from a tarball and build Lazarus from source, again in user space. Pretty good way to work, you will need to adjust the various paths accordingly. | |
| 50 | 56 | ||
| 51 | - | ||
| 57 | + | ```text | |
| 58 | + | sudo -i | |
| 59 | + | ``` | |
| 52 | 60 | ||
| 53 | 61 | ### Install the Pi Libraries | |
| 54 | 62 | ||
| 55 | 63 | Next, we need to install the needed libraries from a Pi from those tar balls we moved over before. The new libraries all end up in /usr/lib/arm-linux-gnueabihf - so easy clean up if necessary. | |
| 56 | 64 | ||
| 57 | - | ||
| 58 | - | ||
| 59 | - | ||
| 60 | - | ||
| 65 | + | ```text | |
| 66 | + | cd / | |
| 67 | + | tar xzf /home/"$SUDO_USER"/usr_lib_arm-linux-gnueabihf.tgz | |
| 68 | + | tar xzf /home/"$SUDO_USER"/lib_arm-linux-gnueabihf.tgz | |
| 69 | + | tar xzf /home/"$SUDO_USER"/crt.tgz -C /usr/lib/arm-linux-gnueabihf | |
| 70 | + | ``` | |
| 61 | 71 | ||
| 62 | 72 | Next, install some needed things and symlink them up to what Lazarus expects to find. | |
| 63 | 73 | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 74 | + | ```text | |
| 75 | + | apt install binutils-arm-linux-gnueabihf | |
| 76 | + | ln -s /usr/bin/arm-linux-gnueabihf-ld /usr/bin/arm-linux-ld | |
| 77 | + | ln -s /usr/bin/arm-linux-gnueabihf-as /usr/bin/arm-linux-as | |
| 78 | + | ln -s /usr/bin/arm-linux-gnueabihf-objcopy /usr/bin/arm-linux-objcopy | |
| 79 | + | ln -s /usr/bin/arm-linux-gnueabihf-strip /usr/bin/arm-linux-strip | |
| 80 | + | ``` | |
| 69 | 81 | ||
| 70 | 82 | ### Build the Cross Compiler | |
| 71 | 83 | ||
| 72 | 84 | OK, now we build the cross compiler and a set of pre compiled arm units. | |
| 73 | 85 | ||
| 74 | 86 | ``` bash | |
| 75 | 87 | export FPCVER="3.2.2" | |
| 76 | 88 | cd /usr/share/fpcsrc/"$FPCVER"/ | |
| 77 | 89 | ||
| 78 | 90 | make clean all FPMAKEOPT="-T 4" CPU_TARGET=arm OPT="-dFPC_ARMHF" CROSSOPT="-CpARMV6 -CaEABIHF" CROSSBINDIR=/usr/arm-linux-gnueabihf/bin | |
| 79 | 91 | ||
| 80 | 92 | make crossinstall OS_TARGET=linux CPU_TARGET=arm OPT="-dFPC_ARMHF" CROSSBINDIR=/usr/arm-linux-gnueabihf/bin CROSSOPT="-CpARMV6 -CaEABIHF" INSTALL_PREFIX=/usr | |
| 81 | 93 | ||
| 82 | 94 | ln -sf /usr/lib/fpc/"$FPCVER"/ppcrossarm /usr/bin/ppcrossarm | |
| 83 | 95 | ``` | |
| 84 | 96 | ||
| 85 | 97 | OK, done, Control-D to get out of that somewhat dangerous root access and test ! | |
| 86 | 98 | ||
| 87 | 99 | ### Test | |
| 88 | 100 | ||
| 89 | 101 | Testing fpc functionality is easy, put the hello world source in a file, hello.pas and try this - | |
| 90 | 102 | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 103 | + | ```text | |
| 104 | + | db@U2104G-VirtualBox:~/Pascal/console$ ppcrossarm hello.pas | |
| 105 | + | Free Pascal Compiler version 3.2.2 [2021/07/19] for arm | |
| 106 | + | Copyright (c) 1993-2021 by Florian Klaempfl and others | |
| 107 | + | Target OS: Linux for ARMEL | |
| 108 | + | Compiling hello.pas | |
| 109 | + | Linking hello | |
| 110 | + | 4 lines compiled, 0.1 sec | |
| 111 | + | ``` | |
| 98 | 112 | ||
| 99 | - | ||
| 100 | - | ||
| 113 | + | ```text | |
| 114 | + | db@U2104G-VirtualBox:~/Pascal/console$ file hello | |
| 115 | + | hello: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), statically linked, for GNU/Linux 2.0.0, stripped | |
| 116 | + | ``` | |
| 101 | 117 | ||
| 102 | 118 | You can move that binary over to a Pi and test it really works. Note this test uses no additional libraries so is not a complete test. | |
| 103 | 119 | ||
| 104 | 120 | Testing the Lazarus functionality is more involved, fire up Lazarus, open a new project, maybe set a control or two on it, open Project-\>ProjectOptions-\>ConfigAndTarget and set ProjectCPUFamily to 'arm'. You probably will find a few missing dev libraries, remember that are usually just symlinks from the actual library to the base name, easier to make that link than go back to your Pi. | |
| 105 | 121 | ||
| 106 | 122 | Compile and see if the binary looks like this - | |
| 107 | 123 | ||
| 108 | - | ||
| 109 | - | ||
| 124 | + | ```text | |
| 125 | + | db@U2104G-VirtualBox:~/Pascal/ArmTest$ file project1 | |
| 126 | + | project1: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux.so.3, for GNU/Linux 2.0.0, not stripped | |
| 127 | + | ``` | |
| 110 | 128 | ||
| 111 | 129 | ### Further Information | |
| 112 | 130 | ||
| 113 | 131 | This page is about making **armhf** software, that suits arm chips using hardware floating point capabilities. The current Raspberry Pi is an example. The alternative is the **armel** or soft float arm chip, it too appears in many systems. It is possible that omitting the OPT="-dFPC_ARMHF" bit from the above command lines may make it work for soft float. That has not been tested ! | |
| 114 | 132 | ||
| 115 | 133 | Binaries can be ArmV6 or ArmV7 (or even ArmV8 but different rules apply) in either armhf or armel instruction set. Generally soft float arm software may run on (eg) a Raspberry Pi but it may also confuse your package manager. Again, theoretical advice. | |
| 116 | 134 | ||
| 117 | 135 | I found the **readelf** command useful for looking at a resulting binary after compilation, try the following - | |
| 118 | 136 | ||
| 119 | - | ||
| 120 | - | ||
| 121 | - | ||
| 137 | + | ```text | |
| 138 | + | readelf -a mybinary | grep Tag [enter] | |
| 139 | + | ... | |
| 140 | + | readelf -h mybinary [enter] | |
| 141 | + | ``` | |
| 122 | 142 | ||
| 123 | 143 | Another useful tip when playing in this space is to use Lazarus's Tools-\>RefreshFPCSource menu entry after making changes to the FPC config. | |
| 124 | 144 | ||
| 125 | 145 | ## See Also | |
| 126 | 146 | ||
| 127 | 147 | - [[Cross compiling|Cross Compiling]] | |
| 128 | 148 | - [[Installing Lazarus]] | |
| 129 | 149 | - [[Installing the Free Pascal Compiler]] | |
| 130 | 150 | ||
| 131 | 151 | --- | |
| 132 | 152 | *From the Free Pascal wiki, page "Cross Compile to RasPi from Linux", as it stood on 2023-10-10 after a change by Dbannon, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 133 | 153 | Category: Cross compilation | |
| 134 | 154 | Category: Linux |