123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981 |
- /* 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 <acpi/acpi_table.h>
- #include <linux/types.h>
- struct acpi_cstate;
- struct acpi_ctx;
- struct acpi_gen_regaddr;
- struct acpi_gpio;
- /* Top 4 bits of the value used to indicate a three-byte length value */
- #define ACPI_PKG_LEN_3_BYTES 0x80
- #define ACPI_METHOD_NARGS_MASK 0x7
- #define ACPI_METHOD_SERIALIZED_MASK BIT(3)
- #define ACPI_END_TAG 0x79
- /* ACPI Op/Prefix codes */
- enum {
- ZERO_OP = 0x00,
- ONE_OP = 0x01,
- NAME_OP = 0x08,
- BYTE_PREFIX = 0x0a,
- WORD_PREFIX = 0x0b,
- DWORD_PREFIX = 0x0c,
- STRING_PREFIX = 0x0d,
- QWORD_PREFIX = 0x0e,
- SCOPE_OP = 0x10,
- BUFFER_OP = 0x11,
- PACKAGE_OP = 0x12,
- METHOD_OP = 0x14,
- SLEEP_OP = 0x22,
- DUAL_NAME_PREFIX = 0x2e,
- MULTI_NAME_PREFIX = 0x2f,
- DEBUG_OP = 0x31,
- EXT_OP_PREFIX = 0x5b,
- ROOT_PREFIX = 0x5c,
- LOCAL0_OP = 0x60,
- LOCAL1_OP = 0x61,
- LOCAL2_OP = 0x62,
- LOCAL3_OP = 0x63,
- LOCAL4_OP = 0x64,
- LOCAL5_OP = 0x65,
- LOCAL6_OP = 0x66,
- LOCAL7_OP = 0x67,
- ARG0_OP = 0x68,
- ARG1_OP = 0x69,
- ARG2_OP = 0x6a,
- ARG3_OP = 0x6b,
- ARG4_OP = 0x6c,
- ARG5_OP = 0x6d,
- ARG6_OP = 0x6e,
- STORE_OP = 0x70,
- AND_OP = 0x7b,
- OR_OP = 0x7d,
- NOT_OP = 0x80,
- DEVICE_OP = 0x82,
- PROCESSOR_OP = 0x83,
- POWER_RES_OP = 0x84,
- NOTIFY_OP = 0x86,
- LEQUAL_OP = 0x93,
- TO_BUFFER_OP = 0x96,
- TO_INTEGER_OP = 0x99,
- IF_OP = 0xa0,
- ELSE_OP = 0xa1,
- RETURN_OP = 0xa4,
- };
- /**
- * enum psd_coord - Coordination types for P-states
- *
- * The type of coordination that exists (hardware) or is required (software) as
- * a result of the underlying hardware dependency
- */
- enum psd_coord {
- SW_ALL = 0xfc,
- SW_ANY = 0xfd,
- HW_ALL = 0xfe
- };
- /**
- * enum csd_coord - Coordination types for C-states
- *
- * The type of coordination that exists (hardware) or is required (software) as
- * a result of the underlying hardware dependency
- */
- enum csd_coord {
- CSD_HW_ALL = 0xfe,
- };
- /**
- * struct acpi_cstate - Information about a C-State
- *
- * @ctype: C State type (1=C1, 2=C2, 3=C3)
- * @latency: Worst-case latency to enter and exit the C State (in uS)
- * @power: Average power consumption of the processor when in this C-State (mW)
- * @resource: Register to read to place the processor in this state
- */
- struct acpi_cstate {
- uint ctype;
- uint latency;
- uint power;
- struct acpi_gen_regaddr resource;
- };
- /**
- * struct acpi_tstate - Information about a Throttling Supported State
- *
- * See ACPI v6.3 section 8.4.5.2: _TSS (Throttling Supported States)
- *
- * @percent: Percent of the core CPU operating frequency that will be
- * available when this throttling state is invoked
- * @power: Throttling state’s maximum power dissipation (mw)
- * @latency: Worst-case latency (uS) that the CPU is unavailable during a
- * transition from any throttling state to this throttling state
- * @control: Value to be written to the Processor Control Register
- * (THROTTLE_CTRL) to initiate a transition to this throttling state
- * @status: Value in THROTTLE_STATUS when in this state
- */
- struct acpi_tstate {
- uint percent;
- uint power;
- uint latency;
- uint control;
- uint status;
- };
- /**
- * 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);
- /**
- * acpigen_write_package() - Start writing a package
- *
- * A package collects together a number of elements in the ACPI code. To write
- * a package use:
- *
- * acpigen_write_package(ctx, 3);
- * ...write things
- * acpigen_pop_len()
- *
- * If you don't know the number of elements in advance, acpigen_write_package()
- * returns a pointer to the value so you can update it later:
- *
- * char *num_elements = acpigen_write_package(ctx, 0);
- * ...write things
- * *num_elements += 1;
- * ...write things
- * *num_elements += 1;
- * acpigen_pop_len()
- *
- * @ctx: ACPI context pointer
- * @nr_el: Number of elements (0 if not known)
- * @returns pointer to the number of elements, which can be updated by the
- * caller if needed
- */
- char *acpigen_write_package(struct acpi_ctx *ctx, int nr_el);
- /**
- * acpigen_write_byte() - Write a byte
- *
- * @ctx: ACPI context pointer
- * @data: Value to write
- */
- void acpigen_write_byte(struct acpi_ctx *ctx, unsigned int data);
- /**
- * acpigen_write_word() - Write a word
- *
- * @ctx: ACPI context pointer
- * @data: Value to write
- */
- void acpigen_write_word(struct acpi_ctx *ctx, unsigned int data);
- /**
- * acpigen_write_dword() - Write a dword
- *
- * @ctx: ACPI context pointer
- * @data: Value to write
- */
- void acpigen_write_dword(struct acpi_ctx *ctx, unsigned int data);
- /**
- * acpigen_write_qword() - Write a qword
- *
- * @ctx: ACPI context pointer
- * @data: Value to write
- */
- void acpigen_write_qword(struct acpi_ctx *ctx, u64 data);
- /**
- * acpigen_write_zero() - Write zero
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_zero(struct acpi_ctx *ctx);
- /**
- * acpigen_write_one() - Write one
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_one(struct acpi_ctx *ctx);
- /**
- * acpigen_write_integer() - Write an integer
- *
- * This writes an operation (BYTE_OP, WORD_OP, DWORD_OP, QWORD_OP depending on
- * the integer size) and an integer value. Note that WORD means 16 bits in ACPI.
- *
- * @ctx: ACPI context pointer
- * @data: Integer to write
- */
- void acpigen_write_integer(struct acpi_ctx *ctx, u64 data);
- /**
- * acpigen_write_name_zero() - Write a named zero value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- */
- void acpigen_write_name_zero(struct acpi_ctx *ctx, const char *name);
- /**
- * acpigen_write_name_one() - Write a named one value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- */
- void acpigen_write_name_one(struct acpi_ctx *ctx, const char *name);
- /**
- * acpigen_write_name_byte() - Write a named byte value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- * @val: Value to write
- */
- void acpigen_write_name_byte(struct acpi_ctx *ctx, const char *name, uint val);
- /**
- * acpigen_write_name_word() - Write a named word value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- * @val: Value to write
- */
- void acpigen_write_name_word(struct acpi_ctx *ctx, const char *name, uint val);
- /**
- * acpigen_write_name_dword() - Write a named dword value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- * @val: Value to write
- */
- void acpigen_write_name_dword(struct acpi_ctx *ctx, const char *name, uint val);
- /**
- * acpigen_write_name_qword() - Write a named qword value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- * @val: Value to write
- */
- void acpigen_write_name_qword(struct acpi_ctx *ctx, const char *name, u64 val);
- /**
- * acpigen_write_name_integer() - Write a named integer value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- * @val: Value to write
- */
- void acpigen_write_name_integer(struct acpi_ctx *ctx, const char *name,
- u64 val);
- /**
- * acpigen_write_name_string() - Write a named string value
- *
- * @ctx: ACPI context pointer
- * @name: Name of the value
- * @string: String to write
- */
- void acpigen_write_name_string(struct acpi_ctx *ctx, const char *name,
- const char *string);
- /**
- * acpigen_write_string() - Write a string
- *
- * This writes a STRING_PREFIX followed by a null-terminated string
- *
- * @ctx: ACPI context pointer
- * @str: String to write
- */
- void acpigen_write_string(struct acpi_ctx *ctx, const char *str);
- /**
- * acpigen_emit_namestring() - Emit an ACPI name
- *
- * This writes out an ACPI name or path in the required special format. It does
- * not add the NAME_OP prefix.
- *
- * @ctx: ACPI context pointer
- * @namepath: Name / path to emit
- */
- void acpigen_emit_namestring(struct acpi_ctx *ctx, const char *namepath);
- /**
- * acpigen_write_name() - Write out an ACPI name
- *
- * This writes out an ACPI name or path in the required special format with a
- * NAME_OP prefix.
- *
- * @ctx: ACPI context pointer
- * @namepath: Name / path to emit
- */
- void acpigen_write_name(struct acpi_ctx *ctx, const char *namepath);
- /**
- * acpigen_write_scope() - Write a scope
- *
- * @ctx: ACPI context pointer
- * @scope: Scope to write (e.g. "\\_SB.ABCD")
- */
- void acpigen_write_scope(struct acpi_ctx *ctx, const char *scope);
- /**
- * acpigen_write_uuid() - Write a UUID
- *
- * This writes out a UUID in the format used by ACPI, with a BUFFER_OP prefix.
- *
- * @ctx: ACPI context pointer
- * @uuid: UUID to write in the form aabbccdd-eeff-gghh-iijj-kkllmmnnoopp
- * @return 0 if OK, -EINVAL if the format is incorrect
- */
- int acpigen_write_uuid(struct acpi_ctx *ctx, const char *uuid);
- /**
- * acpigen_emit_ext_op() - Emit an extended op with the EXT_OP_PREFIX prefix
- *
- * @ctx: ACPI context pointer
- * @op: Operation code (e.g. SLEEP_OP)
- */
- void acpigen_emit_ext_op(struct acpi_ctx *ctx, uint op);
- /**
- * acpigen_write_method() - Write a method header
- *
- * @ctx: ACPI context pointer
- * @name: Method name (4 characters)
- * @nargs: Number of method arguments (0 if none)
- */
- void acpigen_write_method(struct acpi_ctx *ctx, const char *name, int nargs);
- /**
- * acpigen_write_method_serialized() - Write a method header
- *
- * This sets the 'serialized' flag so that the method is thread-safe
- *
- * @ctx: ACPI context pointer
- * @name: Method name (4 characters)
- * @nargs: Number of method arguments (0 if none)
- */
- void acpigen_write_method_serialized(struct acpi_ctx *ctx, const char *name,
- int nargs);
- /**
- * acpigen_write_device() - Write an ACPI device
- *
- * @ctx: ACPI context pointer
- * @name: Device name to write
- */
- void acpigen_write_device(struct acpi_ctx *ctx, const char *name);
- /**
- * acpigen_write_sta() - Write a _STA method
- *
- * @ctx: ACPI context pointer
- * @status: Status value to return
- */
- void acpigen_write_sta(struct acpi_ctx *ctx, uint status);
- /**
- * acpigen_write_resourcetemplate_header() - Write a ResourceTemplate header
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_resourcetemplate_header(struct acpi_ctx *ctx);
- /**
- * acpigen_write_resourcetemplate_footer() - Write a ResourceTemplate footer
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_resourcetemplate_footer(struct acpi_ctx *ctx);
- /**
- * acpigen_write_register_resource() - Write a register resource
- *
- * This writes a header, the address information and a footer
- *
- * @ctx: ACPI context pointer
- * @addr: Address to write
- */
- void acpigen_write_register_resource(struct acpi_ctx *ctx,
- const struct acpi_gen_regaddr *addr);
- /**
- * acpigen_write_sleep() - Write a sleep operation
- *
- * @ctx: ACPI context pointer
- * @sleep_ms: Number of milliseconds to sleep for
- */
- void acpigen_write_sleep(struct acpi_ctx *ctx, u64 sleep_ms);
- /**
- * acpigen_write_store() - Write a store operation
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_store(struct acpi_ctx *ctx);
- /**
- * acpigen_write_debug_string() - Write a debug string
- *
- * This writes a debug operation with an associated string
- *
- * @ctx: ACPI context pointer
- * @str: String to write
- */
- void acpigen_write_debug_string(struct acpi_ctx *ctx, const char *str);
- /**
- * acpigen_write_or() - Write a bitwise OR operation
- *
- * res = arg1 | arg2
- *
- * @ctx: ACPI context pointer
- * @arg1: ACPI opcode for operand 1 (e.g. LOCAL0_OP)
- * @arg2: ACPI opcode for operand 2 (e.g. LOCAL1_OP)
- * @res: ACPI opcode for result (e.g. LOCAL2_OP)
- */
- void acpigen_write_or(struct acpi_ctx *ctx, u8 arg1, u8 arg2, u8 res);
- /**
- * acpigen_write_and() - Write a bitwise AND operation
- *
- * res = arg1 & arg2
- *
- * @ctx: ACPI context pointer
- * @arg1: ACPI opcode for operand 1 (e.g. LOCAL0_OP)
- * @arg2: ACPI opcode for operand 2 (e.g. LOCAL1_OP)
- * @res: ACPI opcode for result (e.g. LOCAL2_OP)
- */
- void acpigen_write_and(struct acpi_ctx *ctx, u8 arg1, u8 arg2, u8 res);
- /**
- * acpigen_write_not() - Write a bitwise NOT operation
- *
- * res = ~arg1
- *
- * @ctx: ACPI context pointer
- * @arg: ACPI opcode for operand (e.g. LOCAL0_OP)
- * @res: ACPI opcode for result (e.g. LOCAL2_OP)
- */
- void acpigen_write_not(struct acpi_ctx *ctx, u8 arg, u8 res);
- /**
- * acpigen_write_power_res() - Write a power resource
- *
- * Name (_PRx, Package(One) { name })
- * ...
- * PowerResource (name, level, order)
- *
- * The caller should fill in the rest of the power resource and then call
- * acpigen_pop_len() to close it off
- *
- * @ctx: ACPI context pointer
- * @name: Name of power resource (e.g. "PRIC")
- * @level: Deepest sleep level that this resource must be kept on (0=S0, 3=S3)
- * @order: Order that this must be enabled/disabled (e.g. 0)
- * @dev_stats: List of states to define, e.g. {"_PR0", "_PR3"}
- * @dev_states_count: Number of dev states
- */
- void acpigen_write_power_res(struct acpi_ctx *ctx, const char *name, uint level,
- uint order, const char *const dev_states[],
- size_t dev_states_count);
- /**
- * acpigen_set_enable_tx_gpio() - Emit ACPI code to enable/disable a GPIO
- *
- * This emits code to either enable to disable a Tx GPIO. It takes account of
- * the GPIO polarity.
- *
- * The code needs access to the DW0 register for the pad being used. This is
- * provided by gpio->pin0_addr and ACPI methods must be defined for the board
- * which can read and write the pad's DW0 register given this address:
- * @dw0_read: takes a single argument, the DW0 address
- * returns the DW0 value
- * @dw0:write: takes two arguments, the DW0 address and the value to write
- * no return value
- *
- * Example code (-- means comment):
- *
- * -- Get Pad Configuration DW0 register value
- * Method (GPC0, 0x1, Serialized)
- * {
- * -- Arg0 - GPIO DW0 address
- * Store (Arg0, Local0)
- * OperationRegion (PDW0, SystemMemory, Local0, 4)
- * Field (PDW0, AnyAcc, NoLock, Preserve) {
- * TEMP, 32
- * }
- * Return (TEMP)
- * }
- *
- * -- Set Pad Configuration DW0 register value
- * Method (SPC0, 0x2, Serialized)
- * {
- * -- Arg0 - GPIO DW0 address
- * -- Arg1 - Value for DW0 register
- * Store (Arg0, Local0)
- * OperationRegion (PDW0, SystemMemory, Local0, 4)
- * Field (PDW0, AnyAcc, NoLock, Preserve) {
- * TEMP,32
- * }
- * Store (Arg1, TEMP)
- * }
- *
- *
- * @ctx: ACPI context pointer
- * @tx_state_val: Mask to use to toggle the TX state on the GPIO pin, e,g.
- * PAD_CFG0_TX_STATE
- * @dw0_read: Method name to use to read dw0, e.g. "\\_SB.GPC0"
- * @dw0_write: Method name to use to read dw0, e.g. "\\_SB.SPC0"
- * @gpio: GPIO to change
- * @enable: true to enable GPIO, false to disable
- * Returns 0 on success, -ve on error.
- */
- int acpigen_set_enable_tx_gpio(struct acpi_ctx *ctx, u32 tx_state_val,
- const char *dw0_read, const char *dw0_write,
- struct acpi_gpio *gpio, bool enable);
- /**
- * acpigen_write_prw() - Write a power resource for wake (_PRW)
- *
- * @ctx: ACPI context pointer
- * @wake: GPE that wakes up the device
- * @level: Deepest power system sleeping state that can be entered while still
- * providing wake functionality
- */
- void acpigen_write_prw(struct acpi_ctx *ctx, uint wake, uint level);
- /**
- * acpigen_write_if() - Write an If block
- *
- * This requires a call to acpigen_pop_len() to complete the block
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_if(struct acpi_ctx *ctx);
- /**
- * acpigen_write_if_lequal_op_int() - Write comparison between op and integer
- *
- * Generates ACPI code for checking if operand1 and operand2 are equal
- *
- * If (Lequal (op, val))
- *
- * @ctx: ACPI context pointer
- * @op: Operand to check
- * @val: Value to check against
- */
- void acpigen_write_if_lequal_op_int(struct acpi_ctx *ctx, uint op, u64 val);
- /**
- * acpigen_write_else() - Write an Ef block
- *
- * This requires a call to acpigen_pop_len() to complete the block
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_else(struct acpi_ctx *ctx);
- /**
- * acpigen_write_to_buffer() - Write a ToBuffer operation
- *
- * E.g.: to generate: ToBuffer (Arg0, Local0)
- * use acpigen_write_to_buffer(ctx, ARG0_OP, LOCAL0_OP)
- *
- * @ctx: ACPI context pointer
- * @src: Source argument
- * @dst: Destination argument
- */
- void acpigen_write_to_buffer(struct acpi_ctx *ctx, uint src, uint dst);
- /**
- * acpigen_write_to_integer() - Write a ToInteger operation
- *
- * E.g.: to generate: ToInteger (Arg0, Local0)
- * use acpigen_write_to_integer(ctx, ARG0_OP, LOCAL0_OP)
- *
- * @ctx: ACPI context pointer
- * @src: Source argument
- * @dst: Destination argument
- */
- void acpigen_write_to_integer(struct acpi_ctx *ctx, uint src, uint dst);
- /**
- * acpigen_write_return_byte_buffer() - Write a return of a byte buffer
- *
- * @ctx: ACPI context pointer
- * @arr: Array of bytes to return
- * @size: Number of bytes
- */
- void acpigen_write_return_byte_buffer(struct acpi_ctx *ctx, u8 *arr,
- size_t size);
- /**
- * acpigen_write_return_singleton_buffer() - Write a return of a 1-byte buffer
- *
- * @ctx: ACPI context pointer
- * @arg: Byte to return
- */
- void acpigen_write_return_singleton_buffer(struct acpi_ctx *ctx, uint arg);
- /**
- * acpigen_write_return_byte() - Write a return of a byte
- *
- * @ctx: ACPI context pointer
- * @arg: Byte to return
- */
- void acpigen_write_return_byte(struct acpi_ctx *ctx, uint arg);
- /**
- * acpigen_write_dsm_start() - Start a _DSM method
- *
- * Generate ACPI AML code to start the _DSM method.
- *
- * The functions need to be called in the correct sequence as below.
- *
- * Within the <generate-code-here> region, Local0 and Local1 must be are left
- * untouched, but Local2-Local7 can be used
- *
- * Arguments passed into _DSM method:
- * Arg0 = UUID
- * Arg1 = Revision
- * Arg2 = Function index
- * Arg3 = Function-specific arguments
- *
- * AML code generated looks like this:
- * Method (_DSM, 4, Serialized) { -- acpigen_write_dsm_start)
- * ToBuffer (Arg0, Local0)
- * If (LEqual (Local0, ToUUID(uuid))) { -- acpigen_write_dsm_uuid_start
- * ToInteger (Arg2, Local1)
- * If (LEqual (Local1, 0)) { -- acpigen_write_dsm_uuid_start_cond
- * <generate-code-here>
- * } -- acpigen_write_dsm_uuid_end_cond
- * ...
- * If (LEqual (Local1, n)) { -- acpigen_write_dsm_uuid_start_cond
- * <generate-code-here>
- * } -- acpigen_write_dsm_uuid_end_cond
- * Return (Buffer (One) { 0x0 })
- * } -- acpigen_write_dsm_uuid_end
- * ...
- * If (LEqual (Local0, ToUUID(uuidn))) {
- * ...
- * }
- * Return (Buffer (One) { 0x0 }) -- acpigen_write_dsm_end
- * }
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_dsm_start(struct acpi_ctx *ctx);
- /**
- * acpigen_write_dsm_uuid_start() - Start a new UUID block
- *
- * This starts generation of code to handle a particular UUID:
- *
- * If (LEqual (Local0, ToUUID(uuid))) {
- * ToInteger (Arg2, Local1)
- *
- * @ctx: ACPI context pointer
- */
- int acpigen_write_dsm_uuid_start(struct acpi_ctx *ctx, const char *uuid);
- /**
- * acpigen_write_dsm_uuid_start_cond() - Start a new condition block
- *
- * This starts generation of condition-checking code to handle a particular
- * function:
- *
- * If (LEqual (Local1, i))
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_dsm_uuid_start_cond(struct acpi_ctx *ctx, int seq);
- /**
- * acpigen_write_dsm_uuid_end_cond() - Start a new condition block
- *
- * This ends generation of condition-checking code to handle a particular
- * function:
- *
- * }
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_dsm_uuid_end_cond(struct acpi_ctx *ctx);
- /**
- * acpigen_write_dsm_uuid_end() - End a UUID block
- *
- * This ends generation of code to handle a particular UUID:
- *
- * Return (Buffer (One) { 0x0 })
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_dsm_uuid_end(struct acpi_ctx *ctx);
- /**
- * acpigen_write_dsm_end() - End a _DSM method
- *
- * This ends generates of the _DSM block:
- *
- * Return (Buffer (One) { 0x0 })
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_dsm_end(struct acpi_ctx *ctx);
- /**
- * acpigen_write_processor() - Write a Processor package
- *
- * This emits a Processor package header with the required information. The
- * caller must complete the information and call acpigen_pop_len() at the end
- *
- * @ctx: ACPI context pointer
- * @cpuindex: CPU number
- * @pblock_addr: PBlk system IO address
- * @pblock_len: PBlk length
- */
- void acpigen_write_processor(struct acpi_ctx *ctx, uint cpuindex,
- u32 pblock_addr, uint pblock_len);
- /**
- * acpigen_write_processor_package() - Write a package containing the processors
- *
- * The package containins the name of each processor in the SoC
- *
- * @ctx: ACPI context pointer
- * @name: Package name (.e.g "PPKG")
- * @first_core: Number of the first core (e.g. 0)
- * @core_count: Number of cores (e.g. 4)
- */
- void acpigen_write_processor_package(struct acpi_ctx *ctx, const char *name,
- uint first_core, uint core_count);
- /**
- * acpigen_write_processor_cnot() - Write a processor notification method
- *
- * This writes a method that notifies all CPU cores
- *
- * @ctx: ACPI context pointer
- * @num_cores: Number of CPU cores
- */
- void acpigen_write_processor_cnot(struct acpi_ctx *ctx, const uint num_cores);
- /**
- * acpigen_write_ppc() - generates a function returning max P-states
- *
- * @ctx: ACPI context pointer
- * @num_pstates: Number of pstates to return
- */
- void acpigen_write_ppc(struct acpi_ctx *ctx, uint num_pstates);
- /**
- * acpigen_write_ppc() - generates a function returning PPCM
- *
- * This returns the maximum number of supported P-states, as saved in the
- * variable PPCM
- *
- * @ctx: ACPI context pointer
- */
- void acpigen_write_ppc_nvs(struct acpi_ctx *ctx);
- /**
- * acpigen_write_tpc() - Write a _TPC method that returns the TPC limit
- *
- * @ctx: ACPI context pointer
- * @gnvs_tpc_limit: Variable that holds the TPC limit
- */
- void acpigen_write_tpc(struct acpi_ctx *ctx, const char *gnvs_tpc_limit);
- /**
- * acpigen_write_pss_package() - Write a PSS package
- *
- * See ACPI v6.3 section 8.4.6: Processor Performance Control
- *
- * @ctx: ACPI context pointer
- * @corefreq: CPU core frequency in MHz
- * @translat: worst-case latency in uS that the CPU is unavailable during a
- * transition from any performance state to this performance state
- * @busmlat: worst-case latency in microseconds that Bus Masters are prevented
- * from accessing memory during a transition from any performance state to
- * this performance state
- * @control: Value to write to PERF_CTRL to move to this performance state
- * @status: Expected PERF_STATUS value when in this state
- */
- void acpigen_write_pss_package(struct acpi_ctx *ctx, uint corefreq, uint power,
- uint translat, uint busmlat, uint control,
- uint status);
- /**
- * acpigen_write_psd_package() - Write a PSD package
- *
- * Writes a P-State dependency package
- *
- * See ACPI v6.3 section 8.4.6.5: _PSD (P-State Dependency)
- *
- * @ctx: ACPI context pointer
- * @domain: Dependency domain number to which this P state entry belongs
- * @numprocs: Number of processors belonging to the domain for this logical
- * processor’s P-states
- * @coordtype: Coordination type
- */
- void acpigen_write_psd_package(struct acpi_ctx *ctx, uint domain, uint numprocs,
- enum psd_coord coordtype);
- /**
- * acpigen_write_cst_package() - Write a _CST package
- *
- * See ACPI v6.3 section 8.4.2.1: _CST (C States)
- *
- * @ctx: ACPI context pointer
- * @entry: Array of entries
- * @nentries; Number of entries
- */
- void acpigen_write_cst_package(struct acpi_ctx *ctx,
- const struct acpi_cstate *entry, int nentries);
- /**
- * acpigen_write_csd_package() - Write a _CSD Package
- *
- * See ACPI v6.3 section 8.4.2.2: _CSD (C-State Dependency)
- *
- * @ctx: ACPI context pointer
- * @domain: dependency domain number to which this C state entry belongs
- * @numprocs: number of processors belonging to the domain for the particular
- * C-state
- * @coordtype: Co-ordination type
- * @index: Index of the C-State entry in the _CST object for which the
- * dependency applies
- */
- void acpigen_write_csd_package(struct acpi_ctx *ctx, uint domain, uint numprocs,
- enum csd_coord coordtype, uint index);
- /**
- * acpigen_write_tss_package() - Write a _TSS package
- *
- * @ctx: ACPI context pointer
- * @entry: Entries to write
- * @nentries: Number of entries to write
- */
- void acpigen_write_tss_package(struct acpi_ctx *ctx,
- struct acpi_tstate *entry, int nentries);
- /**
- * acpigen_write_tsd_package() - Write a _TSD package
- *
- * See ACPI v6.3 section 8.4.5.4: _TSD (T-State Dependency)
- *
- * @ctx: ACPI context pointer
- * @domain: dependency domain number to which this T state entry belongs
- * @numprocs: Number of processors belonging to the domain for this logical
- * processor’s T-states
- * @coordtype: Coordination type
- */
- void acpigen_write_tsd_package(struct acpi_ctx *ctx, uint domain, uint numprocs,
- enum psd_coord coordtype);
- #endif
|