Building GLFPE programs from sample source for Raspberry Pi 21 Feb 2022 GLF -------------------------------------------------------------------------------- It is assumed that the reader of this document is interested in computer programming, and would like to try writing and compiling programs using tools known to work without too much fuss. It can be expensive to buy into a commercial suite for programming development, but they tend to provode a broad capabilty from the start, and enjoy widespread professional following as well as support. On the other hand, one can program with powerful tools available for free, but one needs to FIND the tools first. Many such tools are now freely available from open sources posted to the web. However, it can be time-consuming and frustrating to locate all the pieces necessary to put together a working environment, and it can be difficult getting all the pieces to actually work together. It would be nice to have a tested working environment ready download, copy to a local computer, and use right away. The GLF Programming Environment has been ported and tested to work on the RPiOS platform (derived from Debian Linux) for Raspberry Pi microcontrollers. The Raspberry Pi is a tiny, inexpensive ($35-$55) microcomputer on a small, readily available printed circuit board. Its price belies its substantial power. It runs at 1.2 MHz or more, newer versions have 1 to 4 processor cores available, and most have 1.0 Gb to 4.0 Gb of RAM available. It can run a fully modern and complete operating system, and several flavors of OS are officially avaiable (even a compact version of Windows). It has the added advantage of being able to directly interface with external electronic devices (lights, switches, other computers, etc.). For all that it is very popular at the moment, with a user base of millions, many of whom are interested in programming and tinkering. The OS for the RPi runs off a micro SD card (usually 16gb or more). The Raspberry Pi official website offers much online support, including up-to-date official operating system image files for download (BIG downloads, about 5Gb). As an alternative to the official OS images, the GLFPE for RPi is prebuilt by the author and distributed for download and installation by others (again, BIG 4Gb download). The author uses his own Raspberry Pi (and much time) to setup and test the GLFPE with sample source code. A backup of the final working system is made into such an image file, then ZIP archived for posting to a website for download. Alternatively, since the underlying OS for RPi is Gnu/Linux (Raspbian is a variant of Debian Linux), a user may start with a compatible official Raspbian release, perhaps one already installed on the user's RPi, and add the GLFPE package to it. The equivalent functionality to the distributed GLFPE RPi images can be rebuilt from the ground up in a mostly automated way from a small set of script and data files archived together for distribution by the author, with instructions (NOTE: Work In Progress, not available to public yet!). The image files distributed in this archive contain a large amount of software, documentation, and other content, all of which is known, or believed in good faith, to be free or open source, freely available and redistributable content without encumbrances of licensing which prohibit their free distribution and use. See other files in this archive for further description of license or copying terms. GLFPE is a portable working toolset for programmers ---------------------------------------------------- The GLF Programming Enironment (GLFPE) is a collection of free and open source compilers and associated programming tools assembled by the author (GLF), which port a similar complete working environment to at least three different operating systems. At this time it has been ported to and maintained for: PC compatible computers running an installed version of Windows; PC compatible computers capable of booting a live DVD or USB Linux OS; Raspberry Pi microcontroller (A,B,2,or 3) with at least 8Gb SD card (16Gb recommended). Programming languages supported, with working sample source code, are C, C++, Fortran, COBOL, Python, with more readily available. A few simple integrated development environment (IDE) tools are provided (Orwell Dev-C++, V IDE, Code::Blocks, Geany), which the author uses and reistributes. Programmers tend to be stubborn about preferences, though, and users are free to adapt other preferred editors or IDEs as they see fit. The author will not object, neither will he help if you use Eclipse, Visual C++, Xcode, or some other such thing, but he won't help you figure it out, either. GLF provides what he uses and can tell you how to use. How the GLFPE is used on different OS systems ---------------------------------------------- The Windows version runs a suite of programs in a portable fashion, without formal installation, from a work drive assumed to be a USB stick at least 4Gb in size, preferably fast access (high speed flash and/or USB 3.0). The system essentially exists as a work drive with alot of portable applctions and data, and the only installations which might occur are for possible serial port or other hardware drivers, which must be installed into Windows itself. The author does not work for Microsoft, so he cannot give you a working copy of Windows for free. HOWEVER, he CAN give you a working copy of Gnu/Linux for free. The Linux version of the GLFPE is a complete integrated, fully runnable (and installable if so desired) operating system complete with a similar collection of tools. It runs as a live boot DVD or USB, and no commitments need be made to the host computer to run all the tools and applications. The current version is a custom built remix of Debian 11 (bullseye). As a live boot system, changes or extra sofware may be temporarily installed during a session, but the changes disappear upon the next boot. It can even be installed to a Virtual Machine (VM) running under some other OS -- it has been tested on Virtualbox. The Raspberry Pi version is an image file suitable for burning to an SD card as the actual boot drive for the RPi. It has on it a RPiOS 11 operating system very similar in nature to the Linux live boot version, but runs as an installed OS on the RPi. As an installed system, all changes made to applications or configurations are cumulative and permanent. The sample source code to compile --------------------------------- The source code distributed with GLFPE is both an offer of teaching examples and a test suite to demonstrate the functionof the compiler toolset. The sample code is voluminous and is either the personal product of the author (GLF), or the compilation of freely available examples and tutorials by others who allow it to be redistributed. It runs the gamut from simple command-line utilities to large graphical libraries for leveraging programming effort in a GUI environment. It is described more fully elsewhere in this archive, and by the commented source code itself. Use it if you wish, or don't. The author offers it to show that the system works. However, it is assumed if you are really interested in GLFPE, it is because you want to write your own programs, and you can use the toolset whether you even look at the sample code or not.