SDSoC Environment API

This section describes functions in sds_lib available for applications developed in the SDSoC environment.

void sds_wait(unsigned int id)

Wait for the first accelerator in the queue identified by id, to complete. The recommended alternative is the use #pragma SDS wait(id), as described in Asynchronous Function Execution.

void *sds_alloc(size_t size)

Allocate a physically contiguous array of size bytes.

void *sds_alloc_non_cacheable(size_t size)

Allocate a physically contiguous array of size bytes that is marked as non-cacheable. Memory allocated by this function is not cached in the processing system. Pointers to this memory should be passed to a hardware function in conjunction with

#pragma SDS data mem_attribute (p:NON_CACHEABLE)

void sds_free(void *memptr)

Free an array allocated through sds_alloc()

void *sds_mmap(void *physical_addr, size_t size, void *virtual_addr)

Create a virtual address mapping to access a memory of size bytes located at physical address physical_addr.

• physical_addr: physical address to be mapped.
• size: size of physical address to be mapped.
• virtual_addr:
  • If not null, it is considered to be the virtual-address already mapped to the physical_addr, and sds_mmap keeps track of the mapping.
  • If null, sds_mmap invokes mmap() to generate the virtual address, and virtual_addr is assigned this value.

void *sds_munmap(void *virtual_addr)

Unmaps a virtual address associated with a physical address created using sds_mmap().

unsigned long long sds_clock_counter(void)

Returns the value associated with a free-running counter used for fine grain time interval measurements.

unsigned long long sds_clock_frequency(void)

Returns the frequency (in ticks/second) associated with the free-running counter that is read by calls to sds_clock_counter. This is used to translate counter ticks to seconds.