/*
 * Copyright (C) 2016-2026 Canonical
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 */
#include "fwts.h"

#if defined(FWTS_HAS_ACPI)

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <inttypes.h>
#include <stdbool.h>

static fwts_acpi_table_info *table;
acpi_table_init(PCCT, &table)

static bool subspace_length_equal(
	fwts_framework *fw,
	const uint8_t type,
	const uint8_t type_size,
	const uint8_t length)
{
	if (type_size != length) {
		fwts_failed(fw, LOG_LEVEL_HIGH,
			"PCCTBadSubspaceLength",
			"PCCT Subspace Type %" PRId8 " must have length 0x%2.2" PRIx8 ", "
			"got 0x%2.2" PRIx8 " instead", type, type_size, length);
		return false;
	}

	return true;
}

static void gas_messages(
	fwts_framework *fw,
	const uint8_t type,
	const fwts_acpi_gas *gas,
	bool *passed)
{
	char label[20];

	fwts_log_info_simp_int(fw, "      Address Space ID           ", gas->address_space_id);
	fwts_log_info_simp_int(fw, "      Register Bit Width         ", gas->register_bit_width);
	fwts_log_info_simp_int(fw, "      Register Bit Offset        ", gas->register_bit_offset);
	fwts_log_info_simp_int(fw, "      Access Size                ", gas->access_width);
	fwts_log_info_simp_int(fw, "      Address                    ", gas->address);

	snprintf(label, sizeof(label), "Subspace Type % " PRId8, type);
	fwts_acpi_space_id(fw, "PCCT", label, passed, gas->address_space_id, 3,
			   FWTS_GAS_ADDR_SPACE_ID_SYSTEM_MEMORY,
			   FWTS_GAS_ADDR_SPACE_ID_SYSTEM_IO,
			   FWTS_GAS_ADDR_SPACE_ID_FFH);
}

static void gas_messages2(
	fwts_framework *fw,
	const uint8_t type,
	const fwts_acpi_gas *gas,
	bool *passed)
{
	char label[20];

	fwts_log_info_simp_int(fw, "      Address Space ID           ", gas->address_space_id);
	fwts_log_info_simp_int(fw, "      Register Bit Width         ", gas->register_bit_width);
	fwts_log_info_simp_int(fw, "      Register Bit Offset        ", gas->register_bit_offset);
	fwts_log_info_simp_int(fw, "      Access Size                ", gas->access_width);
	fwts_log_info_simp_int(fw, "      Address                    ", gas->address);

	snprintf(label, sizeof(label), "Subspace Type % " PRId8, type);
	fwts_acpi_space_id(fw, "PCCT", label, passed, gas->address_space_id, 2,
			   FWTS_GAS_ADDR_SPACE_ID_SYSTEM_MEMORY, FWTS_GAS_ADDR_SPACE_ID_SYSTEM_IO);
}

static void memory_length(
	fwts_framework *fw,
	const uint8_t type,
	const uint64_t memory_range,
	const uint64_t min_length,
	bool *passed)
{
	switch (type) {
	case 0 ... 2:
		fwts_log_info_simp_int(fw, "    Length:                      ", memory_range);
		if (memory_range <= min_length) {
			*passed = false;
			fwts_failed(fw, LOG_LEVEL_HIGH,
				"PCCTBadSubtypeMemoryLength",
				"PCCT Subspace Type %" PRId8 " must have memory length > 0x%16.16" PRIx64
				", got 0x%16.16" PRIx64 " instead", type, min_length, memory_range);
		}
		break;
	case 3 ... 4:
		fwts_log_info_simp_int(fw, "    Length:                      ", (uint32_t)memory_range);
		if (memory_range <= min_length) {
			*passed = false;
			fwts_failed(fw, LOG_LEVEL_HIGH,
				"PCCTBadSubtypeMemoryLength",
				"PCCT Subspace Type %" PRId8 " must have memory length > 0x%8.8" PRIx32
				", got 0x%8.8" PRIx32 " instead", type, (uint32_t)min_length, (uint32_t)memory_range);
		}
		break;
	}
}

static void generic_comm_test(
	fwts_framework *fw,
	const fwts_acpi_table_pcct_subspace_type_0 *entry,
	bool *passed)
{
	uint64_t reserved;

	reserved = (uint64_t) entry->reserved[0] + ((uint64_t) entry->reserved[1] << 8) +
		   ((uint64_t) entry->reserved[2] << 16) + ((uint64_t) entry->reserved[3] << 24) +
		   ((uint64_t) entry->reserved[4] << 32) + ((uint64_t) entry->reserved[5] << 40);

	fwts_log_info_simp_int(fw, "    Reserved:                    ", reserved);
	fwts_log_info_simp_int(fw, "    Base Address:                ", entry->base_address);
	memory_length(fw, entry->header.type, entry->length, 8, passed);
	fwts_log_info_verbatim(fw, "    Doorbell Register:");
	gas_messages2(fw, entry->header.type, &entry->doorbell_register, passed);
	fwts_log_info_simp_int(fw, "    Doorbell Preserve:           ", entry->doorbell_preserve);
	fwts_log_info_simp_int(fw, "    Doorbell Write:              ", entry->doorbell_write);
	fwts_log_info_simp_int(fw, "    Nominal Latency:             ", entry->nominal_latency);
	fwts_log_info_simp_int(fw, "    Max Periodic Access Rate:    ", entry->max_periodic_access_rate);
	fwts_log_info_simp_int(fw, "    Min Request Turnaround Time: ", entry->min_request_turnaround_time);
}

static void hw_reduced_comm_test_type1(
	fwts_framework *fw,
	const fwts_acpi_table_pcct_subspace_type_1 *entry,
	bool *passed)
{
	fwts_log_info_simp_int(fw, "    Platform Interrupt:          ", entry->platform_interrupt);
	fwts_log_info_simp_int(fw, "    Platform Interrupt Flags:    ", entry->platform_interrupt_flags);
	fwts_log_info_simp_int(fw, "    Reserved:                    ", entry->reserved);
	fwts_log_info_simp_int(fw, "    Base Address:                ", entry->base_address);
	memory_length(fw, entry->header.type, entry->length, 8, passed);
	fwts_log_info_verbatim(fw, "    Doorbell Register:");
	gas_messages(fw, entry->header.type, &entry->doorbell_register, passed);
	fwts_log_info_simp_int(fw, "    Doorbell Preserve:           ", entry->doorbell_preserve);
	fwts_log_info_simp_int(fw, "    Doorbell Write:              ", entry->doorbell_write);
	fwts_log_info_simp_int(fw, "    Nominal Latency:             ", entry->nominal_latency);
	fwts_log_info_simp_int(fw, "    Max Periodic Access Rate:    ", entry->max_periodic_access_rate);
	fwts_log_info_simp_int(fw, "    Min Request Turnaround Time: ", entry->min_request_turnaround_time);

	fwts_acpi_reserved_bits("PCCT", "Platform Interrupt Flags", entry->platform_interrupt_flags, 2, 7, passed);
}

static void hw_reduced_comm_test_type2(
	fwts_framework *fw,
	const fwts_acpi_table_pcct_subspace_type_2 *entry,
	bool *passed)
{
	fwts_log_info_simp_int(fw, "    Platform Interrupt:          ", entry->platform_interrupt);
	fwts_log_info_simp_int(fw, "    Platform Interrupt Flags:    ", entry->platform_interrupt_flags);
	fwts_log_info_simp_int(fw, "    Reserved:                    ", entry->reserved);
	fwts_log_info_simp_int(fw, "    Base Address:                ", entry->base_address);
	memory_length(fw, entry->header.type, entry->length, 8, passed);
	fwts_log_info_verbatim(fw, "    Doorbell Register:");
	gas_messages(fw, entry->header.type, &entry->doorbell_register, passed);
	fwts_log_info_simp_int(fw, "    Doorbell Preserve:           ", entry->doorbell_preserve);
	fwts_log_info_simp_int(fw, "    Doorbell Write:              ", entry->doorbell_write);
	fwts_log_info_simp_int(fw, "    Nominal Latency:             ", entry->nominal_latency);
	fwts_log_info_simp_int(fw, "    Max Periodic Access Rate:    ", entry->max_periodic_access_rate);
	fwts_log_info_simp_int(fw, "    Min Request Turnaround Time: ", entry->min_request_turnaround_time);
	fwts_log_info_verbatim(fw, "    Platform Interrupt Ack Register:");
	gas_messages(fw, entry->header.type, &entry->platform_ack_register, passed);
	fwts_log_info_simp_int(fw, "    Platform Ack Preserve:       ", entry->platform_ack_preserve);
	fwts_log_info_simp_int(fw, "    Platform Ack Write:          ", entry->platform_ack_write);

	fwts_acpi_reserved_bits("PCCT", "Platform Interrupt Flags", entry->platform_interrupt_flags, 2, 7, passed);
}

static void extended_pcc_test(
	fwts_framework *fw,
	const fwts_acpi_table_pcct_subspace_type_3_4 *entry,
	bool *passed)
{
	fwts_log_info_simp_int(fw, "    Platform Interrupt:          ", entry->platform_interrupt);
	fwts_log_info_simp_int(fw, "    Platform Interrupt Flags:    ", entry->platform_interrupt_flags);
	fwts_log_info_simp_int(fw, "    Reserved:                    ", entry->reserved1);
	fwts_log_info_simp_int(fw, "    Base Address:                ", entry->base_address);
	memory_length(fw, entry->header.type, entry->length, 16, passed);
	fwts_log_info_verbatim(fw, "    Doorbell Register:");
	gas_messages(fw, entry->header.type, &entry->doorbell_register, passed);
	fwts_log_info_simp_int(fw, "    Doorbell Preserve:           ", entry->doorbell_preserve);
	fwts_log_info_simp_int(fw, "    Doorbell Write:              ", entry->doorbell_write);
	fwts_log_info_simp_int(fw, "    Nominal Latency:             ", entry->nominal_latency);
	fwts_log_info_simp_int(fw, "    Max Periodic Access Rate:    ", entry->max_periodic_access_rate);
	fwts_log_info_simp_int(fw, "    Min Request Turnaround Time: ", entry->min_request_turnaround_time);
	fwts_log_info_verbatim(fw, "    Platform Int Ack Register:");
	gas_messages(fw, entry->header.type, &entry->platform_ack_register, passed);
	fwts_log_info_verbatim(fw, "    Platform Int Ack Preserve:   0x%16.16" PRIx64, entry->platform_ack_preserve);
	fwts_log_info_verbatim(fw, "    Platform Int Ack Write:      0x%16.16" PRIx64, entry->platform_ack_write);
	fwts_log_info_simp_int(fw, "    Reserved:                    ", entry->reserved2);
	fwts_log_info_verbatim(fw, "    Cmd Complete Check Register:");
	gas_messages(fw, entry->header.type, &entry->cmd_complete_register, passed);
	fwts_log_info_simp_int(fw, "    Cmd Complete Check Mask:     ", entry->cmd_complete_mask);
	fwts_log_info_verbatim(fw, "    Cmd Complete Update Register:");
	gas_messages(fw, entry->header.type, &entry->cmd_update_register, passed);
	fwts_log_info_simp_int(fw, "    Cmd Complete Update Mask:    ", entry->cmd_update_preserve_mask);
	fwts_log_info_simp_int(fw, "    Cmd Complete Set Mask:       ", entry->cmd_update_preserve_mask);
	fwts_log_info_verbatim(fw, "    Error Status Register:");
	gas_messages(fw, entry->header.type, &entry->error_status_register, passed);
	fwts_log_info_simp_int(fw, "    Error Status Mask:           ", entry->error_status_mask);

	fwts_acpi_reserved_bits("PCCT", "Platform Interrupt Flags", entry->platform_interrupt_flags, 2, 7, passed);
}

static void hw_registers_based_comm_test(
	fwts_framework *fw,
	const fwts_acpi_table_pcct_subspace_type_5 *entry,
	bool *passed)
{
	fwts_log_info_simp_int(fw, "    Version:                     ", entry->version);
	fwts_log_info_simp_int(fw, "    Base Address:                ", entry->base_address);
	fwts_log_info_simp_int(fw, "    Shared Memory Range Length:  ", entry->shared_memory_range_length);
	fwts_log_info_verbatim(fw, "    Doorbell Register:");
	gas_messages2(fw, entry->header.type, &entry->doorbell_register, passed);
	fwts_log_info_simp_int(fw, "    Doorbell Preserve:           ", entry->doorbell_preserve);
	fwts_log_info_simp_int(fw, "    Doorbell Write:              ", entry->doorbell_write);
	fwts_log_info_verbatim(fw, "    Cmd Complete Check Register:");
	gas_messages2(fw, entry->header.type, &entry->cmd_complete_register, passed);
	fwts_log_info_simp_int(fw, "    Cmd Complete Check Mask:     ", entry->cmd_complete_mask);
	fwts_log_info_verbatim(fw, "    Error Status Register:");
	gas_messages2(fw, entry->header.type, &entry->error_status_register, passed);
	fwts_log_info_simp_int(fw, "    Error Status Mask:           ", entry->error_status_mask);
	fwts_log_info_simp_int(fw, "    Nominal Latency:             ", entry->nominal_latency);
	fwts_log_info_simp_int(fw, "    Min Request Turnaround Time: ", entry->min_request_turnaround_time);
}

static int pcct_test1(fwts_framework *fw)
{
	fwts_acpi_table_pcct *pcct = (fwts_acpi_table_pcct*) table->data;
	fwts_acpi_table_pcct_subspace_header *pcct_sub;
	size_t offset;
	bool passed = true;

	fwts_log_info_verbatim(fw, "PCC Table:");
	fwts_log_info_simp_int(fw, "  Flags:     ", pcct->flags);
	fwts_log_info_simp_int(fw, "  Reserved:  ", pcct->reserved);
	fwts_log_nl(fw);

	fwts_acpi_reserved_bits("PCCT", "Flags", pcct->flags, 1, 31, &passed);
	fwts_acpi_reserved_zero("PCCT", "Reserved", pcct->reserved, &passed);

	offset = sizeof(fwts_acpi_table_pcct);
	pcct_sub = (fwts_acpi_table_pcct_subspace_header *) (table->data + offset);

	while (offset < table->length) {

		fwts_log_info_verbatim(fw, "  PCC Subspace Structure:");
		fwts_log_info_simp_int(fw, "    Type:                        ", pcct_sub->type);
		fwts_log_info_simp_int(fw, "    Length:                      ", pcct_sub->length);

		if (pcct_sub->type == 0) {
			fwts_acpi_table_pcct_subspace_type_0 *subspace = (fwts_acpi_table_pcct_subspace_type_0 *) pcct_sub;

			if(!subspace_length_equal(fw, 0, sizeof(fwts_acpi_table_pcct_subspace_type_0), pcct_sub->length)) {
				passed = false;
				break;
			}

			generic_comm_test(fw, subspace, &passed);

		} else if (pcct_sub->type == 1) {
			fwts_acpi_table_pcct_subspace_type_1 *subspace = (fwts_acpi_table_pcct_subspace_type_1 *) pcct_sub;

			if(!subspace_length_equal(fw, 0, sizeof(fwts_acpi_table_pcct_subspace_type_1), pcct_sub->length)) {
				passed = false;
				break;
			}

			hw_reduced_comm_test_type1(fw, subspace, &passed);

		} else if (pcct_sub->type == 2) {
			fwts_acpi_table_pcct_subspace_type_2 *subspace = (fwts_acpi_table_pcct_subspace_type_2 *) pcct_sub;

			if(!subspace_length_equal(fw, 0, sizeof(fwts_acpi_table_pcct_subspace_type_2), pcct_sub->length)) {
				passed = false;
				break;
			}

			hw_reduced_comm_test_type2(fw, subspace, &passed);

		} else if (pcct_sub->type == 3) {
			fwts_acpi_table_pcct_subspace_type_3_4 *subspace = (fwts_acpi_table_pcct_subspace_type_3_4 *) pcct_sub;

			if(!subspace_length_equal(fw, 0, sizeof(fwts_acpi_table_pcct_subspace_type_3_4), pcct_sub->length)) {
				passed = false;
				break;
			}

			extended_pcc_test(fw, subspace, &passed);

		} else if (pcct_sub->type == 4) {
			fwts_acpi_table_pcct_subspace_type_3_4 *subspace = (fwts_acpi_table_pcct_subspace_type_3_4 *) pcct_sub;

			if(!subspace_length_equal(fw, 0, sizeof(fwts_acpi_table_pcct_subspace_type_3_4), pcct_sub->length)) {
				passed = false;
				break;
			}

			if (!(pcct->flags & 0x01)) {
				passed = false;
				fwts_failed(fw, LOG_LEVEL_HIGH,
					"PCCTBadFlags",
					"PCCT Platform Interrupt in flags must be set when subspace "
					"type 4 is present, got 0x%8.8" PRIx32 " instead", pcct->flags);
			}

			extended_pcc_test(fw, subspace, &passed);

		} else if (pcct_sub->type == 5) {
			fwts_acpi_table_pcct_subspace_type_5 *subspace = (fwts_acpi_table_pcct_subspace_type_5 *) pcct_sub;

			if(!subspace_length_equal(fw, 0, sizeof(fwts_acpi_table_pcct_subspace_type_5), pcct_sub->length)) {
				passed = false;
				break;
			}

			hw_registers_based_comm_test(fw, subspace, &passed);

		} else {
			passed = false;
			fwts_failed(fw, LOG_LEVEL_HIGH,
				"PCCTBadSubType",
				"PCCT Subspace Structure supports type 0..4, got "
				"0x%2.2" PRIx8 " instead", pcct_sub->type);
			break;
		}

		fwts_log_nl(fw);

		offset += pcct_sub->length;
		pcct_sub = (fwts_acpi_table_pcct_subspace_header *) (table->data + offset);
	}

	if (passed)
		fwts_passed(fw, "No issues found in PCC table.");

	return FWTS_OK;
}

static fwts_framework_minor_test pcct_tests[] = {
	{ pcct_test1, "Validate PCC table." },
	{ NULL, NULL }
};

static fwts_framework_ops pcct_ops = {
	.description = "PCCT Platform Communications Channel test.",
	.init        = PCCT_init,
	.minor_tests = pcct_tests
};

FWTS_REGISTER("pcct", &pcct_ops, FWTS_TEST_ANYTIME, FWTS_FLAG_BATCH | FWTS_FLAG_ACPI)

#endif
