/** * @file furi_hal_version.h * Version HAL API */ #pragma once #include #include #include #include #ifdef __cplusplus extern "C" { #endif #define FURI_HAL_VERSION_NAME_LENGTH 8 #define FURI_HAL_VERSION_ARRAY_NAME_LENGTH (FURI_HAL_VERSION_NAME_LENGTH + 1) /** BLE symbol + "Flipper " + name */ #define FURI_HAL_VERSION_DEVICE_NAME_LENGTH (1 + 8 + FURI_HAL_VERSION_ARRAY_NAME_LENGTH) // 18 characters + null terminator #define FURI_HAL_BT_ADV_NAME_LENGTH (FURI_HAL_VERSION_DEVICE_NAME_LENGTH + 1) /** OTP Versions enum */ typedef enum { FuriHalVersionOtpVersion0 = 0x00, FuriHalVersionOtpVersion1 = 0x01, FuriHalVersionOtpVersion2 = 0x02, FuriHalVersionOtpVersionEmpty = 0xFFFFFFFE, FuriHalVersionOtpVersionUnknown = 0xFFFFFFFF, } FuriHalVersionOtpVersion; /** Device Colors */ typedef enum { FuriHalVersionColorUnknown = 0x00, FuriHalVersionColorBlack = 0x01, FuriHalVersionColorWhite = 0x02, } FuriHalVersionColor; /** Device Regions */ typedef enum { FuriHalVersionRegionUnknown = 0x00, FuriHalVersionRegionEuRu = 0x01, FuriHalVersionRegionUsCaAu = 0x02, FuriHalVersionRegionJp = 0x03, FuriHalVersionRegionWorld = 0x04, } FuriHalVersionRegion; /** Device Display */ typedef enum { FuriHalVersionDisplayUnknown = 0x00, FuriHalVersionDisplayErc = 0x01, FuriHalVersionDisplayMgg = 0x02, } FuriHalVersionDisplay; /** Init flipper version */ void furi_hal_version_init(); /** Check target firmware version * * @return true if target and real matches */ bool furi_hal_version_do_i_belong_here(); /** Get model name * * @return model name C-string */ const char* furi_hal_version_get_model_name(); /** Get model name * * @return model code C-string */ const char* furi_hal_version_get_model_code(); /** Get FCC ID * * @return FCC id as C-string */ const char* furi_hal_version_get_fcc_id(); /** Get IC id * * @return IC id as C-string */ const char* furi_hal_version_get_ic_id(); /** Get OTP version * * @return OTP Version */ FuriHalVersionOtpVersion furi_hal_version_get_otp_version(); /** Get hardware version * * @return Hardware Version */ uint8_t furi_hal_version_get_hw_version(); /** Get hardware target * * @return Hardware Target */ uint8_t furi_hal_version_get_hw_target(); /** Get hardware body * * @return Hardware Body */ uint8_t furi_hal_version_get_hw_body(); /** Get hardware body color * * @return Hardware Color */ FuriHalVersionColor furi_hal_version_get_hw_color(); /** Get hardware connect * * @return Hardware Interconnect */ uint8_t furi_hal_version_get_hw_connect(); /** Get hardware region (fake) = 0 * * @return Hardware Region (fake) */ FuriHalVersionRegion furi_hal_version_get_hw_region(); /** Get hardware region name (fake) = R00 * * @return Hardware Region name (fake) */ const char* furi_hal_version_get_hw_region_name(); /** Get hardware region (OTP) * * @return Hardware Region */ FuriHalVersionRegion furi_hal_version_get_hw_region_otp(); /** Get hardware region name (OTP) * * @return Hardware Region name */ const char* furi_hal_version_get_hw_region_name_otp(); /** Get hardware display id * * @return Display id */ FuriHalVersionDisplay furi_hal_version_get_hw_display(); /** Get hardware timestamp * * @return Hardware Manufacture timestamp */ uint32_t furi_hal_version_get_hw_timestamp(); /** Get pointer to target name * * @return Hardware Name C-string */ const char* furi_hal_version_get_name_ptr(); /** Get pointer to target device name * * @return Hardware Device Name C-string */ const char* furi_hal_version_get_device_name_ptr(); /** Get pointer to target ble local device name * * @return Ble Device Name C-string */ const char* furi_hal_version_get_ble_local_device_name_ptr(); /** Set flipper name */ void furi_hal_version_set_name(const char* name); /** Get BLE MAC address * * @return pointer to BLE MAC address */ const uint8_t* furi_hal_version_get_ble_mac(); /** Get address of version structure of firmware. * * @return Address of firmware version structure. */ const struct Version* furi_hal_version_get_firmware_version(); /** Get platform UID size in bytes * * @return UID size in bytes */ size_t furi_hal_version_uid_size(); /** Get const pointer to UID * * @return pointer to UID */ const uint8_t* furi_hal_version_uid(); const uint8_t* furi_hal_version_uid_default(); #ifdef __cplusplus } #endif