tests: drivers: Add API test for retained_mem

Adds a test for the retained memory driver interface using GPREGRET
and RAM backends for the nrf52840dk_nrf52840 board and RAM backend
for qemu_cortex_m3 board.

Signed-off-by: Jamie McCrae <jamie.mccrae@nordicsemi.no>