Import of the watch repository from Pebble

platform/tintin/boot/src/system/bootbits.c

@@ -0,0 +1,68 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "drivers/dbgserial.h"
+#include "system/bootbits.h"
+#include "system/rtc_registers.h"
+
+#include "git_version.auto.h"
+
+#include "stm32f2xx.h"
+
+#include <inttypes.h>
+#include <stdint.h>
+
+static const uint32_t s_bootloader_timestamp = GIT_TIMESTAMP;
+
+void boot_bit_init(void) {
+  if (!boot_bit_test(BOOT_BIT_INITIALIZED)) {
+    RTC_WriteBackupRegister(RTC_BKP_BOOTBIT_DR, BOOT_BIT_INITIALIZED);
+  }
+}
+
+void boot_bit_set(BootBitValue bit) {
+  uint32_t current_value = RTC_ReadBackupRegister(RTC_BKP_BOOTBIT_DR);
+  current_value |= bit;
+  RTC_WriteBackupRegister(RTC_BKP_BOOTBIT_DR, current_value);
+}
+
+void boot_bit_clear(BootBitValue bit) {
+  uint32_t current_value = RTC_ReadBackupRegister(RTC_BKP_BOOTBIT_DR);
+  current_value &= ~bit;
+  RTC_WriteBackupRegister(RTC_BKP_BOOTBIT_DR, current_value);
+}
+
+bool boot_bit_test(BootBitValue bit) {
+  uint32_t current_value = RTC_ReadBackupRegister(RTC_BKP_BOOTBIT_DR);
+  return (current_value & bit);
+}
+
+void boot_bit_dump(void) {
+  dbgserial_print("Boot bits: ");
+  dbgserial_print_hex(RTC_ReadBackupRegister(RTC_BKP_BOOTBIT_DR));
+  dbgserial_newline();
+}
+
+void boot_version_write(void) {
+  if (boot_version_read() == s_bootloader_timestamp) {
+    return;
+  }
+  RTC_WriteBackupRegister(BOOTLOADER_VERSION_REGISTER, s_bootloader_timestamp);
+}
+
+uint32_t boot_version_read(void) {
+  return RTC_ReadBackupRegister(BOOTLOADER_VERSION_REGISTER);
+}

platform/tintin/boot/src/system/bootbits.h

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <stdint.h>
+#include <stdbool.h>
+
+typedef enum BootBitValue {
+  BOOT_BIT_INITIALIZED = 0x1 << 0,
+  BOOT_BIT_NEW_FW_AVAILABLE = 0x1 << 1,
+  BOOT_BIT_NEW_FW_UPDATE_IN_PROGRESS = 0x1 << 2,
+  BOOT_BIT_FW_START_FAIL_STRIKE_ONE = 0x1 << 3,
+  BOOT_BIT_FW_START_FAIL_STRIKE_TWO = 0x1 << 4,
+  BOOT_BIT_RECOVERY_LOAD_FAIL_STRIKE_ONE = 0x1 << 5,
+  BOOT_BIT_RECOVERY_LOAD_FAIL_STRIKE_TWO = 0x1 << 6,
+  BOOT_BIT_RECOVERY_START_IN_PROGRESS = 0x1 << 7,
+  BOOT_BIT_STANDBY_MODE_REQUESTED = 0x1 << 8,
+  BOOT_BIT_SOFTWARE_FAILURE_OCCURRED = 0x1 << 9,
+  BOOT_BIT_NEW_SYSTEM_RESOURCES_AVAILABLE = 0x1 << 10,
+  BOOT_BIT_RESET_LOOP_DETECT_ONE = 0x1 << 11,
+  BOOT_BIT_RESET_LOOP_DETECT_TWO = 0x1 << 12,
+  BOOT_BIT_RESET_LOOP_DETECT_THREE = 0x1 << 13,
+  BOOT_BIT_FW_STABLE = 0x1 << 14,
+  BOOT_BIT_NEW_FW_INSTALLED = 0x1 << 15,
+  BOOT_BIT_STANDBY_MODE_ENTERED = 0x1 << 16,
+  BOOT_BIT_FORCE_PRF = 0x1 << 17,
+  BOOT_BIT_NEW_PRF_AVAILABLE = 0x1 << 18
+} BootBitValue;
+
+void boot_bit_init();
+void boot_bit_set(BootBitValue bit);
+void boot_bit_clear(BootBitValue bit);
+bool boot_bit_test(BootBitValue bit);
+
+// Dump the contents through dbgserial
+void boot_bit_dump(void);
+
+void boot_version_write(void);
+uint32_t boot_version_read(void);

platform/tintin/boot/src/system/firmware_storage.c

@@ -0,0 +1,30 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "firmware_storage.h"
+
+#include "drivers/flash.h"
+
+FirmwareDescription firmware_storage_read_firmware_description(uint32_t firmware_start_address) {
+  FirmwareDescription firmware_description;
+  flash_read_bytes((uint8_t*)&firmware_description, firmware_start_address,
+                   sizeof(FirmwareDescription));
+  return firmware_description;
+}
+
+bool firmware_storage_check_valid_firmware_description(FirmwareDescription* desc) {
+  return desc->description_length == sizeof(FirmwareDescription);
+}

platform/tintin/boot/src/system/firmware_storage.h

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+//! @file firmware_storage.h
+//! Utilities for reading a firmware image stored in flash.
+
+#include <stdbool.h>
+#include <stdint.h>
+
+typedef struct __attribute__((__packed__)) FirmwareDescription {
+  uint32_t description_length;
+  uint32_t firmware_length;
+  uint32_t checksum;
+} FirmwareDescription;
+
+FirmwareDescription firmware_storage_read_firmware_description(uint32_t firmware_start_address);
+
+bool firmware_storage_check_valid_firmware_description(FirmwareDescription* desc);

platform/tintin/boot/src/system/reset.c

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "system/reset.h"
+
+#include "drivers/display.h"
+
+#include "stm32f2xx.h"
+
+void system_reset(void) {
+  display_prepare_for_reset();
+
+  // Clear the reset reason since it will no longer
+  // apply after this bootloader reset
+  RCC_ClearFlag();
+
+  system_hard_reset();
+}
+
+void system_hard_reset(void) {
+  NVIC_SystemReset();
+  __builtin_unreachable();
+}

platform/tintin/boot/src/system/reset.h

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <stdbool.h>
+
+//! Reset nicely after shutting down system services. Does not set the reboot_reason other than
+//! calling reboot_reason_set_restarted_safely just before the reset occurs.
+void system_reset(void)__attribute__((noreturn));
+
+//! The final stage in the reset process.
+void system_hard_reset(void) __attribute__((noreturn));

platform/tintin/boot/src/system/rtc_registers.h

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#define RTC_BKP_BOOTBIT_DR                      RTC_BKP_DR0
+#define STUCK_BUTTON_REGISTER                   RTC_BKP_DR1
+#define BOOTLOADER_VERSION_REGISTER             RTC_BKP_DR2
+#define CURRENT_TIME_REGISTER                   RTC_BKP_DR3
+#define CURRENT_INTERVAL_TICKS_REGISTER         RTC_BKP_DR4
+#define REBOOT_REASON_REGISTER_1                RTC_BKP_DR5
+#define REBOOT_REASON_REGISTER_2                RTC_BKP_DR6
+#define REBOOT_REASON_STUCK_TASK_PC             RTC_BKP_DR7
+#define REBOOT_REASON_STUCK_TASK_LR             RTC_BKP_DR8
+#define REBOOT_REASON_STUCK_TASK_CALLBACK       RTC_BKP_DR9
+#define REBOOT_REASON_MUTEX_LR                  RTC_BKP_DR10 // Now REBOOT_REASON_DROPPED_EVENT
+#define REBOOT_REASON_MUTEX_PC                  RTC_BKP_DR11 // Deprecated
+#define MAG_XY_CORRECTION_VALS                  RTC_BKP_DR17
+#define MAG_Z_CORRECTION_VAL                    RTC_BKP_DR18
+#define SLOT_OF_LAST_LAUNCHED_APP               RTC_BKP_DR19