4569-2020-changeup

• Use mingw
• This error message is ok: c:/mingw/bin/../lib/gcc/mingw32/8.2.0/../../../../mingw32/bin/ld.exe: c:/mingw/bin/../lib/gcc/mingw32/8.2.0/../../../libmingw32.a(main.o):(.text.startup+0xb0): undefined reference to `WinMain@16'
• Restart clion and refresh NOT rebuild cmake project

####DO NOT COMMIT PROS LIB FILES

1. Create a unity project
2. Install this Unity plugin: https://github.com/mcpiroman/UnityNativeTool

Setup a clean-slate robot repo for people to clone and build...

Write down all the clion cmake setup instructions here like going into build->cmake and adding -G "visual studio..." Maybe download cmake? Or using visual studio environment inside clion is probs good enough...

Have to set robot cmake->toolchain->gcc by using cygwin as toolchain or mingw...

EXTERNAL TOOLS FOR PROS $ProjectFileDir$ Macro DOES NOT WORK

There are also for some reason 2 separate external tool sections:

- settings->external tools
- settings->custom build configs->build tool->[...] button

NOTE: sometimes CLion Intellisense seems to stop working, so far the best workaround is to just restart it :)

###Run Configurations

- Robot -> Run this to build libRobot.a and later automatically call PROS

- RobotAPI -> Switch to this when developing for RobotAPI for proper Intellisense, CANNOT RUN

- SimulatorAPI -> Switch to and RUN when developing for simulator

- Robot Pros Compile -> Already run by "Robot" config, but if you want to JUST RUN PROS, then RUN this config 

FakeExecutable.txt --> Used to trick CLion into launching configs without actual c++ executables (ie Robot, Robot Pros Compile)

If you get an error like "No rule to make target 'path/foo.ccp', needed by 'foo.o'. Stop." Then you must have changed the PROS src/ dir and need to for some reason do a project search for the path its complaining about "path/foo.cpp" and replace it with the correct path

• robot/ --> Abstract Robot Code Via A SharedAPI. (Depends on sim/non-sim build in globals.h)
• robot_api/ --> PROS Robot API Code
• shared_api/ --> A Shared Api header Lib
• simulator_api/ --> Unity Simulator Code

1. COMPILE CMAKE ROBOT_API
2. COPY libRobotAPI.a from build dir
3. MOVE(or symlink) libRobotAPI.a into PROS firmware dir TODO: MAKE A SCRIPT FOR THIS
4. COMPILE/UPLOAD PROS

• Vex Brain Architecture "ARM 7": https://www.vexrobotics.com/276-4810.html#Product_Specs
• ARM COMPILER DOWNLOAD: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm
• ******************** USE MINGW ******************** CYGWIN DOES NOT WORK DUE TO IT APPENDING /cygdrive/c/ to paths when calling the compiler
• INSIDE CLION, FOR MINGW TOOLCHAIN, SET COMPILER TO THE DOWNLOADED ARM COMPILER
• '--specs=nosys.specs' is used to prevent compiler errors related to undefined _exit. This is since on ARM platforms, such standard methods don't exist as they do on computers or something like that... --> https://stackoverflow.com/questions/19419782/exit-c-text0x18-undefined-reference-to-exit-when-using-arm-none-eabi-gcc

I would suggest you get this if you are a student: https://education.github.com/pack

• RobotCompile --> Used in Robot, RobotAPI
• SimulatorVSCompile --> Used in SimulatorAPI

• Refrain from using DASHES or SPACES in directory names, this causes intellisense errors with MSVC

1. Unity crashes
2. Click on Windows debug option
3. https://stackoverflow.com/questions/50905878/how-to-get-the-stacktrace-of-a-dll-who-crashes

1. Open visual studio
2. Attach debugger to Unity.exe
3. Wait for crash
4. Change VisualStudio stackFrame to __CPPSimulatorAPI.dll!::{SomeNamespaceYouRecognizeHere}
5. https://stackoverflow.com/questions/50905878/how-to-get-the-stacktrace-of-a-dll-who-crashes
6. ! REMEMBER TO ADD "__CPPSimulatorAPI.pdb" as a SYMBOL IN VS

#include "shared_robot_api.h"
shared_api::__debugbreakpoint();