|
|
Getting started with CS++
|
|
|
=========================
|
|
|
After forking/cloning the CSPP repository you need to checkout the the desired branch.
|
|
|
Then run following commands (in bash) to initialize and update referenced submodules.
|
|
|
|
|
|
`git submodule init`
|
|
|
`git submodule update`
|
|
|
|
|
|
Next you should set the submodule sources to read-only.
|
|
|
|
|
|
chmod a-w -R .
|
|
|
|
|
|
This has the advantage to avoid unintended changes caused by saving with LabVIEW.
|
|
|
It is recommended to activate following [LabVIEW options](./LabVIEW-Options) in the category _Environment_:
|
|
|
|
|
|
- Treat read-only VIs as locked
|
|
|
- Do not save automatic changes
|
|
|
|
|
|
Simple
|
|
|
------
|
|
|
Open the _CSPP.lvproj_, adjust the pathes in the _CSPP.ini_ file and
|
|
|
run _CSPP\_StartActor:Launch CSPP\_StartActor.vi_.
|
|
|
|
|
|
Better
|
|
|
------
|
|
|
It is recommended to:
|
|
|
|
|
|
- Create a project specific copy of _CSPP.lvproj_
|
|
|
- Create your project specific ini-file, like _CSPP.ini_
|
|
|
- Sample ini-files should be available for all classes, either in the LV-Project or on disk in the corresponding class or package folder.
|
|
|
- Create and deploy your project specific shared variable libraries.
|
|
|
- Sample shared variable libraries should be available for all concerned classes on disk in the corresponding class or package folder.
|
|
|
- Run your project specific "CSPP_Main.vi" or _CSPP\_StartActor:Launch CSPP\_StartActor.vi_
|
|
|
- Build application
|
|
|
- The default build specification uses
|
|
|
- _CSPP\_StartActor:Launch CSPP\_StartActor.vi_ as startup-VI. It calls
|
|
|
- _CSPP\_UserContents.vi_; Include your project specific Content-VIs in a corresponding case of the conditional disable structure.
|
|
|
This makes building an application convenient since the application builder can find all dependencies in the VI-Hierarchy.
|
|
|
- Duplicate the default build specification and adapt it to your needs.
|
|
|
|
|
|
Even better
|
|
|
------------
|
|
|
Create your own empty git repository and add the desired submodules, e.g.
|
|
|
|
|
|
git submodule add [](https://git.gsi.de/EE-LV/CSPP/CSPP_Core/CSPP_Core) Packages/CSPP_Core
|
|
|
git submodule add [](https://git.gsi.de/EE-LV/CSPP/CSPP_Core/CSPP_ObjectManager) Packages/CSPP_ObjectManager
|
|
|
git submodule add [](https://git.gsi.de/EE-LV/CSPP/CSPP_DSC) Packages/CSPP_DSC
|
|
|
git submodule add [](https://git.gsi.de/EE-LV/CSPP/CSPP_DeviceBase) Packages/CSPP_DeviceBase
|
|
|
git submodule add [](https://git.gsi.de/EE-LV/CSPP/CSPP_IVI) Packages/CSPP_IVI
|
|
|
|
|
|
Then you create a new LabVIEW project, add the desired Content-VIs and drag the libraries from the dependencies to you virtual folder structure. |