mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2024-11-23 13:03:13 +00:00
116 lines
2.9 KiB
C
116 lines
2.9 KiB
C
#pragma once
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct Version Version;
|
|
|
|
/** Get current running firmware version handle.
|
|
*
|
|
* You can store it somewhere. But if you want to retrieve data, you have to use
|
|
* 'version_*_get()' set of functions. Also, 'version_*_get()' imply to use this
|
|
* handle if no handle (NULL_PTR) provided.
|
|
*
|
|
* @return pointer to Version data.
|
|
*/
|
|
const Version* version_get(void);
|
|
|
|
/** Get git commit hash.
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return git hash
|
|
*/
|
|
const char* version_get_githash(const Version* v);
|
|
|
|
/** Get git branch.
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return git branch
|
|
*/
|
|
const char* version_get_gitbranch(const Version* v);
|
|
|
|
/** Get number of commit in git branch.
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return number of commit
|
|
*/
|
|
const char* version_get_gitbranchnum(const Version* v);
|
|
|
|
/** Get build date.
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return build date
|
|
*/
|
|
const char* version_get_builddate(const Version* v);
|
|
|
|
/** Get build version. Build version is last tag in git history.
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return build date
|
|
*/
|
|
const char* version_get_version(const Version* v);
|
|
|
|
/** Get custom flipper name if set in version_set_custom_name
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return custom name or NULL
|
|
*/
|
|
const char* version_get_custom_name(const Version* v);
|
|
|
|
/** Set custom flipper name
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
* @param name Custom name or NULL
|
|
*/
|
|
void version_set_custom_name(Version* v, const char* name);
|
|
|
|
/** Get hardware target this firmware was built for
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return build date
|
|
*/
|
|
uint8_t version_get_target(const Version* v);
|
|
|
|
/** Get flag indicating if this build is "dirty" (source code had uncommited changes)
|
|
*
|
|
* @param v pointer to Version data. NULL for currently running
|
|
* software.
|
|
*
|
|
* @return build date
|
|
*/
|
|
bool version_get_dirty_flag(const Version* v);
|
|
|
|
/**
|
|
* Get firmware origin. "Official" for mainline firmware, fork name for forks.
|
|
* Set by FIRMWARE_ORIGIN fbt argument.
|
|
*/
|
|
const char* version_get_firmware_origin(const Version* v);
|
|
|
|
/**
|
|
* Get git repo origin
|
|
*/
|
|
const char* version_get_git_origin(const Version* v);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|