test: Update to compile test code

NOTE: The XDC configuration is compiled to get the linker.cmd file

Signed-off-by: John Godbey <j-godbey@ti.com>
Signed-off-by: Sam Nelson <sam.nelson@ti.com>

cmake: Add cmake file for c6x TI RTOS on DRA7XX platform

Signed-off-by: John Godbey <j-godbey@ti.com>
Signed-off-by: Sam Nelson <sam.nelson@ti.com>

test: Add test code specific for TI RTOS

Signed-off-by: John Godbey <j-godbey@ti.com>
Signed-off-by: Sam Nelson <sam.nelson@ti.com>

lib: Add sources for TI RTOS support

Adds sources for TI RTOS.
Also c6x DSP specific sources

Signed-off-by: John Godbey <j-godbey@ti.com>
Signed-off-by: Sam Nelson <sam.nelson@ti.com>

lib: Add ti compiler specific files

Signed-off-by: John Godbey <j-godbey@ti.com>
Signed-off-by: Sam Nelson <sam.nelson@ti.com>

lib: Add support for TI c6x compiler

Signed-off-by: John Godbey <j-godbey@ti.com>
Signed-off-by: Sam Nelson <sam.nelson@ti.com>

system:freertos:zynqmp_r5: correct io mem mapping

This fix is to workaround the memory mapping in for ZynqMP_R5.

The root cause is in the libxil.a MPU region setting.
The base address for the region setitng in libxil is
calculated as this:

region_base = addr & ~(region_size - 1);
This will cause issue if the input addr address is
in the end of the region.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

system:generic:zynqmp_r5: correct io mem mapping

This fix is to workaround the memory mapping in for ZynqMP_R5.

The root cause is in the libxil.a MPU region setting.
The base address for the region setitng in libxil is
calculated as this:

region_base = addr & ~(region_size - 1);
This will cause issue if the input addr address is
in the end of the region.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

generic: zynq7: set the old_value init to FIQ and IRQ disabled

There can be case that FIQ and IRQ are enabled by default.
And thus, set the old_value init to FIQ and IRQ disabled.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

generic: zynqmp_r5: set the old_value init to FIQ and IRQ disabled

There can be case that FIQ and IRQ are enabled by default.
And thus, set the old_value init to FIQ and IRQ disabled.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Fixed linux_amp_demo to increment message counter on shutdown.

cmake: options: set default install bin/lib dir

In case CMAKE_INSTALL_BINDIR/LIBDIR not set, set with default
value

Signed-off-by: Wendy Liang <jliang@xilinx.com>

lib: fix install paths to work for multilib

When running multilib builds on 64-bit platforms, the system library
paths need to be adjusted to either lib64/lib32, or lib64/lib in a
distro specific way.  This is handled via CMAKE_INSTALL_LIBDIR variable.

Signed-off-by: Cyril Chemparathy <cyril.chemparathy@xilinx.com>

test: linux: threads: initialize return var

in metal_run_noblock(), error is not initialized. In the end of
the function, it will return this var. 6.2 toolchain complains
the 'error" may be used uninitialized during compilation.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

test: linux: shmem: remove unused vars

Removed unused var shmem_count

Signed-off-by: Wendy Liang <jliang@xilinx.com>

CMake: lib/include/ instead of lib/ as include dir

Using the lib/ as include directory when compiling the libmetal
can cause issues if the header files names conflict to those
in the system. And thus, need to use a different directory as the
include directory such that the headers in the lib/ will not be
included.

The headers of libmetal library needs to be included as "metal/xxxx.h"

Signed-off-by: Wendy Liang <jliang@xilinx.com>

example: generic: Add dependent libs

Add dependent libs in the CMAke file of generic examples.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

example: zynqmp_r5: fix singed and unsigned comp warning

Fix the compilation warning of comparison between signed and
unsigned of ZynqMP r5.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

linux: uio dev: open dev file only if it exists

It can take some time to have the /dev/uioX in the file system
after it binds the platform device to the UIO driver.

Check if the device file exists before trying to open the file.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

test: freertos: Add sleep API test

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add sleep functions

For now, only implement microseconds sleep function.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add timestamp implementation

Add getting timestamp API.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

freertos: Add condition var place holder

As the libmetal test will verify all the header files.
Add the condition variable place holder for FreeRTOS.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Linux:irq:move read irq fd to dev irq ack funciton

As different device may have different ways to ack the IRQ,
including how to read the IRQ fd. And thus, it is better to
move reading the IRQ fd to metal device.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Allow to use shared memory without root permission

Without root permission, we cannot get the physical address
from the virtual address from shared memory, and cannot
lock unlimited size of shared memory. However, for communication
between processes, we don't need to know the physical address
nor lock the shared memory.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add ZynqMP AMP DEMO

Add a demo on ZynqMP to demonstrate use shared memory
between A53 and R5.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Update top level README

Update the top level README file for the following API changes:
* interrupt handling added for generic and FreeRTOS
* condition variable
* spinlock
* cache operations.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

libmetal: top irq.h include lower level irq.h

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>
Signed-off-by: Wendy Liang <jliang@xilinx.com>

libmetal: fix bug in re-enabling global irq

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: protect irq register function

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: protect irq register function

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: atomic ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: atomic ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: mutex ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: irq: call mutex_deinit

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: add default poll func

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: mutex ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: mutex api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: condvar: update mutex typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: mutex: update typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: shmem ut: update typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: condvar ut: update typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: mutex: update typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: condvar: mutex typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: irq: mutex typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: mutex deinit and typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

condvar: change mutex struct to typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

mutex: change struct to typedef

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: rename default irq handler

The handler name does not need to indicate it is for any system.
And it needs to be made visible for inclusion to end user.

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: rename default irq handler

The handler name does not need to indicate it is for baremetal.
And it needs to be made visible for inclusion to end user.

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

explicit irq functions args

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: irq ut init gic

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: irq ut check retval

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

list: fix list empty checking

Determine if list is empty by checking if list->next points
to list itself.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

generic: irq ut check retval

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

Add libmetal memset_io and memcpy_io

The memcpy/memset may not work on device memory on some architecture,
as some architecture assumes the memcpy/memset will only access
aligned device memory address. We add memset_io and memcpy_io
to allow memset/memcpy unaligned device memory access.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

freertos: shmem

similar to generic api, placeholder to provide api similar to linux one

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: interrupt controller api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

linux: interrupt controller api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: interrupt controller api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: io api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: cache api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: irq ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: irq.c

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: alloc ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: add alloc api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: setup cmake for ut

Thread prototype varies from one OS to the other.
Introduce common metal_thread_t to facilitate porting.

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

freertos: setup cmake for lib

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

Add explicite includes

device.c need to include sys.h to allow overidding nb region
others files better include locally instead of from global sys.h

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

have includes use consistent format

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: set irq def under METAL_INTERNAL

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

keep consistenccy with naming conventions

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

inline alloc

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: update comments

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

Add cmake option to disable documentation

Passing -DWITH_DOC=off to cmake will skip documentation

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

Use (void)var in logger for unused arguements

Use (void)var in the logger when WITH_DEFAULT_LOGGER is off
to make the unused variable warning go away.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

use poll in generic condition variable wait

Use poll function in generic condition variable wait.
so that it is not just busy looping.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

generic: irq ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

generic: irq api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

Introduce io memory map API

This I/O memory map API is to enable memory mapping to the specified
memory region so that the system can access the specified memory region.

Add memory flags to metal_io_init()

Add memory flags argument to metal_io_init.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add memory cache flags to I/O region

Add flags to I/O region to specify:
 * If the memory is cached, what cache type it uses
 * If the region is for I/O memory
 * If cache operations is required in DMA transaction.
   * In some cases, you don't need cache operations in DMA transaction,
     E.g. A system has I/O coherency and with IOMMU enabled.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Zynq7: Add default generic system poll

Introduce default generic system poll function to allow to
wait until some event happends.
This function can be overwritten by user outside libmetal.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

ZynqMP R5: Add default generic system poll

Introduce default generic system poll function to allow to
wait until some event happends.
This function can be overwritten by user outside libmetal.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add DMA map API to generic device implementation

For generic device implementaiton,
* DMA map: copy the input scatter/gather list to the output one.
* DMA unmap: do nothing.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add Linux userspace DMA map/unmap

Implement Linux userspace DMA map/unamp libmetal APIs.
This patch only supports UIO MMIO memory.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add DMA API

This patch is to add libmetal DMA APIs:
* metal_dma_map() - map memory for DMA transaction
* metal_dma_unmap() - unmap DMA memory after DMA transaction

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add generic cache API

This patch is to implement the cache flush and invalidate
APIs for generic system.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add ZynqMP R5 generic cache APIs implementation

Add ZynqMP R5 cache APIs implementation for libmetal
generic system only.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add Zynq7 generic cache APIs implementation

Add Zynq7 cache APIs implementation for generic system only.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add Linux cache API

The cache APIs in libmetal for Linux does nothing,
because user may not be able to flush/invalidate
all cache levels from userspace.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Introduce libmetal cache APIs

The libmetal cache APIs only handle DCACHE for now.

metal_cache_flush() - flush the specified memory range in cache
metal_cache_invalidate() - invalidate the specified memory range in cache

Signed-off-by: Wendy Liang <jliang@xilinx.com>

mem alloc api ut

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

mem alloc api

Signed-off-by: Sam Sortais <sam.sortais@xilinx.com>

Linux: Initialize IRQ handling in libmetal initialization

When doing the libmetal Linux initialization, initialize
interrupts handling, which is to start the interrupt mornitoring
thread. When shutting down the Linux libmetal, shut down interrupts
handling, which is to stop the interrupt mornitorying thread.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add Linux IRQ handling

This patch implements the following functions:
* metal_irq_register() - This API is to register the interrupt
                         needed to be monitored by the IRQ monitoring
                         thread.
* metal_linux_irq_handling() - This is a thread to monitor the registered
                         interrupts and call the registered interrupt
                         handler if there is an interrupt triggered.
* metal_irq_save_disable() - Disable interrupts, this will put the IRQ
                         handling thread to wait for interrupts reenabled.
* metal_irq_restore_enable() - Reenable interrupts, this will wakeup
                         the IRQ handling thread to monitor the registered
                         interrupts.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

device: Add irq_ack device operation

Adding irq_ack device operation in case the device requires operation
after the IRQ has been handled by the application.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add irq_info to Linux UIO device handling

Store the UIO file descriptor to the irq_info data field of
the UIO metal_device. The UIO file descriptor is also the
interrupt file descriptor.

User can poll the UIO file descriptor to monitor
the interrupt.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add irq_info to metal_device structure

Add a data field irq_info to metal_device structure.
The irq_info is of type (void *), it is used to store
the device's interrupt information.

Signed-off-by: Wendy Liang <jliang@xilinx.com>

Add IRQ API

Introduce the following IRQ APIs:
* metal_irq_register() - Register interrupts handler and enable the interrupt.
* metal_irq_save_disable() - disable all interrupts
* metal_irq_restore_enable() - reenable interrupts

Signed-off-by: Wendy Liang <jliang@xilinx.com>