Data Structures

This is a small compiled library for C data structures in the NHP Wrist center-out and other tasks.

(Return)

---

Contents

• Compiling
  • Libraries
  • In Other Projects
• Using `gcc` on Windows

Compiling

Libraries

To re-compile the static (.lib) and dynamic (.dll) libraries, use the following command:

cd %NML_NHP_C_PROJECTS%/DataStructures && gcc -c src/data_structures.c -o lib/data_structures.o && ar rcs lib/DataStructures.lib lib/data_structures.o && cp lib/DataStructures.lib ../NetworkUtilities/lib/DataStructures.lib && cp lib/DataStructures.lib ../StateServer/lib/DataStructures.lib && cp lib/DataStructures.lib ../TaskParameters/lib/DataStructures.lib && cp src/data_structures.h ../NetworkUtilities/include/data_structures.h && cp src/data_structures.h ../StateServer/include/data_structures.h && cp src/data_structures.h ../TaskParameters/include/data_structures.h && cp src/data_structures.h ../TaskController/include/data_structures.h && cp lib/DataStructures.lib ../TaskController/lib/DataStructures.lib && cp lib/DataStructures.lib ../Rewarder/lib/DataStructures.lib && cp src/data_structures.h ../Rewarder/include/data_structures.h && doxyincrement.bat && doxygen > %NML_NHP_C_PROJECTS%/doxygen_output.log

To re-compile the 32-bit static library (for PotentiometerClient), use the following command from a 32-bit MINGW32 bash terminal environment:

gcc -c src/data_structures.c -o lib/data_structures32.o && ar rcs lib/DataStructures32.lib lib/data_structures32.o && cp lib/DataStructures32.lib ../PotentiometerClient/lib/DataStructures32.lib && cp src/data_structures.h ../PotentiometerClient/include/data_structures.h

For External Use

Assume we have the following project folder structure:

my_project
|--src
|  |--my_code.c
|  |--my_code.h
|
|--include
|  |--network.h
|
|--lib
|  |--DataStructures.lib

To compile, you would use the following command:

 (bash)
gcc -o bin/my_executable.exe src/my_code.c -Llib -Iinclude -lDataStructures

Note about gcc

Note that to use gcc on a Windows 64-bit architecture, the simplest way is to download msys2, which will allow you to use pacman from an msys2 terminal. You can first check to see if you already have gcc installed:

 (bash)
pacman -Q | grep mingw-w64-x86_64-gcc

If you see anything in the terminal following this command, it means you already have gcc. Otherwise, you need to install it (and probably the rest of the toolchain, such as a linker etc.):

 (bash)
pacman -S mingw-w64-x86_64-toolchain

This will give several options for what you can install. If you are unsure what to do, just install all of them.
Finally, you may also want a toolchain for compiling 32-bit applications from your 64-bit Windows operating system. In that case, you can try:

 (bash)
pacman -S mingw-w64-i686-toolchain

The last step is to make sure the folder with the correct binaries are on your PATH environment variable. Probably the best strategy here, on a Windows device, is as follows:

1. Open the Start menu and type Environment, this should bring up a Control Panel shortcut to "Edit the System Environment Variables." Click that.
   
2. Click "Environment Variables..." at the bottom right.
   
3. Under System Variables, click "New..." and define a new environment variable: MINGW_PATH. If you installed msys2 in the default location, then go to C:/mingw64. You will be looking for the sub-folder containing binaries. In my install, that is located at C:\msys64\mingw64\bin – so that is my MINGW_PATH environment variable.
   
4. Under User Variables, find Path. Click Edit... with Path selected.
   
5. In the new popup, click New to add a new Path value. Enter MINGW_PATH (note that in Windows, you need a % sign on either side of the environment variable while in other OS you typically use $ leading the environment variable). Now, you can add or remove MINGW_PATH from the user Path variable depending on what compiler needs you have. Click on the newly added value, and click Move Up until it is at the top of the list. This ensures we don't accidentally find gcc somewhere else and use a different unintended version. Note that if you want to switch between i.e. C:\msys64\mingw32\bin and C:\msys64\mingw64\bin it might just be easiest to change the value of MINGW_PATH environment variable.