Import of the watch repository from Pebble

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

@@ -0,0 +1,71 @@
+/*
+ * 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 "drivers/pwr.h"
+#include "system/bootbits.h"
+#include "system/rtc_registers.h"
+
+#include "git_version.auto.h"
+
+#include "stm32f7xx.h"
+
+#include <inttypes.h>
+#include <stdint.h>
+
+static const uint32_t s_bootloader_timestamp = GIT_TIMESTAMP;
+
+void boot_bit_init(void) {
+  pwr_access_backup_domain(true);
+
+  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/robert/boot/src/system/bootbits.h

@@ -0,0 +1,54 @@
+/*
+ * 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, //!< Bootloader enter standby immediately after reset.
+  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,
+  BOOT_BIT_SHUTDOWN_REQUESTED = 0x1 << 19, //!< Bootloader hard power-off instead of jumping to fw.
+} 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/robert/boot/src/system/die.c

@@ -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.
+ */
+
+#include "die.h"
+#include "drivers/dbgserial.h"
+#include "system/reset.h"
+#include "system/passert.h"
+
+NORETURN reset_due_to_software_failure(void) {
+#if defined(NO_WATCHDOG)
+  // Don't reset right away, leave it in a state we can inspect
+
+  while (1) {
+    BREAKPOINT;
+  }
+#endif
+
+  dbgserial_putstr("Software failure; resetting!");
+  system_reset();
+}

platform/robert/boot/src/system/die.h

@@ -0,0 +1,23 @@
+/*
+ * 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 "util/attributes.h"
+
+//! Does not call reboot_reason_set, only calls reboot_reason_set_restarted_safely if we were
+//! able shut everything down nicely before rebooting.
+NORETURN reset_due_to_software_failure(void);

platform/robert/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/robert/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/robert/boot/src/system/logging.h

@@ -0,0 +1,64 @@
+/*
+ * 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 "drivers/dbgserial.h"
+
+#include <stdarg.h>
+#include <stdlib.h>
+#include <stdint.h>
+#include <string.h>
+#include <stdbool.h>
+
+#ifndef __FILE_NAME__
+#define __FILE_NAME__ __FILE__
+#endif
+
+#define LOG_LEVEL_ALWAYS 0
+#define LOG_LEVEL_ERROR 1
+#define LOG_LEVEL_WARNING 50
+#define LOG_LEVEL_INFO 100
+#define LOG_LEVEL_DEBUG 200
+#define LOG_LEVEL_DEBUG_VERBOSE 255
+
+#ifndef STRINGIFY
+  #define STRINGIFY_NX(a) #a
+  #define STRINGIFY(a) STRINGIFY_NX(a)
+#endif // STRINGIFY
+
+#define STATUS_STRING(s) STRINGIFY(s)
+
+#ifdef PBL_LOG_ENABLED
+  #define PBL_LOG(level, fmt, args...) \
+    do { \
+      char _pbl_log_buffer[128]; \
+      dbgserial_putstr(__FILE_NAME__ ":" STRINGIFY(__LINE__) "> " fmt); \
+    } while (0)
+
+  #ifdef VERBOSE_LOGGING
+
+    #define PBL_LOG_VERBOSE(fmt, args...)                               \
+      PBL_LOG(LOG_LEVEL_DEBUG, fmt, ## args)
+
+  #else // VERBOSE_LOGGING
+    #define PBL_LOG_VERBOSE(fmt, args...)
+  #endif // VERBOSE_LOGGING
+
+#else // PBL_LOG_ENABLED
+  #define PBL_LOG(level, fmt, args...)
+  #define PBL_LOG_VERBOSE(fmt, args...)
+#endif // PBL_LOG_ENABLED

platform/robert/boot/src/system/passert.c

@@ -0,0 +1,87 @@
+/*
+ * 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 "passert.h"
+
+#include "drivers/dbgserial.h"
+#include "system/die.h"
+#include "util/attributes.h"
+
+#include <string.h>
+#include <stdarg.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+
+static NORETURN prv_handle_passert_failed_vargs(const char* filename, int line_number,
+    uintptr_t lr, const char* expr, const char* fmt, va_list fmt_args) {
+  dbgserial_print("ASSERT: ");
+  dbgserial_print(expr);
+  dbgserial_print("  ");
+  dbgserial_print(filename);
+  dbgserial_print(":");
+  dbgserial_print_hex(line_number);
+  if (fmt) {
+    dbgserial_print(" ");
+    dbgserial_print(fmt);
+  }
+  dbgserial_putstr("");
+
+  reset_due_to_software_failure();
+}
+
+static NORETURN prv_handle_passert_failed(const char* filename, int line_number,
+    uintptr_t lr, const char *expr, const char* fmt, ...) {
+  va_list fmt_args;
+  va_start(fmt_args, fmt);
+
+  prv_handle_passert_failed_vargs(filename, line_number, lr, expr, fmt, fmt_args);
+
+  va_end(fmt_args);
+}
+
+void passert_failed(const char* filename, int line_number, const char* message, ...) {
+  va_list fmt_args;
+  va_start(fmt_args, message);
+
+  prv_handle_passert_failed_vargs(filename, line_number,
+    (uintptr_t)__builtin_return_address(0), "ASSERT", message, fmt_args);
+
+  va_end(fmt_args);
+}
+
+void passert_failed_no_message(const char* filename, int line_number) {
+  prv_handle_passert_failed(filename, line_number,
+    (uintptr_t)__builtin_return_address(0), "ASSERTN", NULL);
+}
+
+void wtf(void) {
+  uintptr_t saved_lr = (uintptr_t) __builtin_return_address(0);
+  dbgserial_print("*** WTF ");
+  dbgserial_print_hex(saved_lr);
+  dbgserial_putstr("");
+  reset_due_to_software_failure();
+}
+
+//! Assert function called by the STM peripheral library's
+//! 'assert_param' method. See stm32f2xx_conf.h for more information.
+void assert_failed(uint8_t* file, uint32_t line) {
+  register uintptr_t lr __asm("lr");
+  uintptr_t saved_lr = lr;
+
+  prv_handle_passert_failed((const char*) file, line, saved_lr, "STM32", "STM32 peripheral library "
+      "tripped an assert");
+}

platform/robert/boot/src/system/passert.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 "logging.h"
+
+
+void passert_failed(const char* filename, int line_number, const char* message, ...)
+    __attribute__((noreturn));
+
+#define PBL_ASSERT(expr, ...) \
+  do { \
+    if (!(expr)) { \
+      passert_failed(__FILE_NAME__, __LINE__, __VA_ARGS__); \
+    } \
+  } while (0)
+
+#define PBL_ASSERTN(expr) \
+  do { \
+    if (!(expr)) { \
+      passert_failed_no_message(__FILE_NAME__, __LINE__); \
+    } \
+  } while (0)
+
+void passert_failed_no_message(const char* filename, int line_number)
+    __attribute__((noreturn));
+
+void wtf(void) __attribute__((noreturn));
+
+#define WTF wtf()
+
+// Insert a compiled-in breakpoint
+#define BREAKPOINT __asm("bkpt")
+
+#define PBL_ASSERT_PRIVILEGED()
+#define PBL_ASSERT_TASK(task)
+
+#define PBL_CROAK(fmt, args...) \
+    passert_failed(__FILE_NAME__, __LINE__, "*** CROAK: " fmt, ## args)

platform/robert/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 "stm32f7xx.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/robert/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/robert/boot/src/system/rtc_registers.h

@@ -0,0 +1,31 @@
+/*
+ * 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 SLOT_OF_LAST_LAUNCHED_APP               RTC_BKP_DR19