xref: /src/usr.sbin/acpitools/aml/aml_common.c

/*	$NetBSD: aml_common.c,v 1.5 2021/12/12 08:49:58 andvar Exp $	*/

/*-
 * Copyright (c) 1999 Takanori Watanabe
 * Copyright (c) 1999, 2000 Mitsuru IWASAKI <iwasaki (at) FreeBSD.org>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 *	Id: aml_common.c,v 1.9 2000/08/09 14:47:43 iwasaki Exp
 *	$FreeBSD: src/usr.sbin/acpi/amldb/aml/aml_common.c,v 1.6 2000/11/09 06:24:45 iwasaki Exp $
 */
#include <sys/cdefs.h>
__RCSID("$NetBSD: aml_common.c,v 1.5 2021/12/12 08:49:58 andvar Exp $");

#include <sys/param.h>

#ifndef _KERNEL
#include <assert.h>
#include <err.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#else /* _KERNEL */
#include "opt_acpi.h"
#include <sys/kernel.h>
#include <sys/sysctl.h>
#include <sys/systm.h>
#include <sys/bus.h>
#include <dev/acpi/acpireg.h>
#include <dev/acpi/acpivar.h>
#ifndef ACPI_NO_OSDFUNC_INLINE
#include <machine/acpica_osd.h>
#endif /* !ACPI_NO_OSDFUNC_INLINE */
#endif /* !_KERNEL */

#include <acpi_common.h>
#include <aml/aml_common.h>
#include <aml/aml_env.h>
#include <aml/aml_evalobj.h>
#include <aml/aml_name.h>
#include <aml/aml_obj.h>
#include <aml/aml_parse.h>
#include <aml/aml_status.h>
#include <aml/aml_store.h>

/* for debugging */
#ifdef AML_DEBUG
int	aml_debug = 1;
#else	/* !AML_DEBUG */
int	aml_debug = 0;
#endif	/* AML_DEBUG */
#ifdef _KERNEL
SYSCTL_INT(_debug, OID_AUTO, aml_debug, CTLFLAG_RW, &aml_debug, 1, "");
#endif /* _KERNEL */

static void	 aml_print_nameseg(u_int8_t *dp);

static void
aml_print_nameseg(u_int8_t *dp)
{

	if (dp[3] != '_') {
		AML_DEBUGPRINT("%c%c%c%c", dp[0], dp[1], dp[2], dp[3]);
	} else if (dp[2] != '_') {
		AML_DEBUGPRINT("%c%c%c_", dp[0], dp[1], dp[2]);
	} else if (dp[1] != '_') {
		AML_DEBUGPRINT("%c%c__", dp[0], dp[1]);
	} else if (dp[0] != '_') {
		AML_DEBUGPRINT("%c___", dp[0]);
	}
}

void
aml_print_namestring(u_int8_t *dp)
{
	int	segcount;
	int	i;

	if (dp[0] == '\\') {
		AML_DEBUGPRINT("%c", dp[0]);
		dp++;
	} else if (dp[0] == '^') {
		while (dp[0] == '^') {
			AML_DEBUGPRINT("%c", dp[0]);
			dp++;
		}
	}
	if (dp[0] == 0x00) {	/* NullName */
		/* AML_DEBUGPRINT("<null>"); */
		dp++;
	} else if (dp[0] == 0x2e) {	/* DualNamePrefix */
		aml_print_nameseg(dp + 1);
		AML_DEBUGPRINT("%c", '.');
		aml_print_nameseg(dp + 5);
	} else if (dp[0] == 0x2f) {	/* MultiNamePrefix */
		segcount = dp[1];
		for (i = 0, dp += 2; i < segcount; i++, dp += 4) {
			if (i > 0) {
				AML_DEBUGPRINT("%c", '.');
			}
			aml_print_nameseg(dp);
		}
	} else			/* NameSeg */
		aml_print_nameseg(dp);
}

int
aml_print_curname(struct aml_name *name)
{
	struct	aml_name *root;

	root = aml_get_rootname();
	if (name == root) {
		AML_DEBUGPRINT("\\");
		return (0);
	} else {
		aml_print_curname(name->parent);
	}
	aml_print_nameseg((unsigned char *)name->name);
	AML_DEBUGPRINT(".");
	return (0);
}

void
aml_print_indent(int indent)
{
	int	i;

	for (i = 0; i < indent; i++)
		AML_DEBUGPRINT("    ");
}

void
aml_showobject(union aml_object * obj)
{
	int	debug;
	int	i;

	if (obj == NULL) {
		printf("NO object\n");
		return;
	}
	debug = aml_debug;
	aml_debug = 1;
	switch (obj->type) {
	case aml_t_num:
		printf("Num:0x%x\n", obj->num.number);
		break;
	case aml_t_processor:
		printf("Processor:No %d,Port 0x%x length 0x%x\n",
		    obj->proc.id, obj->proc.addr, obj->proc.len);
		break;
	case aml_t_mutex:
		printf("Mutex:Level %d\n", obj->mutex.level);
		break;
	case aml_t_powerres:
		printf("PowerResource:Level %d Order %d\n",
		    obj->pres.level, obj->pres.order);
		break;
	case aml_t_opregion:
		printf("OperationRegion:Busspace%d, Offset 0x%x Length 0x%x\n",
		    obj->opregion.space, obj->opregion.offset,
		    obj->opregion.length);
		break;
	case aml_t_field:
		printf("Fieldelement:flag 0x%x offset 0x%x len 0x%x {",
		    obj->field.flags, obj->field.bitoffset,
		    obj->field.bitlen);
		switch (obj->field.f.ftype) {
		case f_t_field:
			aml_print_namestring(obj->field.f.fld.regname);
			break;
		case f_t_index:
			aml_print_namestring(obj->field.f.ifld.indexname);
			printf(" ");
			aml_print_namestring(obj->field.f.ifld.dataname);
			break;
		case f_t_bank:
			aml_print_namestring(obj->field.f.bfld.regname);
			printf(" ");
			aml_print_namestring(obj->field.f.bfld.bankname);
			printf("0x%x", obj->field.f.bfld.bankvalue);
			break;
		}
		printf("}\n");
		break;
	case aml_t_method:
		printf("Method: Arg %d From %p To %p\n", obj->meth.argnum,
		    obj->meth.from, obj->meth.to);
		break;
	case aml_t_buffer:
		printf("Buffer: size:0x%x Data %p\n", obj->buffer.size,
		    obj->buffer.data);
		break;
	case aml_t_device:
		printf("Device\n");
		break;
	case aml_t_bufferfield:
		printf("Bufferfield:offset 0x%x len 0x%x Origin %p\n",
		    obj->bfld.bitoffset, obj->bfld.bitlen, obj->bfld.origin);
		break;
	case aml_t_string:
		printf("String:%s\n", obj->str.string);
		break;
	case aml_t_package:
		printf("Package:elements %d \n", obj->package.elements);
		for (i = 0; i < obj->package.elements; i++) {
			if (obj->package.objects[i] == NULL) {
				break;
			}
			if (obj->package.objects[i]->type < 0) {
				continue;
			}
			printf("        ");
			aml_showobject(obj->package.objects[i]);
		}
		break;
	case aml_t_therm:
		printf("Thermalzone\n");
		break;
	case aml_t_event:
		printf("Event\n");
		break;
	case aml_t_ddbhandle:
		printf("DDBHANDLE\n");
		break;
	case aml_t_objref:
		if (obj->objref.alias == 1) {
			printf("Alias");
		} else {
			printf("Object reference");
			if (obj->objref.offset >= 0) {
				printf(" (offset 0x%x)", obj->objref.offset);
			}
		}
		printf(" of ");
		aml_showobject(obj->objref.ref);
		break;
	default:
		printf("UNK ID=%d\n", obj->type);
	}

	aml_debug = debug;
}

void
aml_showtree(struct aml_name * aname, int lev)
{
	int	i;
	struct	aml_name *ptr;
	char	name[5];

	for (i = 0; i < lev; i++) {
		printf("  ");
	}
	strncpy(name, aname->name, 4);
	name[4] = 0;
	printf("%s  ", name);
	if (aname->property != NULL) {
		aml_showobject(aname->property);
	} else {
		printf("\n");
	}
	for (ptr = aname->child; ptr; ptr = ptr->brother)
		aml_showtree(ptr, lev + 1);
}

/*
 * Common Region I/O Stuff
 */

static __inline u_int64_t
aml_adjust_bitmask(u_int32_t flags, u_int32_t bitlen)
{
	u_int64_t	bitmask;

	switch (AML_FIELDFLAGS_ACCESSTYPE(flags)) {
	case AML_FIELDFLAGS_ACCESS_ANYACC:
		if (bitlen <= 8) {
			bitmask = 0x000000ff;
			break;
		}
		if (bitlen <= 16) {
			bitmask = 0x0000ffff;
			break;
		}
		bitmask = 0xffffffff;
		break;
	case AML_FIELDFLAGS_ACCESS_BYTEACC:
		bitmask = 0x000000ff;
		break;
	case AML_FIELDFLAGS_ACCESS_WORDACC:
		bitmask = 0x0000ffff;
		break;
	case AML_FIELDFLAGS_ACCESS_DWORDACC:
	default:
		bitmask = 0xffffffff;
		break;
	}

	switch (bitlen) {
	case 16:
		bitmask |= 0x0000ffff;
		break;
	case 32:
		bitmask |= 0xffffffff;
		break;
	}

	return (bitmask);
}

u_int32_t
aml_adjust_readvalue(u_int32_t flags, u_int32_t bitoffset, u_int32_t bitlen,
    u_int32_t orgval)
{
	u_int32_t	offset, retval;
	u_int64_t	bitmask;

	offset = bitoffset;	/* XXX bitoffset may change in this function! */
	bitmask = aml_adjust_bitmask(flags, bitlen);
	retval = (orgval >> offset) & (~(bitmask << bitlen)) & bitmask;

	return (retval);
}

u_int32_t
aml_adjust_updatevalue(u_int32_t flags, u_int32_t bitoffset, u_int32_t bitlen,
    u_int32_t orgval, u_int32_t value)
{
	u_int32_t	offset, retval;
	u_int64_t	bitmask;

	offset = bitoffset;	/* XXX bitoffset may change in this function! */
	bitmask = aml_adjust_bitmask(flags, bitlen);
	retval = orgval;
	switch (AML_FIELDFLAGS_UPDATERULE(flags)) {
	case AML_FIELDFLAGS_UPDATE_PRESERVE:
		retval &= (~(((u_int64_t)1 << bitlen) - 1) << offset) |
			  (~(bitmask << offset));
		break;
	case AML_FIELDFLAGS_UPDATE_WRITEASONES:
		retval =  (~(((u_int64_t)1 << bitlen) - 1) << offset) |
			  (~(bitmask << offset));
		retval &= bitmask;	/* trim the upper bits */
		break;
	case AML_FIELDFLAGS_UPDATE_WRITEASZEROS:
		retval = 0;
		break;
	default:
		printf("illegal update rule: %d\n", flags);
		return (orgval);
	}

	retval |= (value << (offset & bitmask));
	return (retval);
}

/*
 * BufferField I/O
 */

#define AML_BUFFER_INPUT	0
#define AML_BUFFER_OUTPUT	1

static int	 aml_bufferfield_io(int io, u_int32_t *valuep,
				    u_int8_t *origin, u_int32_t bitoffset,
				    u_int32_t bitlen);

static int
aml_bufferfield_io(int io, u_int32_t *valuep, u_int8_t *origin,
    u_int32_t bitoffset, u_int32_t bitlen)
{
	u_int8_t	val, tmp, masklow, maskhigh;
	u_int8_t	offsetlow, offsethigh;
	u_int8_t	*addr;
	u_int32_t	value, readval;
	u_int32_t	byteoffset, bytelen, i;

	masklow = maskhigh = 0xff;
	val = readval = 0;
	value = *valuep;

	byteoffset = bitoffset / 8;
	bytelen = bitlen / 8 + ((bitlen % 8) ? 1 : 0);
	addr = origin + byteoffset;

	/* simple I/O ? */
	if (bitlen <= 8 || bitlen == 16 || bitlen == 32) {
		bcopy(addr, &readval, bytelen);
		AML_DEBUGPRINT("\n\t[bufferfield:0x%x@%p:%d,%d]",
		    readval, addr, bitoffset % 8, bitlen);
		switch (io) {
		case AML_BUFFER_INPUT:
			value = aml_adjust_readvalue(AML_FIELDFLAGS_ACCESS_BYTEACC,
			    bitoffset % 8, bitlen, readval);
			*valuep = value;
			AML_DEBUGPRINT("\n[read(bufferfield, %p)&mask:0x%x]\n",
			    addr, value);
			break;
		case AML_BUFFER_OUTPUT:
			value = aml_adjust_updatevalue(AML_FIELDFLAGS_ACCESS_BYTEACC,
			    bitoffset % 8, bitlen, readval, value);
			bcopy(&value, addr, bytelen);
			AML_DEBUGPRINT("->[bufferfield:0x%x@%p:%d,%d]",
			    value, addr, bitoffset % 8, bitlen);
			break;
		}
		goto out;
	}

	offsetlow = bitoffset % 8;
	if (bytelen > 1) {
		offsethigh = (bitlen - (8 - offsetlow)) % 8;
	} else {
		offsethigh = 0;
	}

	if (offsetlow) {
		masklow = (~((1 << bitlen) - 1) << offsetlow) | ~(0xff << offsetlow);
		AML_DEBUGPRINT("\t[offsetlow = 0x%x, masklow = 0x%x, ~masklow = 0x%x]\n",
		    offsetlow, masklow, ~masklow & 0xff);
	}
	if (offsethigh) {
		maskhigh = 0xff << offsethigh;
		AML_DEBUGPRINT("\t[offsethigh = 0x%x, maskhigh = 0x%x, ~maskhigh = 0x%x]\n",
		    offsethigh, maskhigh, ~maskhigh & 0xff);
	}
	for (i = bytelen; i > 0; i--, addr++) {
		val = *addr;

		AML_DEBUGPRINT("\t[bufferfield:0x%02x@%p]", val, addr);

		switch (io) {
		case AML_BUFFER_INPUT:
			tmp = val;
			/* the lowest byte? */
			if (i == bytelen) {
				if (offsetlow) {
					readval = tmp & ~masklow;
				} else {
					readval = tmp;
				}
			} else {
				if (i == 1 && offsethigh) {
					tmp = tmp & ~maskhigh;
				}
				readval = (tmp << (8 * (bytelen - i))) | readval;
			}

			AML_DEBUGPRINT("\n");
			/* goto to next byte... */
			if (i > 1) {
				continue;
			}
			/* final adjustment before finishing region access */
			if (offsetlow) {
				readval = readval >> offsetlow;
			}
			AML_DEBUGPRINT("[read(bufferfield, %p)&mask:0x%x]\n",
			    addr, readval);
			*valuep = readval;

			break;

		case AML_BUFFER_OUTPUT:
			tmp = value & 0xff;
			/* the lowest byte? */
			if (i == bytelen) {
				if (offsetlow) {
					tmp = (val & masklow) | tmp << offsetlow;
				}
				value = value >> (8 - offsetlow);
			} else {
				if (i == 1 && offsethigh) {
					tmp = (val & maskhigh) | tmp;
				}
				value = value >> 8;
			}

			AML_DEBUGPRINT("->[bufferfield:0x%02x@%p]\n",
			    tmp, addr);
			*addr = tmp;
		}
	}
out:
	return (0);
}

u_int32_t
aml_bufferfield_read(u_int8_t *origin, u_int32_t bitoffset,
    u_int32_t bitlen)
{
	int	value;

	value = 0;
	aml_bufferfield_io(AML_BUFFER_INPUT, (u_int32_t *)&value, origin,
	    bitoffset, bitlen);
	return (value);
}

int
aml_bufferfield_write(u_int32_t value, u_int8_t *origin,
    u_int32_t bitoffset, u_int32_t bitlen)
{
	int	status;

	status = aml_bufferfield_io(AML_BUFFER_OUTPUT, &value,
	    origin, bitoffset, bitlen);
	return (status);
}

int
aml_region_handle_alloc(struct aml_environ *env, int regtype, u_int32_t flags,
    u_int32_t baseaddr, u_int32_t bitoffset, u_int32_t bitlen,
    struct aml_region_handle *h)
{
	int	state;

	state = 0;
	bzero(h, sizeof(struct aml_region_handle));

	h->env = env;
	h->regtype = regtype;
	h->flags = flags;
	h->baseaddr = baseaddr;
	h->bitoffset = bitoffset;
	h->bitlen = bitlen;

	switch (AML_FIELDFLAGS_ACCESSTYPE(flags)) {
	case AML_FIELDFLAGS_ACCESS_ANYACC:
		if (bitlen <= 8) {
			h->unit = 1;
			break;
		}
		if (bitlen <= 16) {
			h->unit = 2;
			break;
		}
		h->unit = 4;
		break;
	case AML_FIELDFLAGS_ACCESS_BYTEACC:
		h->unit = 1;
		break;
	case AML_FIELDFLAGS_ACCESS_WORDACC:
		h->unit = 2;
		break;
	case AML_FIELDFLAGS_ACCESS_DWORDACC:
		h->unit = 4;
		break;
	default:
		h->unit = 1;
		break;
	}

	h->addr = baseaddr + h->unit * ((bitoffset / 8) / h->unit);
	h->bytelen = baseaddr + ((bitoffset + bitlen) / 8) - h->addr +
		     ((bitlen % 8) ? 1 : 0);

#ifdef _KERNEL
	switch (h->regtype) {
	case AML_REGION_SYSMEM:
		OsdMapMemory((void *)h->addr, h->bytelen, (void **)&h->vaddr);
		break;

	case AML_REGION_PCICFG:
		/* Obtain PCI bus number */
		pci_info = aml_search_name(env, "_BBN");
		if (pci_info == NULL || pci_info->property->type != aml_t_num) {
			AML_DEBUGPRINT("Cannot locate _BBN. Using default 0\n");
			h->pci_bus = 0;
		} else {
			AML_DEBUGPRINT("found _BBN: %d\n",
			    pci_info->property->num.number);
			h->pci_bus = pci_info->property->num.number & 0xff;
		}

		/* Obtain device & function number */
		pci_info = aml_search_name(env, "_ADR");
		if (pci_info == NULL || pci_info->property->type != aml_t_num) {
			printf("Cannot locate: _ADR\n");
			state = -1;
			goto out;
		}
		h->pci_devfunc = pci_info->property->num.number;

		AML_DEBUGPRINT("[pci%d.%d]", h->pci_bus, h->pci_devfunc);
		break;

	default:
		break;
	}

out:
#endif	/* _KERNEL */
	return (state);
}

void
aml_region_handle_free(struct aml_region_handle *h)
{
#ifdef _KERNEL
	switch (h->regtype) {
	case AML_REGION_SYSMEM:
		OsdUnMapMemory((void *)h->vaddr, h->bytelen);
		break;

	default:
		break;
	}
#endif	/* _KERNEL */
}

static int
aml_region_io_simple(struct aml_environ *env, int io, int regtype,
    u_int32_t flags, u_int32_t *valuep, u_int32_t baseaddr,
    u_int32_t bitoffset, u_int32_t bitlen)
{
	int		state;
	u_int32_t	readval, value, offset, bytelen, i;
	struct		aml_region_handle handle;

	state = aml_region_handle_alloc(env, regtype, flags,
            baseaddr, bitoffset, bitlen, &handle);
	if (state == -1) {
		goto out;
	}

	readval = 0;
	offset = bitoffset % (handle.unit * 8);
	/* limitation of 32 bits alignment */
	bytelen = (handle.bytelen > 4) ? 4 : handle.bytelen;

	if (io == AML_REGION_INPUT ||
	    AML_FIELDFLAGS_UPDATERULE(flags) == AML_FIELDFLAGS_UPDATE_PRESERVE) {
		for (i = 0; i < bytelen; i += handle.unit) {
			state = aml_region_read_simple(&handle, i, &value);
			if (state == -1) {
				goto out;
			}
			readval |= (value << (i * 8));
		}
		AML_DEBUGPRINT("\t[%d:0x%x@0x%lx:%d,%d]",
		    regtype, readval, handle.addr, offset, bitlen);
	}

	switch (io) {
	case AML_REGION_INPUT:
		AML_DEBUGPRINT("\n");
		readval = aml_adjust_readvalue(flags, offset, bitlen, readval);
		value = readval;
		value = aml_region_prompt_read(&handle, value);
		state = aml_region_prompt_update_value(readval, value, &handle);
		if (state == -1) {
			goto out;
		}

		*valuep = value;
		break;
	case AML_REGION_OUTPUT:
		value = *valuep;
		value = aml_adjust_updatevalue(flags, offset,
		    bitlen, readval, value);
		value = aml_region_prompt_write(&handle, value);
		AML_DEBUGPRINT("\t->[%d:0x%x@0x%lx:%d,%d]\n", regtype, value,
		    handle.addr, offset, bitlen);
		for (i = 0; i < bytelen; i += handle.unit) {
			state = aml_region_write_simple(&handle, i, value);
			if (state == -1) {
				goto out;
			}
			value = value >> (handle.unit * 8);
		}
		break;
	}

	aml_region_handle_free(&handle);
out:
	return (state);
}

int
aml_region_io(struct aml_environ *env, int io, int regtype,
    u_int32_t flags, u_int32_t *valuep, u_int32_t baseaddr,
    u_int32_t bitoffset, u_int32_t bitlen)
{
	u_int32_t	unit, offset;
	u_int32_t	offadj, bitadj;
	u_int32_t	value, readval, i;
	int		state;

	readval = 0;
	state = 0;
	unit = 4;	/* limitation of 32 bits alignment */
	offset = bitoffset % (unit * 8);
	offadj = 0;
	bitadj = 0;
	if (offset + bitlen > unit * 8) {
		bitadj = bitlen  - (unit * 8 - offset);
	}
	for (i = 0; i < offset + bitlen; i += unit * 8) {
		value = (*valuep) >> offadj;
		state = aml_region_io_simple(env, io, regtype, flags,
		    &value, baseaddr, bitoffset + offadj, bitlen - bitadj);
		if (state == -1) {
			goto out;
		}
		readval |= value << offadj;
		bitadj = offadj = bitlen - bitadj;
	}
	*valuep = readval;

out:
	return (state);
}