Update all internal OSAL code to use the typedef when creating, storing,
or otherwise dealing with abstract ID values.

Removes/fixes any code that directly compares or casts the IDs between
normal integer values.  Replace equality comparisons with inline functions
to check for equality and validity.

Update file-sys-add-fixed-map-api-test and network-api-test to
use the osal_id_t typedef and proper conversion/test functions
for manipulating object IDs.

Fix #581, Use OS_MAX_TIMEBASES for max timer create unit test

Fix #555, provide typedef for OSAL ID

Fix #537, Fail tests on startup and tear down failures

Fix some newly triggered warnings with respect to the
doxygen markup and references.  Also move the definition
of OS_file_flags_t (enum type) to the public API to satisfy a
reference issue in OS_OpenCreate().