Difference between revisions of "Installation AROS"

From Freepascal Amiga wiki
Jump to navigation Jump to search
m (explanation for the * in file name)
m (Alb42 moved page Installation to Installation AROS: Describes AROS installation (leftover from original AROS only wiki))
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
+
== Installation of Free Pascal on a AROS machine ==
== Installation of Freepascal on a AROS i386 machine ==
 
  
 
=== You need: ===
 
=== You need: ===
* a fully installed AROS i386 ABIv0
+
* a fully installed AROS
* developer tools (try to type ''ld'' in a shell if you get ''"ld: no input files"'' then everything is ok) should be included in all major distributions. If not you have to download the [//aros.sourceforge.net/nightly.php nightly iso] from AROS page open it and copy the ''Developer'' folder to your ''System:''
+
** i386 ABIv0: Icaros, AEROS, nightly
* binary release of [//blog.alb42.de/fpc-aros/ fpc-aros-i386]
+
** ARM ABIv0/ABIv1: AEROS, nightly
 +
** x86_64, ABIv1: T100pUAD, nightly (non-SMP)
 +
** m68k: AROSVision, nightly
 +
* developer tools (try to type ''ld'' in a shell if you get ''"ld: no input files"'' then everything is ok) should be included in all major distributions. If not you have to download the nightly ISO or contrib from AROS page extract it and copy the ''Developer'' folder to your ''System:''
 +
* binary release of [//blog.alb42.de/fpc-aros/ fpc-aros] (i386, ARM, x86_64) or [//blog.alb42.de/fpc-amigaaros-m68k/ fpc-aros-m68k]
  
 
=== Before installing ===
 
=== Before installing ===
If you want to install the FreePascal from the archive and choose not to install it over an existing installation of FreePascal (as can be found on distributions like Icaros), then you have to make sure the existing installation is 'deactivated'.  
+
If you want to install the Free Pascal from the archive and choose not to install it over an existing installation of Free Pascal (as can be found on distributions like Icaros), then you have to make sure the existing installation is 'deactivated'.  
  
You can check where and if an current installation is present by opening a shell and type "which fpc" (without the quotes) and pressing enter. If this prints a result then a current installation of Freepascal is 'active'. If you type "path" (without quotes) and press the enter key in the shell, you could see the currently active paths. If you see a path which looks similar to Device:Drawerx/drawery/fpc/bin (especially the last part fpc/bin) then this path should be removed as well. In Icaros this can be done by editing the file s:icaros-sequence, and look for an entry that looks like "PATH Device:Drawerx/drawery/fpc/bin ADD".
+
You can check where and if an current installation is present by opening a shell and type "which fpc" (without the quotes) and pressing enter. If this prints a result then a current installation of Free Pascal is 'active'. An Installation will deactivate this folder on next reboot, if you want to keep it as fallback you should keep the folder in mind
  
This entry needs to be either removed in case you choose the Easy Way of installation or changed to where you installed FreePascal when choosing the Expert way of installation.
+
=== Easy way (stable version) ===
  
=== Easy way ===
+
An official installer is provided for:
 
+
* [https://freepascal.org/down/arm/aros.html ARM AROS]
Easiest way to install it, but you get a mix up of the C Developer files of AROS and the Freepascal files.
+
* [https://freepascal.org/down/i386/aros.html i386 AROS]
 +
* [https://freepascal.org/down/m68k/amiga.html m68k AROS] It's actually m68k Amiga, but compatible
  
 
Installation:
 
Installation:
* Unpack the archive file to ''RAM:''
+
* You need a Installer
* Copy the contents of the folder ''pp'' to ''Development:'' (in most cases it points to ''System:Development'')
+
* Unpack the archive file to a temp folder
* open shell and type ''fpc'' if you get help for fpc then everything is ok
+
* Start the installer follow instructions
 +
* Restart AROS
  
=== For Experts ===
+
=== For Experts (trunk version) ===
  
Better way of installing freepascal to an own folder with all files included, but needs some more work and understanding how AROS work.
+
Get the [https://blog.alb42.de/fpc-aros/ trunk package] for your AROS version
  
 
Installation:
 
Installation:
  
* make sure you removed all other/older fpc versions from the path
+
* Unpack the archive file to a folder where you like to have the installation
* Unpack the archive file
+
* Create an assign FreePascal: to the ''pp'' folder (for example in s:user-startup)
* in the folder ''pp'' all freepascal related programs, libaries, object, units and examples are included
+
* Add the binary location to path (for example in s:user-startup)
* make sure the ''PATH'' is pointed to the ''bin'' Folder
+
** i386: ''setpath Freepascal:bin/i386-aros add''
* edit the ''bin/fpc.cfg'' and change all ''-FU:Development:''... to your pathes
+
** ARM: ''setpath Freepascal:bin/arm-aros add''
* if you want to use the FP-Editor you have to do the same changes in ''fp/fp.cfg''
+
** x86_64: ''setpath Freepascal:bin/x86_64-aros add''
 +
** m68k: ''setpath Freepascal:bin/m68k-amiga add''
  
 +
* if you do not want to create an assign you can also edit the ''fpc.cfg'' and ''fp.cfg'' and add your personal path directly there
  
== Compile Freepascal from Source ==
+
== Compile Free Pascal i386-aros from Source ==
  
A very brief description how the freepascal can be compiled from the source.
+
A very brief description how Free Pascal for i386-aros can be compiled from the source. For the other targets are comparable.
  
 
=== On a AROS i386 machine ===
 
=== On a AROS i386 machine ===
  
Every standard i386 AROS machine is suitable hosted or native, 500 Mb RAM should be available (maybe less will work I never tried) and around 300Mb harddisk space. You need an already installed freepascal compiler (see above), because freepascal is written in pascal.
+
Every standard i386 AROS machine is suitable hosted or native, 500 MiB RAM should be available (maybe less will work I never tried) and around 300MiB harddisk space. You need an already installed Free Pascal compiler (see above), because Free Pascal is written in Pascal.
  
* Download the latest [//blog.alb42.de/fpc-aros/ Source release]
+
* Get the latest Free Pascal source
* Copy the downloaded: ''fpcsrc-*.tgz'' to the folder, where you want to place the source
+
** via svn: ''svn checkout [http://svn.freepascal.org/svn/fpc/trunk http://svn.freepascal.org/svn/fpc/trunk] fpc''
* Extract the source with: (replace the * with the date used the the downloaded file for example: ''fpcsrc-20131120.tgz'')
+
** via zip: from the [http://freepascal.org/develop.var Free Pascal Development Page]
<source lang=text>
+
* A folder ''fpc'' is created with the sources inside, change to the folder
tar -zxvf fpcsrc-*.tgz
 
</source>
 
* A folder ''fpcsrc'' is created with the sources inside, change to the folder
 
<source lang=text>
 
cd fpcsrc
 
</source>
 
* We have to create the ''Makefiles'' for compilation. Usually the ''Makefiles'' are created by ALB already and included in the archive, but to be sure, lets create them again. If you get error messages like ''The Makefile does not support i386-aros'' when running ''make'' run ''fpcmake'' in the folder where the error appear.
 
 
<source lang=text>
 
<source lang=text>
fpcmake -r
+
cd fpc
 
</source>
 
</source>
* navigate to the compiler:
+
* navigate to the compiler (in principle you could also start in the top dir, but then you get path problems unix <> amiga style pathes):
 
<source lang=text>
 
<source lang=text>
 
cd compiler
 
cd compiler
 
</source>
 
</source>
* compile the compiler (in principle you could also start in the top dir, but then you get path problems unix <> amiga style pathes) needs long time because the compiler will be build twice, frist with the "old" already installed fpc and the again with the freshly build fpc
+
* Compile the compiler. It needs long time because the compiler will be build twice, frist with the "old" already installed fpc and the again with the freshly build fpc
 
<source lang=text>
 
<source lang=text>
 
make
 
make
Line 75: Line 75:
 
make install
 
make install
 
</source>
 
</source>
* As next step we compile an install the rtl so we change to rtl folder compile and install it. The rtl contains very basic functions of freepascal without them the compiler is rather useless (at least the system unit is always needed). The units will be installed into ''pp:units/i386-aros/rtl''
+
* As next step we compile an install the rtl so we change to rtl folder compile and install it. The rtl contains very basic functions of Free Pascal without them the compiler is rather useless (at least the system unit is always needed). The units will be installed into ''pp:units/i386-aros/rtl''
 
<source lang=text>
 
<source lang=text>
 
cd /rtl
 
cd /rtl
Line 81: Line 81:
 
make install
 
make install
 
</source>
 
</source>
* Now we have an already useable fpc, but of course we want all the additional packagaes as well (and the FP-IDE) so we compile all the packages. There are  some more aros specific in ''arosunits'' included. The units will be also installed to ''pp:units/i386-aros'' every packages with its own folder.
+
* Now we have an already useable fpc, but of course we want all the additional packages as well (and the FP-IDE). We compile all the packages. There are  some more aros specific in ''arosunits'' included. The units will be also installed to ''pp:units/i386-aros'' every packages with its own folder.
 
<source lang=text>
 
<source lang=text>
 
cd /packages
 
cd /packages
Line 93: Line 93:
 
make install
 
make install
 
</source>
 
</source>
* if you want to compile the ''fpcmake'' util (compare 5. Point) you can find it in ''fpcsrc/utils/'' then run:
+
* If you want to compile the ''fpcmake'' util (compare 5. Point) navigate to ''fpcsrc/utils/fpcm'' then run:
 
<source lang=text>
 
<source lang=text>
 
fpcmake
 
fpcmake
Line 99: Line 99:
 
make install
 
make install
 
</source>
 
</source>
* if you want spare some space you can clean all the compiled objects from the harddisk (or want to force a recompile after changing include files)
+
* If you want save some space you can clean all the compiled objects from the harddisk (or want to force a recompile after changing include files)
change to the directory you want to clean (or to top directory ''fpcsrc'' if you want clean all) and run:
+
change to the directory you want to clean (or to top directory ''fpc'' if you want clean all) and run:
 
<source lang=text>
 
<source lang=text>
 
make clean
 
make clean
 
</source>
 
</source>
 +
  
 
'''Attention:'''
 
'''Attention:'''
Line 117: Line 118:
  
 
=== Crosscompile from Linux ===
 
=== Crosscompile from Linux ===
TODO:
+
 
 +
==== Docker container ====
 +
 
 +
There is a ready to use docker container with Free Pascal and Lazarus
 +
 
 +
* Download archive [http://www.alb42.de/prgs/CrossAmigaLazarus.tar.gz]
 +
* follow instructions inside the archive
 +
 
 +
==== Create cross compiler ====
 +
 
 +
This section describe how the Free Pascal compiler with all units can be created under a Linux system. This could be important if you start without a working Free Pascal at AROS.
 +
 
 +
* A working Linux system (CPU is not important, i386 and x64 tested other platform might work)
 +
* A Free Pascal compiler for this Linux (atm. Version = 3.2) (e.g. at Ubuntu/Debian <code lang=shell>apt-get install fpc</code>)
 +
* You need a the pc-i386-sdk for AROS from the [http://aros.sourceforge.net/de/download.php AROS Page]
 +
* Unpack the sdk: (replace the * by the date of the downloaded file) it creates a folder with the name as the file, change into the directory
 +
<source lang=text>
 +
tar -zvxf AROS-*-pc-i386-sdk.tar.bz2
 +
cd AROS-*-pc-i386-sdk
 +
</source>
 +
* Compile and install the SDK (must be done as root, so change to root or use sudo)
 +
<source lang=text>
 +
./AROS-SDK-Install
 +
</source>
 +
* Add path to the SDK bin folder
 +
<source lang=text>
 +
export PATH=$PATH:/usr/local/aros-sdk/bin/
 +
</source>
 +
* Get the latest Free Pascal source
 +
** via svn: ''svn checkout [http://svn.freepascal.org/svn/fpc/trunk http://svn.freepascal.org/svn/fpc/trunk] fpc''
 +
** via zip: from the [http://freepascal.org/develop.var Free Pascal Development Page]
 +
* A folder ''fpc'' is created with the sources inside, change to the folder
 +
<source lang=text>
 +
cd fpc
 +
</source>
 +
* Now everything is set for make the compiler, we choose <code>zipinstall</code> to create directly a packed version <code lang=shell>fpc-3.3.1.i386-aros.tar.gz</code>
 +
<source lang=text>
 +
make zipinstall CPU_TARGET=i386 OS_TARGET=aros
 +
</source>
 +
* now you have a complete archive with the AROS Free Pascal compiler with all units and some utilities

Latest revision as of 14:05, 10 January 2021

Installation of Free Pascal on a AROS machine

You need:

  • a fully installed AROS
    • i386 ABIv0: Icaros, AEROS, nightly
    • ARM ABIv0/ABIv1: AEROS, nightly
    • x86_64, ABIv1: T100pUAD, nightly (non-SMP)
    • m68k: AROSVision, nightly
  • developer tools (try to type ld in a shell if you get "ld: no input files" then everything is ok) should be included in all major distributions. If not you have to download the nightly ISO or contrib from AROS page extract it and copy the Developer folder to your System:
  • binary release of fpc-aros (i386, ARM, x86_64) or fpc-aros-m68k

Before installing

If you want to install the Free Pascal from the archive and choose not to install it over an existing installation of Free Pascal (as can be found on distributions like Icaros), then you have to make sure the existing installation is 'deactivated'.

You can check where and if an current installation is present by opening a shell and type "which fpc" (without the quotes) and pressing enter. If this prints a result then a current installation of Free Pascal is 'active'. An Installation will deactivate this folder on next reboot, if you want to keep it as fallback you should keep the folder in mind

Easy way (stable version)

An official installer is provided for:

Installation:

  • You need a Installer
  • Unpack the archive file to a temp folder
  • Start the installer follow instructions
  • Restart AROS

For Experts (trunk version)

Get the trunk package for your AROS version

Installation:

  • Unpack the archive file to a folder where you like to have the installation
  • Create an assign FreePascal: to the pp folder (for example in s:user-startup)
  • Add the binary location to path (for example in s:user-startup)
    • i386: setpath Freepascal:bin/i386-aros add
    • ARM: setpath Freepascal:bin/arm-aros add
    • x86_64: setpath Freepascal:bin/x86_64-aros add
    • m68k: setpath Freepascal:bin/m68k-amiga add
  • if you do not want to create an assign you can also edit the fpc.cfg and fp.cfg and add your personal path directly there

Compile Free Pascal i386-aros from Source

A very brief description how Free Pascal for i386-aros can be compiled from the source. For the other targets are comparable.

On a AROS i386 machine

Every standard i386 AROS machine is suitable hosted or native, 500 MiB RAM should be available (maybe less will work I never tried) and around 300MiB harddisk space. You need an already installed Free Pascal compiler (see above), because Free Pascal is written in Pascal.

cd fpc
  • navigate to the compiler (in principle you could also start in the top dir, but then you get path problems unix <> amiga style pathes):
cd compiler
  • Compile the compiler. It needs long time because the compiler will be build twice, frist with the "old" already installed fpc and the again with the freshly build fpc
make
  • make an assign PP: to install the compiler (and later the units as well) for example:
assign pp: dh1:pp
  • Install the compiler, if all went well it can be found in pp:bin/i386-aros
make install
  • As next step we compile an install the rtl so we change to rtl folder compile and install it. The rtl contains very basic functions of Free Pascal without them the compiler is rather useless (at least the system unit is always needed). The units will be installed into pp:units/i386-aros/rtl
cd /rtl
make
make install
  • Now we have an already useable fpc, but of course we want all the additional packages as well (and the FP-IDE). We compile all the packages. There are some more aros specific in arosunits included. The units will be also installed to pp:units/i386-aros every packages with its own folder.
cd /packages
make
make install
  • As last point we can compile the FP-IDE and install it. It will also be installed to pp:bin/i386-aros.
cd /ide
make
make install
  • If you want to compile the fpcmake util (compare 5. Point) navigate to fpcsrc/utils/fpcm then run:
fpcmake
make
make install
  • If you want save some space you can clean all the compiled objects from the harddisk (or want to force a recompile after changing include files)

change to the directory you want to clean (or to top directory fpc if you want clean all) and run:

make clean


Attention: If you change something in the code you have to compile everything what depends on: For example if you changed something in rtl, you have to clean and compile the packages again or you get magic number errors when you try to use the units from packages.

cd /rtl
make clean install
cd /packages
make clean install

Usually the compiler does not need to be recompiled (with some obvious exceptions, when you fix bugs in compiler/compiler-related rtl code).

Crosscompile from Linux

Docker container

There is a ready to use docker container with Free Pascal and Lazarus

  • Download archive [1]
  • follow instructions inside the archive

Create cross compiler

This section describe how the Free Pascal compiler with all units can be created under a Linux system. This could be important if you start without a working Free Pascal at AROS.

  • A working Linux system (CPU is not important, i386 and x64 tested other platform might work)
  • A Free Pascal compiler for this Linux (atm. Version = 3.2) (e.g. at Ubuntu/Debian apt-get install fpc)
  • You need a the pc-i386-sdk for AROS from the AROS Page
  • Unpack the sdk: (replace the * by the date of the downloaded file) it creates a folder with the name as the file, change into the directory
tar -zvxf AROS-*-pc-i386-sdk.tar.bz2
cd AROS-*-pc-i386-sdk
  • Compile and install the SDK (must be done as root, so change to root or use sudo)
./AROS-SDK-Install
  • Add path to the SDK bin folder
export PATH=$PATH:/usr/local/aros-sdk/bin/
cd fpc
  • Now everything is set for make the compiler, we choose zipinstall to create directly a packed version fpc-3.3.1.i386-aros.tar.gz
make zipinstall CPU_TARGET=i386 OS_TARGET=aros
  • now you have a complete archive with the AROS Free Pascal compiler with all units and some utilities