nasa / EdsLib

CCSDS SOIS Electronic Data Sheet Tool and Library
Apache License 2.0
29 stars 12 forks source link

Simple idiomatic usage example documentation? #87

Open mbulk-aero opened 4 months ago

mbulk-aero commented 4 months ago

Is your feature request related to a problem? Please describe. Have been looking to get up to speed on this, and am trying to ensure I am using the tool idiomatically. (in C)

Have had a look at the doxygen docs and markdown documentation, but have not been able to find a minimal example of usage, I am just minimally trying to accomplish, reading an eds type from the network, unpacking to the unpacked type, and the opposite direction.

Also, have noticed that some of the doxygen docs may be out of date. Eg, in: .../group__fsw.html#build

eds_start_toplevel(TOPLEVEL_TGT)

Have looked all over github, and can't see any usage of this this, outside of inside the doxygen docs

I do see this in:

.../group__fsw.html#build

"

Example statically linked embeded C application

The statically linked embedded application is nearly identical to the ground application, except it has no need for the user-friendly name information. Therefore it can leave out the SAMPLE_EDS_NAMEDICT_APPTBL object:

/*
 * Instantiate an EDS global object that brings all elements together
 */
EdsLib_MissionObject_t SAMPLE_EDS =
{
      .AppTableSize = SAMPLE_EDS_INDEX_MAX,
      .AppDataTable = SAMPLE_EDS_DATADICT_APPTBL
};

"
But this stops just short of further usage, which is the part that personally, I have been struggling to ensure I am using the tool right.

Describe the solution you'd like Wondering if there could be a short section showing idiomatic usage. I realize, there is a chance without something like this, one might be able to accomplish usage of the database types, but perhaps not performed in the intended manner.

I realize, probably a bunch of docs might be too much overhead for this, but figure, an idiomatic simple example easily accessible might be pretty useful

But gotta say, been loving the tool, thanks for all the work you all have done! Really excited about the SOIS SEDS standard. Thanks!

gregory1207 commented 3 months ago

Ditto... :)