tests: mcuboot: add boot_request_upgrade() return value check

- Adds boot_request_upgrade() return value check.
- Avoid repeating resets if the upgrade request fails.

Signed-off-by: Andrej Butok <andrey.butok@nxp.com>