OpenSIMPLY installation

Watch the learning videos on installing the OpenSIMPLY or read the description below.

Unpack the OpenSIMPLY archive to a preferred location. Go to the unpacked OpenSIMPLY directory.

 
[OpenSIMPLY directory]        
│
├──[bin]                Installation tools.
│  │
│  ├──[windows]          
│  │
│  └──[linux]           
│            
│
├──[corouty]            Corouty cooperative task manager.
│  │  
│  └──[lib]             Shared libraries.  
│     │
│     ├──[windows]    
│     │
│     └──[linux]      
│   
│
├──[doc]               Documentation.
│  │  
│  └──[html]           HTML contents. 
│   
│
├──[lib]               Packages.  
│  │  
│  ├──[delphi]
│  │  │
│  │  └──[test]        Delphi test project.
│  │ 
│  └──[lazarus]
│     │
│     └──[test]        Lazarus test projects.
│   
│   
├──[sources]           OpenSIMPLY source files.
│
│
└──[tutorial]          Tutorial projects. 
   │ 
   ├──[delphi]            
   │	                 
   ├──[lazarus]          
   │
   └──[pas]            Tutorial sources.

On Windows

Go to the "bin" subdirectory and then "windows".
Launch the "simply-setup.exe" file.
Select the preferred IDE: Delphi or Lazarus.
Pop-up help comments
- If checked (default), the sources will be prepared with special comments for pop-up help. For Delphi, these will be XML-comments for Help Insight (learn more about usage in the OpenSIMPLY documentation). For Lazarus, these will be conventional comments.
  The OpenSIMPLY documentation is a very useful addition to the pop-up help, as it contains examples and more details.
- If unchecked, the sources will contain no any special comments.
Cooperative task manager
- If checked (default), the shared libraries for the "Debug" and "Release" configurations will be installed for supported platforms.
- If unchecked, only the tutorial projects can be run on Windows.
  User simulation projects cannot be run without cooperative task manager.
Build OpenSIMPLY
- If checked (default), the OpenSIMPLY units/packages for the "Debug" and "Release" configurations will be built for supported platforms.
  Note: the selected IDE should already be installed.
- If unchecked, the OpenSIMPLY will not be built.
  If the IDE is installed, the tutorial projects can be run anyway; if the cooperative task manager is also installed, user projects can be run with sources path settings.
Press the Accept settings button.
Follow the instructions

On Linux

Go to the "bin" subdirectory and then "linux".
Make the installer file executable: chmod +x simply-setup.sh
Launch the installer:./simply-setup.sh
Confirm detected platform or select the correct one
Accept the library installing (admin privilege is required)
Select the source code type: with or without pop-up help comments
If the Lazarus IDE installed, confirm to build OpenSIMPLY.

Learn more about the usage on Linux in the "lazarus_users.txt" file of the OpenSIMPLY directory.

After installation

Launch the projects with the learning examples from the "tutorial" subdirectory.

Your OpenSIMPLY projects

Disable stack checking

The stack checking compiler option must be disabled in any OpenSIMPLY project, both in the debug and in the release configurations. This may be done using the {$S-} switch at the top of the project source, or it may also be disabled in the project options.

DEBUG conditional in Free Pascal / Lazarus

Free Pascal and Lazarus users should define the DEBUG conditional value for the debug build mode, otherwise no library debug features are available. Learn more about this in the documentation.

Uninstall OpenSIMPLY

Remove the OpenSIMPLY directory.
Remove the cooperative task manager files.
- On 32-bit Windows:
  - Delete the "corouty.dll" and "corouty_dbg.dll" files from the "System32" Windows directory.
- On 64-bit Windows:
  - Delete the "corouty.dll" and "corouty_dbg.dll" files from the "System32" Windows directory.
  - Delete the "corouty.dll" and "corouty_dbg.dll" files from the "SysWow64" Windows directory.
- On Linux:
  - Remove the "libcorouty.so" and "libcorouty_dbg.so" files from the "/usr/lib/" directory.