Travis-CI:

The OS Abstraction Layer was originally devloped by the Flight Software Systems Branch at NASA Goddard Space Flight Center.

This distribution contains:

1. The OS Abstraction Layer Library
2. Tests and example applications
3. A directory structure and makefiles to manage it all.

• Add "non-zero" to the out variable description for OS_Create (and related) API's.

• Increases the buffer for context info from 128 to 256 bytes and the total report buffer to 320 bytes.

• Add stub functions for OS_TaskFindIdBySystemData(), OS_FileSysAddFixedMap(), OS_TimedRead(), OS_TimedWrite(), and OS_FileSysAddFixedMap()

• Added the following wrappers macros around UtAssert_True for commonly-used asserts:

  • UtAssert_INT32_EQ - check equality as 32 bit signed int
  • UtAssert_UINT32_EQ - check equality as 32 bit unsigned int
  • UtAssert_NOT_NULL - check pointer not null
  • UtAssert_NULL - check pointer is null
  • UtAssert_NONZERO - check integer is nonzero
  • UtAssert_ZERO - check integer is zero
  • UtAssert_STUB_COUNT - check stub count

• Using unsigned long instead of uintmax_t to fix support for VxWorks

• See #511 and #513

• Rename BSPs that can be used on multiple platforms. mcp750-vxworks becomes generic-vxworks pc-linux becomes generic-linux
• New features only, does not change existing behavior. UT Hook functions now have the capability to get argument values by name, which is more future proof than assuming a numeric index.
• Add functional test for OS_TimerAdd
• Added functional tests for OS_TimeBase Api on OS_TimeBaseCreate, OS_TimeBaseSet, OS_TimeBaseDelete, OS_TimeBaseGetIdByName, OS_TimeBaseGetInfo, OS_TimeBaseGetFreeRun
• See #487 for details

• Add functional tests for OS_IdentifyObject, OS_ConvertToArrayIndex and OS_ForEachObject functions.
• Fix doxygen warnings
• Unit test cases which use OS_statfs and run on an RTEMS IMFS volume will be skipped and categorized as "NA" due to OS_ERR_NOT_IMPLEMENTED response, rather than a failure.
• The device_name field was using the wrong length, it should be of OS_FS_DEV_NAME_LEN Also correct another length check on the local path name.
• For RTEMS, will not shutdown the kernel if test abort occurs.
• Unit tests work on RTEMS without BSP preallocating ramdisks
• If OSAL_EXT_SOURCE_DIR cache variable is set, this location will be checked first for a BSP/OS implementation layer.
• Implement OS_GetResourceName() and OS_ForEachObjectOfType(), which are new functions that allow for additional query capabilities. No impact to current behavior as the FSW does not currently use any of these new APIs.
• A functional test enhancement to bin-sem-test which replicates the specific conditions for the observed bug to occur. Deletes the task calling OS_BinSemTake() and then attempts to use the semaphore after this.
• Employ a pthread "cleanup handler" to handle the situation where a task is canceled during the pthread_cond_wait() call. This ensures that the mutex is unlocked as part of the cleanup, so other tasks may continue using the semaphore.
• Change all initial mutex locking to be a finite "timed" wait rather than an infinite wait. In all cases, the condition variable is only held for brief periods of time and should be readily available. If a task blocks for a long time, this considers the mutex "broken" and aborts, thereby avoiding deadlock. This is a "contingency" fix in that if an exception or signal or other unknown/unhandled async event occurs that leaves the mutex permanently locked.
• Adds the mutex to protect the timer callback timecb resource table.
• See #482

• OS_QueueCreate() will return an error code if the depth parameter is larger than the configured OS_MAX_QUEUE_DEPTH.
• See #477

• Resized buffers and added explicit termination to string copies. No warnings on GCC9 with strict settings and optimization enabled.
• New API to reverse lookup an OS-provided thread/task identifier back to an OSAL ID. Any use of existing OStask_id field within the task property structure is now deprecated.
• See #458

• Changes the build system.
• No more user-maintained osconfig.h file, this is now replaced by a cmake configuration file.
• Breaks up low-level implementation into small, separate subsystem units, with a separate header file for each one.
• See #444

• Adds library build, functional, and coverage test to CI
• Deprecates OS_FS_SUCCESS, OS_FS_ERROR , OS_FS_ERR_INVALID_POINTER, OS_FS_ERR_NO_FREE_FDS , OS_FS_ERR_INVALID_FD, and OS_FS_UNIMPLEMENTED from from osapi-os-filesys.h
• Individual directory names now limited to OS_MAX_FILE_NAME
• Fix tautology, local_idx1 is now compared with local_idx2
• Module files are generated when the osal_loader_UT test is built and run
• Consistent osal-core-test execution status
• See #440 for more details

• Added coverage test to OS_TimerCreate for OS_ERR_NAME_TOO_LONG.
• Externalize enum for SelectSingle, ensures that pointers passed to SelectFd...() APIs are not null, ensures that pointer to SelectSingle is not null.
• Command to run in shell and output to fill will fail with default (not implemented) setting.
• Builds successfully using the inferred OS when only OSAL_SYSTEM_BSPTYPE is set. Generates a warning when OSAL_SYSTEM_BSPTYPE and OSAL_SYSTEM_OSTYPE are both set but are mismatched.
• See #433 for more details

• Use the target_include_directories and target_compile_definitions functions from CMake to manage the build flags per target.
• Build implementation components using a separate CMakeLists.txt file rather than aux_source_directory.
• Provide sufficient framework for combining the OSAL BSP, UT BSP, and the CFE PSP and eliminating the duplication/overlap between these items.
• Minor updates (see #417)

• The more descriptive return value OS_ERR_NAME_NOT_FOUND (instead of OS_FS_ERROR) will now be returned from the following functions (): OS_rmfs, OS_mount, OS_unmount, OS_FS_GetPhysDriveName
• Wraps OS_ShMem* prototype and unit test wrapper additions in OSAL_OMIT_DEPRECATED
• Minor updates (see #408)

• Minor updates (see #401)

  • 5.0.9: DEVELOPMENT

• Documentation updates (see #375)

• Minor updates (see #369)

• Fixes memset bug
• Minor updates (see #361)

• Minor updates (see #355)

• Fixed osal_timer_UT test failure case
• Minor updates (see #350)

• Minor updates (see #334)

• Minor updates (see #292)

• Bug fixes and minor updates (see #281)

• Minor updates (see #264)

• In build verification testing to be considered for official release
• Release documentation in work
• This is a point release from an internal repository

• Released under the NOSA license, see

• See version description document

• This is a point release from an internal repository

See the document doc/OSAL-Configuration-Guide.doc for complete details.

See User's Guide: https://github.com/nasa/cFS/blob/gh-pages/OSAL_Users_Guide.pdf

An easy way to get started is to use the Linux port and classic build:

1. Set the OSAL_SRC environment variable to point to the OSAL source code.

• Running setvars.sh will set the variable for you ($source ./setvars.sh)

2. Edit the build/osal-config.mak file and set the following options:

• BSP - Set this to the board you are running on. For a PC running linux, use pc-linux
• OS - Set this to the OS you are running. For a PC running linux, use posix.
• OSAL_M32 - Uncomment/Add this build variable for building 32-bit images using "native" GCC on a 64-bit X86 Linux platform

Buiding on a PC running linux:

export OSAL_SRC = /home/acudmore/osal/src

In build/osal-config.mak:

OS=posix
BSP=pc-linux

Optional: OSAL_M32 = -m32 (Note: Usage of this flag may require an optional 'multilib' (or similar)
package to be installed. Refer to your operating system and toolchain documentation for details, if
adding the appropriate flag causes your builds to fail due to (for example) missing 32-bit or
multilib related headers or libraries.)

Optional: Some Linux systems may require an additional linker option in src/bsp/pc-linux/make/link-rules.mak:

LDFLAGS ?= $(OSAL_M32) -export-dynamic

If the symbol-api-test fails, then you need this option.

Now just type make config; make from the build directory and it should build the OSAL core files, tests, and sample applications for you. The binary for each application is in its own directory (i.e. build/examples/tasking-example/tasking-example.bin) You can switch to that directory and run it. You can also debug it using GDB.

NOTE: Running on linux may require root or adjusting the posix message queue maximum sizes.

The Embedded targets take a little more work to run, because they must be cross compiled and booted on the board. By copying a target, you should be able to come up with a new target.

If you would like just the OSAL itself, just look in src/os/inc for the include files and src/os/

The API documentation is in the doc directory.

There are two sets of tests: build/tests and build/unit-tests. To build and the unit tests, perform the build steps above then make unit-tests in the build directory.

Instructions on how to use the newely supported cmake build system are provided in the OSAL Configuration Guide located in the doc directory.

Alan Cudmore
NASA Goddard Space Flight Center
Code 582.0
Greenbelt, MD 20771
[email protected]

Copyright United States Government as represented by the Administrator of the National Aeronautics and Space Administration

This software is licensed under NASAs Open Source Agreement. The release of the software is conditional upon the recipients acceptance of the Open Source Agreement. Please see the file: NASA_Open_Source_Agreement_1_3-OS_AbstractionLayer.txt