samples: drivers: mbox: misc cleanups/enhancements

- Include cleanup
- s/NET/REMOTE (remote core may have nothing to do with NET)
- Improved error reporting

Signed-off-by: Gerard Marull-Paretas <gerard@teslabs.com>