Updating Legacy 825 Apps to run on 825gen2

1. Run the new 825 development environment VM (Virtual Machine). Open the Eclipse IDE (Integrated Development Environment).
2. Select "File" "Import" to import legacy project such as from USB flash. Alternatively, if the project is available in an SVN repository use "File" "New" "Project" "Checkout the projects from an SVN" to checkout the project.
3. Right-click on the project in Eclipse and select "Build Configurations", "Manage..."
4. Click "New..." and type for the "Name:" input "Debug-ARM825". Selected "Copy settings from "Existing configuration - Debug". Click "OK".
5. There is now a duplicated build configuration. We will change this configuration to compile for the new 825.
6. Right-click on the project and select "Properties...", Select "Settings" and "Tool Settings".
7. 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.
8. 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.
9. In some cases the project may also have a "GCC C Compiler". If so change the command to "aarch64-none-linux-gnu-gcc".
10. In some cases the project may also have a "GCC Assembler". If so change the command to "aarch64-none-linux-gnu-as".
11. Click the "Build Artifact" tab. Change the output prefix to "/srv/nfs/arm825_nand/apps/". This is where the completed app will be placed. Using this path will make it easy to test from an SSH connection into the 825. The "test825" script will automatically mount and select this path.
12. Click "Apply".
13. 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.
14. Under the "GCC C++ Linker" select "Libraries". Add the libraries "rt", "${UI_LIBS}" and "pthread".
15. Under "Library search path". Edit existing library paths as appropriate. For example change "${workspace_loc:/lib825ev/Debug}" to "${workspace_loc:/lib825ev/Debug-ARM825}"
16. Click the green plus icon and add the library path "/opt/arm64lib"
17. 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".
18. Click "Apply and Close".
19. It is also recommended to create a "Release" build. Repeat the steps above from step 3, 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.

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