readme_GLFPE_sample_source.txt 02 Feb 2019 GLF ------------------------------------------------------------------------------------------------------- This archive contains the current compendium of GLF (Gary L. Flispart) source code and support libraries which can be compiled using the facilities of the Linux, Windows, or raspberry Pi versions of GLFPE (GLF Programming Environment). The sample source code for each OS assumes a compatible toolset of compilers, libraries, and support tools is available for use, either installed or on a USB drive. The GLFPE source trees for Linux are split into 32-bit and 64-bit versions. These match (and are tested to work with) the corresponding 32-bit and 64-bit versions of GLFPE for Linux (currently ver. 527, Jan 25, 2019), a self-contained Live Boot USB/DVD image which provides a complete operating system and build environment for the code, including all requisite libraries. Most of the required libraries are standard packages found in the Debian repositories. A few are compiled from source by GLF or automatically during the update cycle for each build of GLFPE for Linux. Equivalent sample source for Windows targets is found in yet other archives, as not all GLF programs are ported to both Windows and Linux. The GLFPE Windows tools at this time assume 32-bit targets, even when compiled and run on 64-bit versions of Windows. GLFPE sample source compilable using the Arduino IDE (1.8.5) is independent of the 32/64 bit environment, and is provided as a single archive applicable to both. The same Arduino source archive also is usable in a Windows environment provided that the Arduino IDE, PJRC Teensy extensions, and Atmel ATtiny (Mellis) extensions are properly installed. The Arduino IDE for Windows may also be run in a portable fashion from either USB or installed to C:. Windows driver installations are usually required for serial port access to Arduino and Teensy devices, but the IDE itself is portable and self-contained. The Windows sample source assumes a matching GLFPE compiler toolset including a sufficient set of requisite external libraries to satisfy all sample sources. Both toolset and sample source are structured to allow portable use from either USB or internal (C:) drive. The GLFPE Linux Live Boot images are prepared by bootstrapping from separate 686 and AMD64 compatible computer installations of Debian 9 (Stretch stable). The Debian "Live Build" package (sudo lb build) is used to periodically build an updated live boot ISO image. The configuration files to build the current (527) version are included in the archive, as well as current functional ISO images prebuilt by the author. The configuration folders included are sufficient to build new updated live boot ISOs from scratch (takes about 3 hours with a live broadband internet connection). The 64-bit and 32-bit configurations contain essentially the same list of applications, tools, and libraries, except to the extent that the different CPU architecture dictates the difference. The Arduino IDE provided as of this writing is version 1.8.7, which has been configured and tested by GLF to work for targets on many Arduino compatible types, as well as PJRC Teensy boards and ATtiny85/84 (raw Atmel controller chips). The source code provides examples of C, C++, COBOL, Fortran, Python 2, and "Processing" (for Arduino IDE) code which has been created, modified, and/or used by GLF. Most of this code also exists in versions which work for Windows computers, using GLF-prepared MinGW (GCC) compiler toolchains. However, the Linux versions are effectively self-contained and mobile, in that no specific explicit OS installation is required of the user -- just boot the Live USB/DVD partition, and all the source can be compiled from a USB stick containing the source tree. Special provisions have been made to accommodate direct execution from FAT32 USB partitions under Linux, normally prevented by the default mount options. Batch files (shell scripts) have been provided to test-compile most projects in the GLFPE source code sample archive in a continuous run which takes maybe a half hour or less to complete. The user may use the provided IDE tools to individually select, modify, and recompile any of the included projects. The IDE supported depends on the specific OS environment, and follows the original author preference (Orwell Dev-C++ for Windows, V IDE for Linux, PC or RPi). Code::Blocks IDE is also provided (or readily available) as a more expansive and universally supported IDE, available for all of the supported OS systems. The user is free to use or reject any of the sample source code and organize programming project using any tree structure, compiler, or IDE desired. The author provides the sample code in good faith and good will, and only intends to provide a demonstration of code which can compile and run on the designated systems.