= Updating Legacy 825 Apps to run on 825gen2 =

1. In new 825 development VM import Eclipse IDE import the legacy project, or checkout the project from an SVN repository.
2. Right-click on the project in Eclipse and select "Build Configurations", "Manage..."
3. Click "New..." and type for the "Name:" input "Debug-ARM825". Selected "Copy settings from "Existing configuration - Debug". Click "OK".
4. There is now a duplicated build configuration. We will change this configuration to compile for the new 825. 
5. Right-click on the project and select "Properties...", Select "Settings" and "Tool Settings". 
6. Select "GCC C++ Compiler". The "Command:" will show "m68k-uclinux-g++". Change this to "aarch64-none-linux-gnu-g++". This changes the compiler to compile for the ARM64 architecture.
7. Select "GCC C++ Linker". The "Command:" will show "m68k-uclinux-g++". Change this to "aarch64-none-linux-gnu-g++". This changes the linker to link the project for the ARM64 architecture. Linking is the process of combining the already compiled code modules and libraries to create the executable.
8. In some cases the project may also have a "GCC C Compiler". If so change the command to "aarch64-none-linux-gnu-gcc".
9. In some cases the project may also have a "GCC Assembler". If so change the command to "aarch64-none-linux-gnu-as".
10. Click the "Build Artifact" tab. Change the output prefix to "/srv/nfs/arm825_nand/apps/"
11. Click "Apply".
12. Go back to "Tool Settings" and under "GCC C++ Compiler" select "Include paths". Click the green plus icon to add a path. Add the path "/opt/arm64include". If there is a "GCC C Compiler" section also add this path to the includes there.
13. Under the "GCC C++ Linker" select "Libraries". Add the libraries "rt", "${UI_LIBS}" and "pthread".
14. Under "Library search path" click the green plus icon and add the path "/opt/arm64lib"
15. Under "GCC C++ Compiler" select "Preprocessor". Click the green plus icon to add the symbol "ARM64=1" This is used for conditional compilation. If there is also a "GCC C Compiler" section select "Preprocessor under that and also add the symbol "ARM64=1".
16. Click "Apply and Close".
17. It is also recommended to create a "Release" build. Repeat the above steps, except name the build configuration "Release-ARM825" and copy the configuration from the "Release" build configuration.

A simulator build is also possible. Another page will be added to provide instructions for that.

Another page will be added with some instructions and examples for updating display screens and fonts to the new style.