Assuming that you have downloaded the libraries to the RPi in one of the ways specified in the Download section:

A Makefile that compiles the necessary files is provided in simple_makefile/. By default, it expects to find the directories for the QSL and C Library as they are placed in the repository; simply copy the Makefile into the example folder (where main.c is located) and proceed to Build and Run below. However, if you prefer to build the example somewhere else, follow these steps first:

1. Copy the SimplePublish example files and folders from examples/rpi/SimplePublish/ into a project folder of your choice on the RPi
2. Copy the two library directories into the same project folder; i.e. these two:
   1. sm_qsl/
   2. sm_clib/sm_clib/
3. Copy the Makefile found in simple_makefile/ into your project folder (where main.c is located).

4. Open the Makefile (e.g. $ nano Makefile) and edit the path to the two library folders by uncommenting the correct relative path:

   ### Directory names for QuickStart and C Library
   QSL		= sm_qsl
   CLIB	= sm_clib
   
   ### Relative path to library directories: Uncomment correct one or modify
   ## Inside same folder
   DIR_QSL		= $(QSL)
   DIR_CLIB	= $(CLIB)
   ## Repository structure
   #DIR_CLIB	= ../../../sm_clib/$(CLIB)
   #DIR_QSL		= ../../../$(QSL)

Build and Run

Build the example by calling make:

$ make

This will compile the necessary object files inside an object folder, while a target binary will be created in the same directory as the Makefile.

Run the built target binary:

$ ./main

NetBeans is a free, open source IDE that can be installed on any OS that support Java. By simply adding the RPi as a remote build host, NetBeans will make sure to synchronize files and build the project remotely; returning any console output as you run the application on your RPi.

Before starting, make sure that the RPi is powered up and connected to the network. You also need to figure out its IP address (e.g $ ifconfig on the RPi).

Install NetBeans for C/C++

On your computer, install the correct download bundle found here: https://netbeans.org/downloads/

Enable Remote Root Login

The easiest way to let NetBeans run an application that needs access the IO pins is to let it log in remotely as root. There are ways to get around this by configuring the IO, but during development it is much easier to have full root access. By default the root account is disabled in Raspbian, so first we have to enable this by setting a password. On the RPi, use the following command:

$ sudo passwd root

You can now log on as "root" with the password you set.

Now, edit the SSH configuration:

$ sudo nano /etc/ssh/sshd_config 

Search for PermitRootLogin and change it to yes (the default without-password does not work).

# Authentication:
LoginGraceTime 120
PermitRootLogin yes
StrictModes yes

Save and exit, before rebooting the RPi for the changes to take effect.

Create Project

Assuming that you have downloaded the libraries to your computer in one of the ways specified in the Download section, you can either set up the NetBeans project directly from the library structure or move the necessary folders to a project directory of your liking. NetBeans uses a concept of logical folders, and the only thing that changes is where you locate the files and libraries in the steps below, as NetBeans will take care of the necessary compilation and linking:

1. Menu > File > New Project, select C/C++ Application and press Next.
2. Set project name and location to your liking, as per above.
3. Make sure to leave Create Main File unchecked, leave the Build Host and Tool Collection to their default values for now and press Finish.

Add Raspberry Pi as Build Host

1. Select the Services tab in the left window.
2. Right click C/C++ Build Hosts > Add New Host.
3. Hostname: Enter the IP address of the Raspberry
   Port: 22
   Click Next.
4. Enter the login user name (root) and press Next.
5. NetBeans will now attempt to connect and prompt for the password you previously set.
   Press OK.
   
6. When the automatic configuration to completes, you should see a summary where NetBeans has found and set the GNU tool collection as default.
   Click Finish.
7. Select the Projects tab in the left window.
8. Right click your project > Properties.
9. Build > Build Host: Select the build host you just created.
10. Run > Console Type: Standard Output.
11. Press Apply.

Add QSL and C Library to Include Directories

While still inside project properties:

1. Build > C Compiler > Include Directories: Add the two library directories (sm_qsl and sm_clib/sm_clib/ if you add them from the repository).
2. Click Apply.

Add Posix Threads to Libraries in Linker

While still inside project properties:

1. Build > Linker > Libraries: Press the ... button
2. Press Add Standard Library... and select Posix Threads.
3. Press OK until you exit the project properties.

Add source and header files

The last thing that remains is to add all the source and header files to the project, i.e those originally placed in the repository as:

• examples/rpi/SimplePublish/
• sm_qsl/
• sm_clib/sm_clib/
  • Exceptions:
    • ports/: This contains examples for another platform, and NetBeans will complain when trying to find its dependants if you add it to the project.
    • dn_whmt.c/.h: API for the Wireless Heart Mote that we do not need.
    • dn_serial_mg.c/.h: API for the SmartMesh Manager that we do not need.

Option 1: The Clean Way

NetBeans will already have created a standard set of logical folders for you, so the cleanest way is to add the different files where they belong (skip ahead for a quicker solution):

1. Header files:
   
   1. Right click the folder Header Files > Add Existing Item...
   2. Navigate to each of the directories mentioned above (wherever you have chosen to place them) and select all the header files (except those noted as exceptions).
2. Source files:
   
   1. Right click the folder Source Files > Add Existing Item...
   2. Navigate to each of the directories mentioned above (wherever you have chosen to place them) and select all the source files (except those noted as exceptions).

Option 2: The Quick Way

Which logical folders you put what in is of no matter to NetBeans. They exist as an organizational tool for you, so a quicker alternative is to just add the three folders as a whole:

1. Right click your project > Add Existing Items from Folders...
2. Click Add Folder... and navigate to each of the directiories mentioned above (wherever you have chosen to place them).
   This will add the folders you specify as new logical folder, along with all their contents, files and subfolders alike. Thus, if you have organized the library directories inside the folder containg the example code, you only need to add the latter.
3. Because we add everything in these folders, you have to remove those noted as exceptions above:
   1. For folders: Right click > Remove

   2. For files: Right click > Remove from Project

      Remove will only remove the files from the project. Using Delete or the Delete key will also delete them from disk!

Build and Run

Make sure to set your project as main: Right click your project > Set as Main Project

You can now build your project by pressing the large hammer button (or F11 by default).
This will open a new tab in the lower Output window showing the progress as NetBeans makes sure to transfer the necessary files to the Pi, and perform the necessary commands to build the project remotely.

If the build succeeds, you can now run the project remotely by pressing the green play button (or F6 by default).
A second new tab will open in the lower Output window to display the console output from the remotely running application.

Build Files and Executable

By default, NetBeans will synchronise the project files to the RPi with a directory structure identical to that on your computer, placed inside a root folder:

/root/.netbeans/remote/<RPi IP-address>/<computer name>-<operating system>/<original path>

Within this structure, build files are placed in a build/ directory inside your project folder, while the executable is placed in a similar dist/ folder.

Say, for example, that your RPi has an IP address of 192.168.100.1, your computer is running 64 bit Windows and has the name defaultuser. If your project folder is located at C:\SimplePublishProject on your computer, the dist/ directory containing the executable can be found at:

/root/.netbeans/remote/192.168.100.1/defaultuser-Windows-x86_64/C/SimplePublishProject/dist/Debug/GNU-Linux/