Merge pull request #94 from nasa/integration-candidate

Integration candidate: 2020-05-20

Guide-GroundSystem.md

@@ -1,4 +1,4 @@
-# cFS Ground System Version 2.1.9
+# cFS Ground System Version 2.1.10
 
 ## cFS Ground System Info
 

Guide-GroundSystem.txt

@@ -1,4 +1,4 @@
-cFS Ground System Version 2.1.9
+cFS Ground System Version 2.1.10
 
 cFS Ground System Info:
 

Guide-Loading-Tables.md

@@ -0,0 +1,51 @@
+# Loading Table(s) - Guide
+
+## Reference: cFE User's Guide
+Reference URL: https://github.com/nasa/cFS/blob/gh-pages/cFE_Users_Guide.pdf
+
+1. Make sure the table image you want to load is in the on-board computer. 
+1. Open Your GroundSystem. 
+    1. Select "Start Command System".
+    1. Select "Display Page" next to Table Services. This will take you to "Table Services" menu.
+    1. Select "Send" next to "CFE_TBL_LOAD_CC". 
+    1. Enter the location and name of the table file you want to load in the input section:
+
+        Example: `/cf/MyTblDefault2.tbl`
+
+    1. Select "send". If successful, you should see an event:
+
+        `"Successful load of '/cf/<Your_Table_File_Name>' into '<Your_APP>.<Your_Table_Name>' work buffer"`
+
+    1. At this point, your table is loaded but still "inactive". Before you can "activate" the table, you will have to "validate" it. Go back to "Table Services" menu.
+    1. Select "Send" next to "CFE_TBL_VALIDATE_CC".
+    1. There are two rows, "ActiveTblFlag" and "TableName". Fill it out accordingly.
+
+        Example:
+
+        `CFE_TBL_INACTIVE_BUFFER` for ActiveTblFlag
+        `TO_LAB_APP.MyTblDefault` for TableName 
+
+        Note - TableName is the actual table name, not the table file name. 
+    1. Select "Send". If successful, you should see an event:
+
+        `"<Your_App_Name> validation successful for Inactive '<Your_App_Name>.<Your_Table_Name>'"`
+
+    1. Last step is to activate it. Go back to "Table Services" menu.
+    1. Select "Send" next to "CFE_TBL_ACTIVATE_CC". 
+    1. Enter the table name you want to activate.
+
+        Example: `TO_LAB_APP.MyTblDefault`
+
+        Note - This is the full table name, not your table file name. 
+
+        If successful, you should see an event:
+
+        `"<Your_App_Name> Successfully updated '<Your_App_Name>.<Your_Table_Name>'"`
+
+## Note(s)
+
+1. If you have an event that says the message is invalid when you send "validate" or "activate" command, check your ground station packet definitions vs. your cFS definitions. There could be a mismatch between the lengths.
+
+1. If you "validate" or "activate" and no events or errors occurred, your application is not passing through the "Table Manage API". "Validate" and "activate" are application level implementations. Check if you have:
+    1. `CFE_TBL_Manage` implemented.
+    1. `CFE_TBL_Manage` is being called.

README.md

@@ -4,10 +4,15 @@ This repository contains NASA's Lab Ground System (cFS-GroundSystem), which is a
 
 This lab application is a non-flight utility ground system to interact with the cFS. It is intended to be located in the `tools/cFS-GroundSystem` subdirectory of a cFS Mission Tree. The Core Flight System is bundled at <https://github.com/nasa/cFS> (which includes cFS-GroundSystem as a submodule), which includes build and execution instructions.
 
-See Guide-GroundSystem.txt for more information.
+See [Guide-GroundSystem.md](https://github.com/nasa/cFS-GroundSystem/blob/master/Guide-GroundSystem.md) for more information.
 
 ## Version History
 
+### Development Build: 2.1.10
+
+- Change documentation for table loading guide to markdown
+- See <https://github.com/nasa/cFS-GroundSystem/pull/94>
+
 ### Development Build: 2.1.9
 
 - Upgrading PyQt4 to PyQt5 and includes a lot of cleanup/refactoring, and changes to the GUI itself