Differences

This shows you the differences between two versions of the page.

--- manual:chapter1:buildfromsource [2018/01/01 20:47]
claudio
+++ manual:chapter1:buildfromsource [2018/01/03 12:30]
claudio [Building the firmware]
@@ Line 106: / Line 106: @@
 ===== Building the Desktop simulator =====
-Open Qt Creator, select Open Project, and go into newrpl-sources, then select the newrpl-comp.pro project file.
+Open Qt Creator, select Open Project, and go into newrpl-sources, then select the newrpl-ui.pro project file.
 When prompted, just click on 'Configure project'.
@@ Line 136: / Line 136: @@
 The xxxxxxxxxxxxxx should point to suitable headers. In particular on a 64-bit system the system headers might be incompatible and cause errors. The first attempt should be to keep the defaults, and if any errors appear, it needs to be changed to /usr/include/newlib (or wherever there's a suitable 32-bit library). While newRPL will not link to or use the library in any way, some standard headers are expected to provide definitions.
+Another possible alternative for 64-bit systems is to install the package libc6-dev-i386, which in most cases should allow to keep the default directories.
 For Ubuntu it works with the defaults, for other systems change that to /usr/include/newlib, so the line reads:
 ''INCLUDEPATH += firmware/include newrpl /usr/include/newlib''
 Save and close the file.
 Now from the top menu, 'Build', 'Run QMake', then 'Rebuild All'.
 From the bottom of the screen, check the 'Compile Output' pane to see if everything went well. There might be some warnings, but there should be no hard errors. There could be many warnings, depending on your version of gcc and your system these warnings change all the time but they are harmless.
@@ Line 148: / Line 150: @@
 If you see that line, everything went well, and your build directory (usually named build-newrpl-fw-Desktop....) will contain the newrplfw.bin file, which is the ROM that needs to be flashed on the calculator.
+===== Updating the source tree to a new version =====
+When updates are made to the source tree, open a terminal session and go inside the main source directory (usually newrpl-sources), and issue:
+git pull
+This will update the source code to the lastest version. Open QtCreator and open the newrpl-comp.pro project. On the  Build menu, "Run QMake" then "Rebuild all". Check the compile output to make sure the new version was copied to newrpl/tools-bin, if not then repeat the steps "Run QMake" and "Rebuild all".
+With the updated compiler in place, close all projects, open newrpl-ui.pro and do "Run QMake" then "Rebuild all". The "Run QMake" step is not optional, needs to be manually executed to make sure the build number is updated, otherwise the VERSION command will report the incorrect build number.
+Finally, close all projects and open newrpl-fw.pro (or the equivalent for other hardware targets), and also "Run QMake" and "Rebuild all".