SimpleIDE (Any Operating System)
The following steps explain how to use PropWare's libraries - including PropWare, Simple, and libpropeller - in a SimpleIDE project. Step 2 and onward must be repeated for every new project in SimpleIDE.
- Download the libraries and header files. Extract the contents to a known location on your disk - this location will be referred to as
<PROPWARE_PATH>
throughout these steps.
- Set SimpleIDE to "Project view":
- Open the "Tools" menu and choose "Properties"
- Open the "General" tab and ensure "View Mode" is checked. Press "OK".
- Open the "Tools" menu and:
If the first option is "Set Simple View", then ignore it and press anywhere to exit the menu.
If the first option is "Set Project View", then press it.
- Ensure project source files end with
.cpp
not .c
.
- From the "Project" menu, choose "Add Include Path". Select
<PROPWARE_PATH>/include
and then press the "Open" button.
- From the "Project" menu, choose "Add Library Path". Select
<PROPWARE_PATH>/lib
and then press the "Open" button.
- Project Options
- Compiler
- "Enable Pruning" =
True
- "Other Compiler Options" =
-std=gnu++0x -fno-rtti -fno-threadsafe-statics
- Linker
- "Other Linker Options" =
-lPropWare -lLibpropeller -lSimple
Microsoft Windows
- Download PropWare for Windows.
- Execute the installer. The default installation path is recommended, but if it must be changed, ensure the installation path does not contain parenthesis (such as
C:\\Program Files (x86)
).
- Add CMake's bin folder (located in
<PROPWARE_PATH>\PWCMake\bin
) to your PATH. Excellent instructions for editing PATH exist here. For instance, if you installed PropWare to C:\PropWare
and PATH currently contains C:\propgcc\bin
, the new value would be C:\PropWare\PWCMake\bin;C:\propgcc\bin
.
Linux - Debian/Ubuntu/Mint/etc
- Download the
deb
package file.
- Use
dpkg
to install the file with: sudo dpkg -i PropWare-2.0.0-Generic.deb
. If cmake
is already installed, remove it with sudo dpkg -r cmake
.
make
is the recommended build tool to use with PropWare. If it is not already installed, install it with sudo apt-get install make
.
Linux - RedHat/Fedora/CentOS/etc
- Download the
rpm
package file.
- Use
rpm
to install the file with: sudo rpm -i PropWare-2.0.0-Generic.rpm
. If cmake
is already installed, remove it with sudo rpm -e cmake
.
make
is the recommended build tool to use with PropWare. If it is not already installed, install it with sudo yum install make
.
Mac OSX
I am unable to produce easy installation packages for Mac. My apologies. Please execute the following lines at the command line to install PropWare on your Mac:
1 wget http://david.zemon.name:8111/repository/download/PropWare_Release20/.lastSuccessful/PropWare-2.0.0-Generic-osx_cmake.zip?guest=1 -Ocmake.zip
2 wget http://david.zemon.name:8111/repository/download/PropWare_Release20/.lastSuccessful/PropWare-2.0.0-Generic-propware.zip?guest=1 -Opropware.zip
3 wget http://david.zemon.name:8111/repository/download/PropWare_Release20/.lastSuccessful/PropWare-2.0.0-Generic-examples.zip?guest=1 -Oexamples.zip
7 sudo mv pwcmake.app /Applications
8 sudo mv PropWare /Applications
9 sudo ln -s /Applications/pwcmake.app/Contents/bin/cmake /usr/local/bin/cmake
10 sudo ln -s /Applications/pwcmake.app/Contents/bin/ccmake /usr/local/bin/ccmake
11 sudo ln -s /Applications/pwcmake.app/Contents/bin/cmake-gui /usr/local/bin/cmake-gui
12 sudo ln -s /Applications/pwcmake.app/Contents/bin/cpack /usr/local/bin/cpack
13 sudo ln -s /Applications/pwcmake.app/Contents/bin/ctest /usr/local/bin/ctest
14 sudo ln -s /Applications/pwcmake.app/Contents/bin/cmakexbuild /usr/local/bin/cmakexbuild
To upgrade:
1 wget http://david.zemon.name:8111/repository/download/PropWare_Release20/.lastSuccessful/PropWare-2.0.0-Generic-osx_cmake.zip?guest=1 -Ocmake.zip
2 wget http://david.zemon.name:8111/repository/download/PropWare_Release20/.lastSuccessful/PropWare-2.0.0-Generic-propware.zip?guest=1 -Opropware.zip
3 wget http://david.zemon.name:8111/repository/download/PropWare_Release20/.lastSuccessful/PropWare-2.0.0-Generic-examples.zip?guest=1 -Oexamples.zip
7 sudo mv /Applications/pwcmake.app /Applications/pwcmake.app.bak
8 sudo mv /Applications/PropWare /Applications/PropWare.bak
9 sudo mv OSXCMake /Applications
10 sudo mv PropWare /Applications
Once you have confirmed that the new installation works as expected, remove the old one with the following two lines. NOTE: A command that starts with sudo rm -rf
has the potential to be very dangerous! I assume no responsibility if you corrupt your system. Be careful.
1 sudo rm -rf /Applications/pwcmake.app.bak
2 sudo rm -rf /Applications/PropWare.bak