mirror of
https://github.com/brain-hackers/u-boot-brain
synced 2024-07-05 10:46:15 +09:00
![Simon Glass](/assets/img/avatar_default.png)
It is convenient to write a length value for preceding a block of data. Of course the length is not known or is hard to calculate a priori. So add a way to mark the start on a stack, so the length can be updated when known. Signed-off-by: Simon Glass <sjg@chromium.org> Reviewed-by: Wolfgang Wallner <wolfgang.wallner@br-automation.com> Reviewed-by: Bin Meng <bmeng.cn@gmail.com>
110 lines
2.7 KiB
C
110 lines
2.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Core ACPI (Advanced Configuration and Power Interface) support
|
|
*
|
|
* Copyright 2019 Google LLC
|
|
*
|
|
* Modified from coreboot file acpigen.h
|
|
*/
|
|
|
|
#ifndef __ACPI_ACPIGEN_H
|
|
#define __ACPI_ACPIGEN_H
|
|
|
|
#include <linux/types.h>
|
|
|
|
struct acpi_ctx;
|
|
|
|
/* Top 4 bits of the value used to indicate a three-byte length value */
|
|
#define ACPI_PKG_LEN_3_BYTES 0x80
|
|
|
|
/**
|
|
* acpigen_get_current() - Get the current ACPI code output pointer
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
* @return output pointer
|
|
*/
|
|
u8 *acpigen_get_current(struct acpi_ctx *ctx);
|
|
|
|
/**
|
|
* acpigen_emit_byte() - Emit a byte to the ACPI code
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
* @data: Value to output
|
|
*/
|
|
void acpigen_emit_byte(struct acpi_ctx *ctx, uint data);
|
|
|
|
/**
|
|
* acpigen_emit_word() - Emit a 16-bit word to the ACPI code
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
* @data: Value to output
|
|
*/
|
|
void acpigen_emit_word(struct acpi_ctx *ctx, uint data);
|
|
|
|
/**
|
|
* acpigen_emit_dword() - Emit a 32-bit 'double word' to the ACPI code
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
* @data: Value to output
|
|
*/
|
|
void acpigen_emit_dword(struct acpi_ctx *ctx, uint data);
|
|
|
|
/**
|
|
* acpigen_emit_stream() - Emit a stream of bytes
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
* @data: Data to output
|
|
* @size: Size of data in bytes
|
|
*/
|
|
void acpigen_emit_stream(struct acpi_ctx *ctx, const char *data, int size);
|
|
|
|
/**
|
|
* acpigen_emit_string() - Emit a string
|
|
*
|
|
* Emit a string with a null terminator
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
* @str: String to output, or NULL for an empty string
|
|
*/
|
|
void acpigen_emit_string(struct acpi_ctx *ctx, const char *str);
|
|
|
|
/**
|
|
* acpigen_write_len_f() - Write a 'forward' length placeholder
|
|
*
|
|
* This adds space for a length value in the ACPI stream and pushes the current
|
|
* position (before the length) on the stack. After calling this you can write
|
|
* some data and then call acpigen_pop_len() to update the length value.
|
|
*
|
|
* Usage:
|
|
*
|
|
* acpigen_write_len_f() ------\
|
|
* acpigen_write...() |
|
|
* acpigen_write...() |
|
|
* acpigen_write_len_f() --\ |
|
|
* acpigen_write...() | |
|
|
* acpigen_write...() | |
|
|
* acpigen_pop_len() ------/ |
|
|
* acpigen_write...() |
|
|
* acpigen_pop_len() ----------/
|
|
*
|
|
* See ACPI 6.3 section 20.2.4 Package Length Encoding
|
|
*
|
|
* This implementation always uses a 3-byte packet length for simplicity. It
|
|
* could be adjusted to support other lengths.
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
*/
|
|
void acpigen_write_len_f(struct acpi_ctx *ctx);
|
|
|
|
/**
|
|
* acpigen_pop_len() - Update the previously stacked length placeholder
|
|
*
|
|
* Call this after the data for the block has been written. It updates the
|
|
* top length value in the stack and pops it off.
|
|
*
|
|
* @ctx: ACPI context pointer
|
|
*/
|
|
void acpigen_pop_len(struct acpi_ctx *ctx);
|
|
|
|
#endif
|