-
Notifications
You must be signed in to change notification settings - Fork 0
Using SUBLIBinal
This wiki page will guide you through the process of implementing SUBLIBinal and MPLABX assuming that you have a fresh install of linux (or any other operating system) on your computer.
- Step 1: Install MPLABX
- Step 2: Download the Source Code or Clone SUBLIBinal
- Step 3: Configure MPLABX Projects
- Step 4: Verify Functionality
The first thing you must to is install MPLABX development environment. MPLABX is used for programming PIC microcontrollers and has been developed by Microchip.
Install MPLABX from here.
It is also necessary to install the XC32 Compiler v1.40.
SUBLIBinal source code and library object file can be easily downloaded through GitHub releases! Simply download the release by downloading the object file and the source code. Place the source code and the object file into an easy to access directory, as you will include this directory in your MPLABX projects.
Alternatively, you can simply use the source code to create your own project within MPLABX. Simply download the source code and create a new library project in MPLABX. Include all source and header files and build the library project. Then, in all subsequent projects that use the library, include your library project in the "library" folder. This replaces the need for an object file.
Clone the SUBLIBinal repository onto a directory in your computer using any git tool of your choice. The repository contains project files for MPLABX to use as configuration. On windows, Git Extensions can be a great tool for working with git repositories.
On linux, navigate to your desired directory in the command line and type the command (git must be installed)
git clone git@github.com:PalouseRobosub/SUBLIBinal.git
This will create a repository of the code on your own local machine so that you may build your own library project. Please refer to downloading the source code for information about how to create a library project.
The next step will walk through how to configure an MPLABX project to utilize the SUBLIBinal library. Create a new MPLABX project (File->New Project).
- Select Standalone Project -> Next.
- Select the PIC32MX250F128B for the Device parameter, then select Next.
- Select the Licensed Debugger, then select Next.
- Select the XC32 Compiler, then select next.
- Enter a project name and select Finish.
Now, configure the project for SUBLIBinal.
- Right click the project and select Project Properties.
- Navigate down to xc32-gcc and select (underneath Conf->XC32 submenues)
- Set Option categories to "Preprocessing and messages"
- Modify "Include directories" to include the location that you placed the SUBLIBinal source code.
- Select Apply.
- Now, navigate to Libraries
- Select "Add Library/Object File..."
- Select the object file from the obj directory in the cloned repository.
- Select Apply, then OK.
Your project should now be configured to properly use SUBLIBinal! To alternatively include the library object file, right click on the "Libraries" folder within your project and navigate to the object file for SUBLIBinal located in the obj/ directory of the respitory.
SUBLIBinal was created by the Palouse Robosub Club.