Contains Propeller 2 Library, C Standard Library, examples, and documentation for p2llvm.
(eventually I'll make a docker image that has all dependnecies set up so building is a simple one-step process)
Run python build.py. The following options can be given:
--configure: Run cmake to configure building. Must be included on the first run--debug: build the debug version. This is significantly larger (and slower at compiling), but is useful during development--skip_llvm: skip building LLVM--skip_libp2: skip building libp2--skip_libc: skip building libc--install <dir>: install everything todir
If --install is not provided, libc and libp2 will be installed to where llvm was build (if they are being built), which is hardcoded to llvm-project/build_release (or llvm-project/build_debug for a debug build)
- Make sure you have the reuqired dependancies listed here https://llvm.org/docs/GettingStarted.html#software
- Initialize the llvm-project submodule in this repo.
git submodule init
git submodule update
- Create a build folder in llvm-project and change to it:
mkdir build & cd build
- Configure the project for building. This gives the basic configuration and creates Makefiles. See https://llvm.org/docs/GettingStarted.html for details on this command
cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=/opt/p2llvm -DLLVM_ENABLE_PROJECTS="lld;clang" -DCMAKE_BUILD_TYPE=Release -DLLVM_EXPERIMENTAL_TARGETS_TO_BUILD=P2 -DLLVM_TARGETS_TO_BUILD="" ../llvm-project/llvm
Make install dir something like /opt/p2llvm
- Once configured, run
make -j8
(replace 8 with how many cores you want to use). Make a sandwich, initial build took around 30 minutes on my 4-core i7 Macbook.
- Install, if desired
make install -j8
Building C/C++ code with this compile suite works like any other. Compile each source file into a .o, link them all together with ld. Below are the specific details on this. Eventually, libp2, libc, and the linker script will all be automagically included by clang, that's on the todo list. Chances are you already have clang installed on your computer (expecially if on macOS), so be sure to set up you builds to use the above install directory and not your system clang.
- Compile a source object. I use the following CFLAGS. The ciritcal ones are
--target=p2, which tells our clang build what backend to use;-fno-jump-tables(required, see wiki in docs for why); and-Os, which will make code a lot more size and speed efficient.
CFLAGS = -Os -ffunction-sections -fdata-sections -fno-jump-tables --target=p2
<llvm binaries>/clang $(CFLAGS) -o hello.o -c hello.c
- Link your objects into an executable ELF binary.
LFLAGS = --target=p2
<llvm binaries>/clang $(LFLAGS) -o hello.elf hello.o
- Load the resulting elf using loadp2
loadp2 -v -ZERO -b 230400 -t hello.elf
- To load to SPI Flash (on the P2ES or equivalent board)
loadp2 -b 230400 "@0=<this dir>/loadp2/board/P2ES_flashloader.bin,@8000+hello.elf" -t
Be sure that the "FLASH" switch is on so that the chip interacts with SPI flash.