protobuf: add reboot purpose

The user will be able to reboot into the bootloader for multiple
reasons:

- Upgrade device (default, backwards compatible)
- Going to the startup settings, to change e.g. the setting to display
  the firmware hash at boot

Author: benma

messages/system.proto

@@ -16,5 +16,9 @@ syntax = "proto3";
 package shiftcrypto.bitbox02;
 
 message RebootRequest {
-
+  enum Purpose {
+    UPGRADE = 0;
+    SETTINGS = 1;
+  }
+  Purpose purpose = 1;
 }

py/bitbox02/bitbox02/bitbox02/__init__.py

@@ -54,5 +54,6 @@
     btc,
     common,
     eth,
+    system,
 )
 from .bootloader import Bootloader

py/bitbox02/bitbox02/bitbox02/bitbox02.py

@@ -44,6 +44,10 @@
     from bitbox02.communication.generated import common_pb2 as common
     from bitbox02.communication.generated import keystore_pb2 as keystore
     from bitbox02.communication.generated import antiklepto_pb2 as antiklepto
+
+    # pylint: disable=unused-import
+    # We export it in __init__.py
+    from bitbox02.communication.generated import system_pb2 as system
 except ModuleNotFoundError:
     print("Run `make py` to generate the protobuf messages")
     sys.exit()

py/bitbox02/bitbox02/communication/generated/system_pb2.py

@@ -1,15 +1,54 @@
 # @generated by generate_proto_mypy_stubs.py.  Do not edit!
 import sys
+from google.protobuf.descriptor import (
+    EnumDescriptor as google___protobuf___descriptor___EnumDescriptor,
+)
+
 from google.protobuf.message import (
     Message as google___protobuf___message___Message,
 )
 
+from typing import (
+    List as typing___List,
+    Optional as typing___Optional,
+    Tuple as typing___Tuple,
+    cast as typing___cast,
+)
+
+from typing_extensions import (
+    Literal as typing_extensions___Literal,
+)
+
 
 class RebootRequest(google___protobuf___message___Message):
+    class Purpose(int):
+        DESCRIPTOR: google___protobuf___descriptor___EnumDescriptor = ...
+        @classmethod
+        def Name(cls, number: int) -> str: ...
+        @classmethod
+        def Value(cls, name: str) -> RebootRequest.Purpose: ...
+        @classmethod
+        def keys(cls) -> typing___List[str]: ...
+        @classmethod
+        def values(cls) -> typing___List[RebootRequest.Purpose]: ...
+        @classmethod
+        def items(cls) -> typing___List[typing___Tuple[str, RebootRequest.Purpose]]: ...
+        UPGRADE = typing___cast(RebootRequest.Purpose, 0)
+        SETTINGS = typing___cast(RebootRequest.Purpose, 1)
+    UPGRADE = typing___cast(RebootRequest.Purpose, 0)
+    SETTINGS = typing___cast(RebootRequest.Purpose, 1)
+
+    purpose = ... # type: RebootRequest.Purpose
 
     def __init__(self,
+        *,
+        purpose : typing___Optional[RebootRequest.Purpose] = None,
         ) -> None: ...
     @classmethod
     def FromString(cls, s: bytes) -> RebootRequest: ...
     def MergeFrom(self, other_msg: google___protobuf___message___Message) -> None: ...
     def CopyFrom(self, other_msg: google___protobuf___message___Message) -> None: ...
+    if sys.version_info >= (3,):
+        def ClearField(self, field_name: typing_extensions___Literal[u"purpose"]) -> None: ...
+    else:
+        def ClearField(self, field_name: typing_extensions___Literal[u"purpose",b"purpose"]) -> None: ...

py/bitbox02/bitbox02/communication/generated/system_pb2.pyi

@@ -744,6 +744,17 @@ pub struct RandomNumberRequest {
 }
 #[derive(Clone, PartialEq, ::prost::Message)]
 pub struct RebootRequest {
+    #[prost(enumeration="reboot_request::Purpose", tag="1")]
+    pub purpose: i32,
+}
+/// Nested message and enum types in `RebootRequest`.
+pub mod reboot_request {
+    #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
+    #[repr(i32)]
+    pub enum Purpose {
+        Upgrade = 0,
+        Settings = 1,
+    }
 }
 /// Deprecated, last used in v1.0.0
 #[derive(Clone, PartialEq, ::prost::Message)]