X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=payloads%2Flibpayload%2Finclude%2Flibpayload.h;h=53d6672a19a3269e608c117d1f5e3e313a3e9551;hb=0a5951110812ad83abc6a61db992050a39209b8d;hp=84518563d60bf2dee87fe35c8a697f9385de06b0;hpb=f6145c3c15789123f6b4a9ce64a517048e753762;p=coreboot.git diff --git a/payloads/libpayload/include/libpayload.h b/payloads/libpayload/include/libpayload.h index 84518563d..53d6672a1 100644 --- a/payloads/libpayload/include/libpayload.h +++ b/payloads/libpayload/include/libpayload.h @@ -27,73 +27,382 @@ * SUCH DAMAGE. */ -#ifndef LIBPAYLOAD_H_ -#define LIBPAYLOAD_H_ +/** + * @mainpage + * + * @section intro Introduction + * libpayload is a small BSD-licensed static library (a lightweight + * implementation of common and useful functions) intended to be used + * as a basis for coreboot payloads. + * + * @section example Example + * Here is an example of a very simple payload: + * @include sample/hello.c + */ -#include +#ifndef _LIBPAYLOAD_H +#define _LIBPAYLOAD_H + +#include +#include #include +#include +#include +#include +#include #include #include -#include +#include +#include +#include +#ifdef CONFIG_LAR +#include +#endif #define MIN(a,b) ((a) < (b) ? (a) : (b)) #define MAX(a,b) ((a) > (b) ? (a) : (b)) #define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0])) -/* serial.c */ -void serial_putchar(unsigned char c); +#define LITTLE_ENDIAN 1234 +#define BIG_ENDIAN 4321 + +#define EXIT_SUCCESS 0 +#define EXIT_FAILURE 1 + +#define RAND_MAX 0x7fffffff + +#define MAX_ARGC_COUNT 10 + +/* + * Payload information parameters - these are used to pass information + * to the entity loading the payload. + * Usage: PAYLOAD_INFO(key, value) + * Example: PAYLOAD_INFO(name, "CoreInfo!") + */ +#define _pstruct(key) __pinfo_ ##key +#define PAYLOAD_INFO(key, value) \ +static const char _pstruct(key)[] \ + __attribute__((__used__)) \ + __attribute__((section(".note.pinfo"),unused)) = #key "=" value + +/** + * @defgroup nvram NVRAM and RTC functions + * @{ + */ + +#define NVRAM_RTC_SECONDS 0 /**< RTC Seconds offset in CMOS */ +#define NVRAM_RTC_MINUTES 2 /**< RTC Minutes offset in CMOS */ +#define NVRAM_RTC_HOURS 4 /**< RTC Hours offset in CMOS */ +#define NVRAM_RTC_DAY 7 /**< RTC Days offset in CMOS */ +#define NVRAM_RTC_MONTH 8 /**< RTC Month offset in CMOS */ +#define NVRAM_RTC_YEAR 9 /**< RTC Year offset in CMOS */ +#define NVRAM_RTC_FREQ_SELECT 10 /**< RTC Update Status Register */ +#define NVRAM_RTC_UIP 0x80 + +/** Broken down time structure */ +struct tm { + int tm_sec; /**< Number of seconds after the minute */ + int tm_min; /**< Number of minutes after the hour */ + int tm_hour; /**< Number of hours past midnight */ + int tm_mday; /**< The day of the month */ + int tm_mon; /**< The month of the year */ + int tm_year; /**< The number of years since 1900 */ + int tm_wday; /**< The day of the week */ + int tm_yday; /**< The number of days since January 1 */ + int tm_isdst; /**< A flag indicating daylight savings time */ +}; + +u8 nvram_read(u8 addr); +void nvram_write(u8 val, u8 addr); +int nvram_updating(void); +void rtc_read_clock(struct tm *tm); +/** @} */ + +/** + * @defgroup usb USB functions + * @{ + */ +int usb_initialize(void); +int usb_exit (void); +int usbhid_havechar(void); +int usbhid_getchar(void); +/** @} */ + +/** + * @defgroup input Device functions + * @{ @} + */ + +extern void (*reset_handler)(void); +int add_reset_handler(void (*new_handler)(void)); + +/** + * @defgroup keyboard Keyboard functions + * @ingroup input + * @{ + */ +void keyboard_init(void); +int keyboard_havechar(void); +unsigned char keyboard_get_scancode(void); +int keyboard_getchar(void); +int keyboard_set_layout(char *country); +/** @} */ + +/** + * @defgroup serial Serial functions + * @ingroup input + * @{ + */ +void serial_init(void); +void serial_putchar(unsigned int c); +int serial_havechar(void); +int serial_getchar(void); +void serial_clear(void); +void serial_start_bold(void); +void serial_end_bold(void); +void serial_start_reverse(void); +void serial_end_reverse(void); +void serial_start_altcharset(void); +void serial_end_altcharset(void); +void serial_set_color(short fg, short bg); +void serial_cursor_enable(int state); +void serial_set_cursor(int y, int x); +/** @} */ + +/** + * @defgroup speaker Speaker functions + * @ingroup input + * @{ + */ +void speaker_enable(u16 freq); +void speaker_disable(void); +void speaker_tone(u16 freq, unsigned int duration); +/** @} */ + +/** + * @defgroup video Video functions + * @ingroup input + * @{ + */ +int video_console_init(void); +void video_console_putchar(unsigned int ch); +void video_console_putc(u8 row, u8 col, unsigned int ch); +void video_console_clear(void); +void video_console_cursor_enable(int state); +void video_console_get_cursor(unsigned int *x, unsigned int *y, unsigned int *en); +void video_console_set_cursor(unsigned int cursorx, unsigned int cursory); +/** @} */ + +/* drivers/option.c */ +struct nvram_accessor { + u8 (*read)(u8 reg); + void (*write)(u8 val, u8 reg); +}; + +extern u8 *mem_accessor_base; +extern struct nvram_accessor *use_nvram, *use_mem; + +struct cb_cmos_option_table *get_system_option_table(void); +int options_checksum_valid(const struct nvram_accessor *nvram); +void fix_options_checksum_with(const struct nvram_accessor *nvram); +void fix_options_checksum(void); +struct cb_cmos_entries *first_cmos_entry(struct cb_cmos_option_table *option_table); +struct cb_cmos_entries *next_cmos_entry(struct cb_cmos_entries *cur); +int get_option_with(const struct nvram_accessor *nvram, struct cb_cmos_option_table *option_table, void *dest, char *name); +int get_option_from(struct cb_cmos_option_table *option_table, void *dest, char *name); +int get_option(void *dest, char *name); +int set_option_with(const struct nvram_accessor *nvram, struct cb_cmos_option_table *option_table, void *value, char *name); +int set_option(void *value, char *name); +int get_option_as_string(const struct nvram_accessor *nvram, struct cb_cmos_option_table *option_table, char **dest, char *name); +int set_option_from_string(const struct nvram_accessor *nvram, struct cb_cmos_option_table *option_table, char *value, char *name); + +/** + * @defgroup console Console functions + * @{ + */ +void console_init(void); +int putchar(unsigned int c); +int puts(const char *s); +int havekey(void); +int getchar(void); +int getchar_timeout(int *ms); -/* console.c */ -int putchar(int c); extern int last_putchar; +struct console_input_driver; +struct console_input_driver { + struct console_input_driver *next; + int (*havekey) (void); + int (*getchar) (void); +}; + +struct console_output_driver; +struct console_output_driver { + struct console_output_driver *next; + void (*putchar) (unsigned int); +}; + +void console_add_output_driver(struct console_output_driver *out); +void console_add_input_driver(struct console_input_driver *in); + #define havechar havekey +/** @} */ + +/** + * @defgroup ipchecksum IP checksum functions + * @{ + */ +unsigned short ipchksum(const void *ptr, unsigned long nbytes); +/** @} */ + + +/** + * @defgroup exec Execution functions + * @{ + */ +int exec(long addr, int argc, char **argv); +/** @} */ + +/** + * @defgroup misc Misc functions + * @{ + */ +int bcd2dec(int b); +int dec2bcd(int d); +int abs(int j); +long int labs(long int j); +long long int llabs(long long int j); +u8 bin2hex(u8 b); +u8 hex2bin(u8 h); +void fatal(const char *msg) __attribute__ ((noreturn)); +/** @} */ + + +/** + * @defgroup hash Hashing functions + * @{ + */ +#define SHA1_BLOCK_LENGTH 64 +#define SHA1_DIGEST_LENGTH 20 +typedef struct { + u32 state[5]; + u64 count; + u8 buffer[SHA1_BLOCK_LENGTH]; +} SHA1_CTX; +void SHA1Init(SHA1_CTX *context); +void SHA1Transform(u32 state[5], const u8 buffer[SHA1_BLOCK_LENGTH]); +void SHA1Update(SHA1_CTX *context, const u8 *data, size_t len); +void SHA1Pad(SHA1_CTX *context); +void SHA1Final(u8 digest[SHA1_DIGEST_LENGTH], SHA1_CTX *context); +u8 *sha1(const u8 *data, size_t len, u8 *buf); +/** @} */ + +/** + * @defgroup time Time functions + * @{ + */ + +/** System time structure */ +struct timeval { + time_t tv_sec; /**< Seconds */ + suseconds_t tv_usec; /**< Microseconds */ +}; + +int gettimeofday(struct timeval *tv, void *tz); +/** @} */ -/* ctype.c */ -int isspace(int c); -int isdigit(int c); -int tolower(int c); - -/* malloc.c */ -void *malloc(size_t size); -void free(void *ptr); -void *calloc(size_t nmemb, size_t size); -void *realloc(void *ptr, size_t size); - -/* memory.c */ -int memcmp(const char *s1, const char *s2, size_t len); -void *memcpy(void *dst, const void *src, size_t n); -void *memset(void *s, int c, size_t n); -void *memmove(void *dst, const void *src, size_t n); - -/* printf.c */ -int sprintf(char *str, const char *fmt, ...); -int vsnprintf(char *str, size_t size, const char *fmt, va_list ap); -int vsprintf(char *str, const char *fmt, va_list ap); -int printf(const char *fmt, ...); -int vprintf(const char *fmt, va_list ap); - -/* string.c */ -size_t strnlen(const char *src, size_t max); -size_t strlen(const char *src); -int strcmp(const char *s1, const char *s2); -char *strdup(const char *s); -char *strchr(const char *s, int c); -char *strncpy(char *to, const char *from, int count); -char * strcpy (char *dest, const char *src); -char * strstr (const char *s1, const char *s2); - -/* ipchchecksum.c */ -unsigned short ipchksum(const unsigned short *ptr, unsigned long nbytes); - -/* util.S */ -#define abort() halt() -void halt(void) __attribute__ ((noreturn)); - -/* Timer functions - defined by each arcitecture */ - -void ndelay(unsigned int); -void mdelay(unsigned int); -void delay(unsigned int); +#ifdef CONFIG_LAR +/** + * @defgroup lar LAR functions + * @{ + */ + +/** LAR file header */ +struct LAR { + void *start; /**< Location of the LAR in memory */ + int cindex; /**< Next file to return in readlar() */ + int count; /**< Number of entries in the header cache */ + int alloc; /**< Number of slots in the header cache */ + int eof; /**< Last entry in the header cache */ + void **headers; /**< Pointer to the header cache */ +}; + +/** A structure representing the next LAR entry */ +struct larent { + u8 name[LAR_MAX_PATHLEN]; /**< The name of the next LAR entry */ +}; + +/** A structure containing information about a LAR file */ +struct larstat { + u32 len; /**< Length of the file in the LAR */ + u32 reallen; /**< Length of the uncompressed file */ + u32 checksum; /**< Checksum of the uncompressed file */ + u32 compchecksum; /**< Checksum of the compressed file in the LAR */ + u32 offset; /**< Offset of the file in the LAR */ + u32 compression; /**< Compression type of the file */ + u64 entry; /**< Entry point of the file for executables */ + u64 loadaddress; /**< Address in memory to put the uncompressed file */ +}; + +/** A structure representing a LAR file */ +struct LFILE { + struct LAR *lar; /**< Pointer to the LAR struct */ + struct lar_header *header; /**< Pointer to the header struct */ + u32 size; /**< Size of the file */ + void *start; /**< Start of the file in memory */ + u32 offset; /**< Offset of the file in the LAR */ +}; + +struct LAR *openlar(void *addr); +int closelar(struct LAR *lar); +struct larent *readlar(struct LAR *lar); +void rewindlar(struct LAR *lar); +int larstat(struct LAR *lar, const char *path, struct larstat *buf); +void *larfptr(struct LAR *lar, const char *filename); +int lfverify(struct LAR *lar, const char *filename); +struct LFILE *lfopen(struct LAR *lar, const char *filename); +int lfread(void *ptr, size_t size, size_t nmemb, struct LFILE *stream); + +int lfseek(struct LFILE *stream, long offset, int whence); +int lfclose(struct LFILE *file); +/** @} */ +#endif + +/** + * @defgroup info System information functions + * This module contains functions that return information about the system + * @{ + */ + +int sysinfo_have_multiboot(unsigned long *addr); +/** @} */ + +/** + * @defgroup arch Architecture specific functions + * This module contains global architecture specific functions. + * All architectures are expected to define these functions. + * @{ + */ +int get_coreboot_info(struct sysinfo_t *info); +int get_multiboot_info(struct sysinfo_t *info); + +int lib_get_sysinfo(void); + +/* Timer functions - defined by each architecture. */ +unsigned int get_cpu_speed(void); +void ndelay(unsigned int n); +void udelay(unsigned int n); +void mdelay(unsigned int n); +void delay(unsigned int n); + +/** + * @defgroup readline Readline functions + * This interface provides a simple implementation of the standard readline() + * and getline() functions. They read a line of input from the console. + * @{ + */ +char *readline(const char *prompt); +int getline(char *buffer, int len); +/** @} */ #endif