Rewrap README.md and add link to mailing list.

This commit rewraps the README.md content to fit within 80 columns (for
most sane editors :)).  We also add a link pointing visitors to the
mailing list hosted on googlegroups.  Please subscribe!

R5: modified xil_standalone lib and baremetal.c to sync with xilinx repo

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

R5: added xdebug.h file to xil_standalone lib

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

baremetal slave ZynqMP RPU demos: Remove calls to zynqMP_r5_map_mem_region

Remove hard coded shared memory mappings.

Signed-off-by: Edgar E. Iglesias <edgar.iglesias@xilinx.com>
Signed-off-by: Wendy Liang <jliang@xilinx.com>

libs: zynqMP_r5: baremetal: Simplify zynqMP_r5_map_mem_region and mark as Obsolete

zynqMP_r5_map_mem_region should be removed.

Signed-off-by: Edgar E. Iglesias <edgar.iglesias@xilinx.com>

libs: zynqMP_r5: baremetal: Implement platform_map_mem_region

The generic OpenAMP code uses platform_map_mem_region() to map memory
according to what it needs.

Signed-off-by: Edgar E. Iglesias <edgar.iglesias@xilinx.com>

XSDK: Add Xil_SetTlbAttributes_size

Add Xil_SetTlbAttributes_size() to enable the creation of mappings of
other sizes than 1MB.

The SDK should provide a similar function in the future.

Signed-off-by: Edgar E. Iglesias <edgar.iglesias@xilinx.com>

Improving the readme text document present in the landing page.

Merge pull request #5 from MichalPrincFSL/FSL_bugfix_create_endpoint

Fixing potential RPMsg bug: rpmsg_endpoint structure is not cleared when...

Fixing potential RPMsg bug: rpmsg_endpoint structure is not cleared when dynamically created

- this causes the hardfault @line 570 when rp_chnl is not a null pointer (writing to undefined dereferenced address)

proxy_app: Add --remoteproc to allow to specify a remoteproc

by default the proxy_app only works with zynqmp_r5_remoteproc,
adding the --remoteproc option so that we test other
remoteproc drivers.

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

baremetal demos: use SWITCH_TO_SYS_MODE() for Zynq

Due to the boot code doesn't put the processor on sys mode.
The application needs to do it at the beginning.

Once we switch to use xil_standalone lib, this patch can be
reverted.

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

libs: zc702evk: baremetal.c platform_cache_all_flush_invalidate

Use ARM_AR_MEM_DCACHE_ALL_OP(1) to clean and invalidate dcache
instead of ARM_AR_MEM_DCACHE_ALL_OP(0) to invalidate dache only.

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

Update xilinx stanadlone libs

Update Xilinx standalone libs:
* license change
* bug fixes

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

zynq sample makefiles: update to define macro for Zynq A9.

The code in the sample apps differs between ZynqMP R5 and Zynq A9.
We use macro in makefile to differentiate them.

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

zc702evk baremetal: update platform_map_mem_region

The platform_map_mem_region is updated due to bm_env update
for both ZynqMP_r5 and Zynq

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

makefile.commons: added new flag OPENAMP_BAREMETAL for baremetal specific compilation

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

zynqMP_r5_lib: moved baremetal specific code to baremetal.c and baremetal.h

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

zc702_lib: baremetal specific code moved to baremetal.c file

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

zynqmp_r5: moved hw related definitions to platform.h from platform_info.c

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

bm_env.c: removed platform specific code from bm_env.c and added the OPENAMP_BAREMETAL flag

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

removed SWITCH_TO_SYS_MODE from rpc_demo.c

Signed-off-by: Kinjal Pravinbhai Patel <patelki@xilinx.com>

Update the kernel user modules copyright

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

Ack IPI once it reads IPI ISR

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

Add copyright to the kernel user modules examples

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

OpenAMP: Add Xilinx copyright

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

Update Linux modules, apps

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

update boot.S xil-crt0.S from Kinjal's

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

platform_info.c : zynqMP_r5: update RPU IPI intr for RTL5.2

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

update apps to use Kinjal's mpu modification

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

remoteproc: change to unix format

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

zynqMP_r5 baremetal libs: merge Kinjal's standalone libs

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

ipi: change to use centralized IPI API

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

rpmsg:rpmsg_core.c: get avail buf until there is no buf found

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

Enable rpmsg_retarget send function to send msg to the proxy channel

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

remove unused r5_example

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

rpmsg_retarget: removing including "sleep.h"

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

Add Linux master user rpmsg driver and user apps

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

enable matrix_multiply application

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

baremetal proxy app:use env spin lock

after correcting the env spin lock, switch back to use
the env spin lock function.

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

bm_env: correct the xchg function

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

apps Mafilefile: build rpc_demo

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

rpc_demo: use the default linker script in the baremetal

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

rpc_demo: port rpc_demo baremetal for r5

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

zc702evk:apply weak to file operations

apply weak attributes to file operations

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

baremetal: apply weak attributes to file operations

Apply weak attributes to file operations such as
_read(), _write(), _open(), _close() and so on.

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

echo_test: make it for baremetal r5

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

Update isr to clear IPI register after deinit

Will need to clear IPI registers after remoteproc/rpmsg
resource deinitialization.

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

rpmsg:move vring notification before rdev_notify

previously, vring notification is done just after creating
virtqueues, but before setting up the endpoint. That is
IPI interrupt is enabled before it can be handled.
This commit is to fix this.

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

rpmsg_core.c:change to unix line ending

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

r5_example: use wfi instead of nop in while loop.

use wfi instruction in the while loop to wait for interrupt.

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

baremetal remote: add nop in the while loop.

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

r5_example:change to only specify default openamp root if it is not defined

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

zynqMP_r5: baremetal: clean the standalone lib when doing clean

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

rpmsg_core: return unconditionally after the first kick.

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

mpu: init: make the DDR as non-cachable

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

echo_test.c: disable dcache for the program.

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

each platform define vatophy and phytova mapping.

Let each platform define its vatophy and phytova mapping.
the previous one in the bm_env.c is for PS Zynq only.

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

zynqMP_r5: flush dcache before kick/receive IPI

Will need to flush dcache to make sure data writes to memory
before kicking IPI or receive IPI.

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

r5_example: add test code.

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

resource table: leave only OCM for the firmware

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

libs:zynqMP_r5: baremetal:xil_standalone:mpu: add DDR to MPU init

Add DDR region to MPU initialization.
This should be done in user application. Need to fix later.

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

libs: zynqMP_r5: baremetal: Add IPI reg offsets information

Add IPI registers offsets information

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

porting: zynqMP_r5: use IPI for communication between APU and RPU

Use IPI for the communication between APU and RPU

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

rpmsg_core: use one openamp channel only.

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

libs: zynqMP_r5: baremetal: initialize int distributor

Need to initialize int distributor.

However, if two R5 are running in parallel mode.

May need a macro to define whether it is required to initialize
the GIC distributor.

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

rsc_table: put vrings to DDR, add TCM, OCM and DDR to carveout

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

libs: zynqMP_r5: baremetal: linker_remote: not hardcode vectors addr

Do not hardcoded vectors addr in the linker script.

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

porting: zynqMP_r5: platform_info: vrings in DDR, preserve IPI info

Put shared memory vrings in DDR, preserve structure for IPI information

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

libs: zynqMP_R5: baremetal: apply "weak" to file ops

Apply "weak" attribute to file operation functions.

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

OpenAMP lib Makefile: compile source for platform only

Compile source files for the specified platforms only.

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

Makefile for openamp lib: change file format to unix style

change the file line ending stype from dos to unix

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

linker_remote script: put the text section to 0xFFFF0000

boot from OCM, after reset, R5 will boot from 0xffff000.
and thus, i put the whole text section there.

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

Move shared memory and vring infos memory to DDR.

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

Add interrupts intialization to the example application.

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

libs: zynqMP_r5: baremetal: Add GIC intialization function to .h

Before using interrupts, we will need to initialize GIC.
Add the function to baremetal.h file.

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

modify r5_example Makefile to use r5 baremetal linker script.

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

linker_remote.ld: increase heap size to 16KBytes

each virtqueue requires 4200 Bytes, will need to enlarge heaps from
original 0x2000 to bigger.

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

linker_remote.ld: remove "end" definition

With the latest cortex_r5 toolchain, there is no need to
define "end" in the linker script.

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

xil_standalone_lib: _sbrk.c: fix issues with sbrk function

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

Add R5 remote baremetal starting point example

This applicaiton is for developing and debugging only.
It is not a complete OpenAMP remote baremetal application.
And it will be delete in the end.

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

In progress: R5 remote baremetal support

It passed compilation, however, the following questions remain:

* Interrupts implementation not tested
* memory mapping not final
   * ATF will occupy OCM
   * Should also allow run the code in TCM
   * Code may need to run in DDR if it is large
   * shared memory needs to be in DDR
* file operation syscalls cannot be redefined in application
   * looks like they have strong definition in newlib
   * as workaround, I apply "weak" attribute to those functions
     for non-proxy OpenAMP application.
     * _fstat(), _isatty(), _lseek(), _open(), _close(), _read() and write()
       in baremetal.c have "weak" attribute for non proxy application.

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

porting: env: remove zynq specific function

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

remoteproc: initialize status value in handle_rsc_table

to avoid gcc compilation warning. Initialize variable status
of function handle_rsc_table(). variable status is used to
store return value.

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

remoteproc: initialize status of remoteproc_loader_delete

To avoid GCC warnings, initialize variable status as 0 in
function remoteproc_loader_delete().
The status variable is used for return.

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

Makefile.commons: introduce platform specific include file

Remove the platform related settings from <OPENAMP>/Makefile.commons.
Add Makefile.commons.<platform> for platform specific settings.

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

Adding libfdt and zlib sources.

apps: samples: master: linux: kernelspace: 3.17 kernel zynq remoteproc

Update zyne remoteproc kernel driver to match 3.17 kernel

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

porting: zc702evk: platform_info: update vrings IPI

Kernel 3.17 preserve software interrupt 0 to 7 on Zynq.
For IPI, we will need to use 8 to 15.

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

zc702evk linux remote:Add prebuilt libfdt and zlib back

Add libfdt and zlib prebuilt back

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

open_amp_build.h: rebuild baremetal lib when builds OpenAMP apps

Rebuild baremetal lib for zc702evk when runs open_amp_build.sh

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

proxy: linux: userspace: proxy_app.c: wait after terminate

Before release remoteproc after sending terminating message, it needs
to wait for some time for remote do finish termination to release resource.

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

Delete *.a files

*.a files are generated by build, don't need to version control them

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

libs: zc702evk: baremetal: corret LIB macro in makefile

Corret the library macro of clean target in makefile to
actually remove the generated library.

Add a .build/ directory to keep all the object files.

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

libs: system: zc702evk: baremetal: Makefile line ending style

Change libs/system/zc702evk/baremetal/Makefile line ending style
to unix style.

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

.gitignore: Add *.a into .gitigore file

*.a are files generated during build, don't need to version control them.

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

gitignore: Ignore temporary build files

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

Adding updated documents.

Removing left over Nucleus references.

Removing Nucleus references from OpenAMP repo. Documentation changes are pending