/*      $NetBSD: vcprop.h,v 1.20 2021/03/08 13:53:08 mlelstv Exp $      */

/*-
* Copyright (c) 2012 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Nick Hudson
*
* 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
*/

/*
* Mailbox property interface
*/

#ifndef _EVBARM_RPI_VCPROP_H_
#define _EVBARM_RPI_VCPROP_H_

#include "opt_vcprop.h"

#include <sys/endian.h>

struct vcprop_tag {
       uint32_t vpt_tag;
#define VCPROPTAG_NULL                  0x00000000
#define VCPROPTAG_GET_FIRMWAREREV       0x00000001
#define VCPROPTAG_GET_FIRMWAREVARIANT   0x00000002
#define VCPROPTAG_GET_FIRMWAREHASH      0x00000003
#define VCPROPTAG_GET_BOARDMODEL        0x00010001
#define VCPROPTAG_GET_BOARDREVISION     0x00010002
#define VCPROPTAG_GET_MACADDRESS        0x00010003
#define VCPROPTAG_GET_BOARDSERIAL       0x00010004
#define VCPROPTAG_GET_ARMMEMORY         0x00010005
#define VCPROPTAG_GET_VCMEMORY          0x00010006
#define VCPROPTAG_GET_CLOCKS            0x00010007

#define VCPROPTAG_GET_POWERSTATE        0x00020001
#define VCPROPTAG_GET_POWERTIMING       0x00020002
#define VCPROPTAG_SET_POWERSTATE        0x00028001

#define VCPROPTAG_GET_CLOCKSTATE        0x00030001
#define VCPROPTAG_SET_CLOCKSTATE        0x00038001
#define VCPROPTAG_GET_CLOCKRATE         0x00030002
#define VCPROPTAG_SET_CLOCKRATE         0x00038002
#define VCPROPTAG_GET_MIN_CLOCKRATE     0x00030007
#define VCPROPTAG_GET_MAX_CLOCKRATE     0x00030004
#define VCPROPTAG_GET_TURBO             0x00030009
#define VCPROPTAG_SET_TURBO             0x00038009

#define VCPROPTAG_GET_STC               0x0003000b
#define VCPROPTAG_GET_THROTTLED         0x00030046
#define VCPROPTAG_GET_CLOCK_MEASURED    0x00030047
#define VCPROPTAG_NOTIFY_REBOOT         0x00030048

#define VCPROPTAG_GET_VOLTAGE           0x00030003
#define VCPROPTAG_SET_VOLTAGE           0x00038003
#define VCPROPTAG_GET_MIN_VOLTAGE       0x00030008
#define VCPROPTAG_GET_MAX_VOLTAGE       0x00030005

#define VCPROPTAG_GET_TEMPERATURE       0x00030006
#define VCPROPTAG_GET_MAX_TEMPERATURE   0x0003000a

#define VCPROPTAG_GET_DOMAIN_STATE      0x00030030
#define VCPROPTAG_SET_DOMAIN_STATE      0x00038030

#define VCPROPTAG_GET_GPIO_STATE        0x00030041
#define VCPROPTAG_SET_GPIO_STATE        0x00038041
#define VCPROPTAG_GET_GPIO_CONFIG       0x00030041
#define VCPROPTAG_SET_GPIO_CONFIG       0x00038041
#define VCPROPTAG_GET_PERIPH_REG        0x00030045
#define VCPROPTAG_SET_PERIPH_REG        0x00038045

#define VCPROPTAG_GET_OTP               0x00030021
#define VCPROPTAG_SET_OTP               0x00038021

#define VCPROPTAG_SET_SDHOST_CLOCK      0x00038042

#define VCPROPTAG_GET_POE_HAT_VAL       0x00030049
#define VCPROPTAG_SET_POE_HAT_VAL       0x00030050

#define VCPROPTAG_NOTIFY_XHCI_RESET     0x00030058

#define VCPROPTAG_GET_CMDLINE           0x00050001
#define VCPROPTAG_GET_DMACHAN           0x00060001

#define VCPROPTAG_ALLOCATE_BUFFER       0x00040001
#define VCPROPTAG_RELEASE_BUFFER        0x00048001
#define VCPROPTAG_BLANK_SCREEN          0x00040002
#define VCPROPTAG_GET_FB_RES            0x00040003
#define VCPROPTAG_TST_FB_RES            0x00044003
#define VCPROPTAG_SET_FB_RES            0x00048003
#define VCPROPTAG_GET_FB_VRES           0x00040004
#define VCPROPTAG_TST_FB_VRES           0x00044004
#define VCPROPTAG_SET_FB_VRES           0x00048004
#define VCPROPTAG_GET_FB_DEPTH          0x00040005
#define VCPROPTAG_TST_FB_DEPTH          0x00044005
#define VCPROPTAG_SET_FB_DEPTH          0x00048005
#define VCPROPTAG_GET_FB_PIXEL_ORDER    0x00040006
#define VCPROPTAG_TST_FB_PIXEL_ORDER    0x00044006
#define VCPROPTAG_SET_FB_PIXEL_ORDER    0x00048006
#define VCPROPTAG_GET_FB_ALPHA_MODE     0x00040007
#define VCPROPTAG_TST_FB_ALPHA_MODE     0x00044007
#define VCPROPTAG_SET_FB_ALPHA_MODE     0x00048007
#define VCPROPTAG_GET_FB_PITCH          0x00040008
#define VCPROPTAG_GET_VIRTUAL_OFFSET    0x00040009
#define VCPROPTAG_TST_VIRTUAL_OFFSET    0x00044009
#define VCPROPTAG_SET_VIRTUAL_OFFSET    0x00048009
#define VCPROPTAG_GET_OVERSCAN          0x0004000a
#define VCPROPTAG_TST_OVERSCAN          0x0004400a
#define VCPROPTAG_SET_OVERSCAN          0x0004800a
#define VCPROPTAG_GET_PALETTE           0x0004000b
#define VCPROPTAG_TST_PALETTE           0x0004400b
#define VCPROPTAG_SET_PALETTE           0x0004800b
#define VCPROPTAG_GET_FB_LAYER          0x0004000c
#define VCPROPTAG_TST_FB_LAYER          0x0004400c
#define VCPROPTAG_SET_FB_LAYER          0x0004800c
#define VCPROPTAG_GET_TRANSFORM         0x0004000d
#define VCPROPTAG_TST_TRANSFORM         0x0004400d
#define VCPROPTAG_SET_TRANSFORM         0x0004800d
#define VCPROPTAG_GET_VSYNC             0x0004000e
#define VCPROPTAG_TST_VSYNC             0x0004400e
#define VCPROPTAG_SET_VSYNC             0x0004800e
#define VCPROPTAG_GET_TOUCHBUF          0x0004000f
#define VCPROPTAG_GET_SET_BACKLIGHT     0x0004800f
#define VCPROPTAG_GET_GPIOVIRTBUF       0x00040010
#define VCPROPTAG_SET_GPIOVIRTBUF       0x00048020
#define VCPROPTAG_GET_NUM_DISPLAYS      0x00040013
#define VCPROPTAG_SET_DISPLAYNUM        0x00048013
#define VCPROPTAG_GET_DISPLAY_SETTINGS  0x00040014
#define VCPROPTAG_GET_DISPLAYID         0x00040016

#define VCPROPTAG_VCHIQ_INIT            0x00048010

#define VCPROPTAG_SET_PLANE             0x00048015
#define VCPROPTAG_GET_TIMING            0x00040017
#define VCPROPTAG_SET_TIMING            0x00048017
#define VCPROPTAG_GET_DISPLAY_CFG       0x00048018

#define VCPROPTAG_GET_EDID_BLOCK        0x00030020
#define VCPROPTAG_GET_EDID_BLOCK_DISP   0x00030021

#define VCPROPTAG_ALLOCMEM              0x0003000c
#define VCPROPTAG_LOCKMEM               0x0003000d
#define VCPROPTAG_UNLOCKMEM             0x0003000e
#define VCPROPTAG_RELEASEMEM            0x0003000f
#define VCPROPTAG_EXECUTE_CODE          0x00030010
#define VCPROPTAG_EXECUTE_QPU           0x00030011
#define VCPROPTAG_SET_ENABLE_QPU        0x00030012
#define VCPROPTAG_GET_DISPMANX_HANDLE   0x00030014

#define VCPROPTAG_SET_CURSOR_INFO       0x00008010
#define VCPROPTAG_SET_CURSOR_STATE      0x00008011

       uint32_t vpt_len;
       uint32_t vpt_rcode;
#define VCPROPTAG_REQUEST       (0U << 31)
#define VCPROPTAG_RESPONSE      (1U << 31)

};

#define VCPROPTAG_LEN(x) (sizeof((x)) - sizeof(struct vcprop_tag))

#define VCPROP_INIT_REQUEST(req)                                        \
       do {                                                            \
               memset(&(req), 0, sizeof((req)));                       \
               (req).vb_hdr.vpb_len = htole32(sizeof((req)));          \
               (req).vb_hdr.vpb_rcode = htole32(VCPROP_PROCESS_REQUEST);\
               (req).end.vpt_tag = htole32(VCPROPTAG_NULL);                    \
       } while (0)
#define VCPROP_INIT_TAG(s, t)                                           \
       do {                                                            \
               (s).tag.vpt_tag = htole32(t);                           \
               (s).tag.vpt_rcode = htole32(VCPROPTAG_REQUEST);         \
               (s).tag.vpt_len = htole32(VCPROPTAG_LEN(s));            \
       } while (0)

struct vcprop_memory {
       uint32_t base;
       uint32_t size;
};

#define VCPROP_MAXMEMBLOCKS 4
struct vcprop_tag_memory {
       struct vcprop_tag tag;
       struct vcprop_memory mem[VCPROP_MAXMEMBLOCKS];
};

struct vcprop_tag_fwrev {
       struct vcprop_tag tag;
       uint32_t rev;
};

struct vcprop_tag_boardmodel {
       struct vcprop_tag tag;
       uint32_t model;
};

struct vcprop_tag_boardrev {
       struct vcprop_tag tag;
       uint32_t rev;
};

#define VCPROP_REV_PCBREV       __BITS(3,0)
#define VCPROP_REV_MODEL        __BITS(11,4)
#define  RPI_MODEL_A            0
#define  RPI_MODEL_B            1
#define  RPI_MODEL_A_PLUS       2
#define  RPI_MODEL_B_PLUS       3
#define  RPI_MODEL_B_PI2        4
#define  RPI_MODEL_ALPHA        5
#define  RPI_MODEL_COMPUTE      6
#define  RPI_MODEL_B_PI3        8
#define  RPI_MODEL_ZERO         9
#define  RPI_MODEL_COMPUTE_PI3  10
#define  RPI_MODEL_ZERO_W       12
#define  RPI_MODEL_B_PLUS_PI3   13
#define  RPI_MODEL_A_PLUS_PI3   14
#define  RPI_MODEL_CM_PLUS_PI3  16
#define  RPI_MODEL_B_PI4        17
#define VCPROP_REV_PROCESSOR    __BITS(15,12)
#define  RPI_PROCESSOR_BCM2835  0
#define  RPI_PROCESSOR_BCM2836  1
#define  RPI_PROCESSOR_BCM2837  2
#define  RPI_PROCESSOR_BCM2711  3
#define VCPROP_REV_MANUF        __BITS(19,16)
#define  RPI_MANUF_SONY         0
#define  RPI_MANUF_EGOMAN       1
#define  RPI_MANUF_QISDA        16
#define  RPI_MANUF_EMBEST       2
#define  RPI_MANUF_SONYJAPAN    3
#define VCPROP_REV_MEMSIZE      __BITS(22,20)
#define  RPI_MEMSIZE_256        0
#define  RPI_MEMSIZE_512        1
#define  RPI_MEMSIZE_1024       2
#define  RPI_MEMSIZE_2048       3
#define  RPI_MEMSIZE_4096       4
#define VCPROP_REV_ENCFLAG      __BIT(23)
#define VCPROP_REV_WARRANTY     __BITS(25,24)

struct vcprop_tag_macaddr {
       struct vcprop_tag tag;
       uint64_t addr;
} __packed;

struct vcprop_tag_boardserial {
       struct vcprop_tag tag;
       uint64_t sn;
} __packed;

#define VCPROP_CLK_EMMC         1
#define VCPROP_CLK_UART         2
#define VCPROP_CLK_ARM          3
#define VCPROP_CLK_CORE         4
#define VCPROP_CLK_V3D          5
#define VCPROP_CLK_H264         6
#define VCPROP_CLK_ISP          7
#define VCPROP_CLK_SDRAM        8
#define VCPROP_CLK_PIXEL        9
#define VCPROP_CLK_PWM          10
#define VCPROP_CLK_EMMC2        12

struct vcprop_clock {
       uint32_t pclk;
       uint32_t cclk;
};

#define VCPROP_MAXCLOCKS 16
struct vcprop_tag_clock {
       struct vcprop_tag tag;
       struct vcprop_clock clk[VCPROP_MAXCLOCKS];
};

#ifndef VCPROP_MAXCMDLINE
#define VCPROP_MAXCMDLINE 1024
#endif
struct vcprop_tag_cmdline {
       struct vcprop_tag tag;
       uint8_t cmdline[VCPROP_MAXCMDLINE];
};

struct vcprop_tag_dmachan {
       struct vcprop_tag tag;
       uint32_t mask;
};

struct vcprop_tag_clockstate {
       struct vcprop_tag tag;
       uint32_t id;
       uint32_t state;
};

struct vcprop_tag_clockrate {
       struct vcprop_tag tag;
       uint32_t id;
       uint32_t rate;
       uint32_t noturbo;
};

struct vcprop_tag_sdhostclock {
       struct vcprop_tag tag;
       uint32_t clock;
       uint32_t clock1;
       uint32_t clock2;
};

#define VCPROP_VOLTAGE_CORE     1
#define VCPROP_VOLTAGE_SDRAM_C  2
#define VCPROP_VOLTAGE_SDRAM_P  3
#define VCPROP_VOLTAGE_SDRAM_I  4

struct vcprop_tag_voltage {
       struct vcprop_tag tag;
       uint32_t id;
       uint32_t value;
};

#define VCPROP_TEMP_SOC         0

struct vcprop_tag_temperature {
       struct vcprop_tag tag;
       uint32_t id;
       uint32_t value;
};

#define VCPROP_POWER_SDCARD     0
#define VCPROP_POWER_UART0      1
#define VCPROP_POWER_UART1      2
#define VCPROP_POWER_USB        3
#define VCPROP_POWER_I2C0       4
#define VCPROP_POWER_I2C1       5
#define VCPROP_POWER_I2C2       6
#define VCPROP_POWER_SPI        7
#define VCPROP_POWER_CCP2TX     8

#define VCPROP_DOMAIN_I2C0           1
#define VCPROP_DOMAIN_I2C1           2
#define VCPROP_DOMAIN_I2C2           3
#define VCPROP_DOMAIN_VIDEO_SCALER   4
#define VCPROP_DOMAIN_VPU1           5
#define VCPROP_DOMAIN_HDMI           6
#define VCPROP_DOMAIN_USB            7
#define VCPROP_DOMAIN_VEC            8
#define VCPROP_DOMAIN_JPEG           9
#define VCPROP_DOMAIN_H264           10
#define VCPROP_DOMAIN_V3D            11
#define VCPROP_DOMAIN_ISP            12
#define VCPROP_DOMAIN_UNICAM0        13
#define VCPROP_DOMAIN_UNICAM1        14
#define VCPROP_DOMAIN_CCP2RX         15
#define VCPROP_DOMAIN_CSI2           16
#define VCPROP_DOMAIN_CPI            17
#define VCPROP_DOMAIN_DSI0           18
#define VCPROP_DOMAIN_DSI1           19
#define VCPROP_DOMAIN_TRANSPOSER     20
#define VCPROP_DOMAIN_CCP2TX         21
#define VCPROP_DOMAIN_CDP            22
#define VCPROP_DOMAIN_ARM            23

struct vcprop_tag_powertiming {
       struct vcprop_tag tag;
       uint32_t id;
       uint32_t waitusec;
};

struct vcprop_tag_powerstate {
       struct vcprop_tag tag;
       uint32_t id;
       uint32_t state;
};

struct vcprop_tag_allocbuf {
       struct vcprop_tag tag;
       uint32_t address;       /* alignment for request */
       uint32_t size;
};

#define VCPROP_BLANK_OFF        0
#define VCPROP_BLANK_ON         1

struct vcprop_tag_blankscreen {
       struct vcprop_tag tag;
       uint32_t state;
};

struct vcprop_tag_fbres {
       struct vcprop_tag tag;
       uint32_t width;
       uint32_t height;
};

struct vcprop_tag_fbdepth {
       struct vcprop_tag tag;
       uint32_t bpp;
};

#define VCPROP_PIXEL_BGR        0
#define VCPROP_PIXEL_RGB        1

struct vcprop_tag_fbpixelorder {
       struct vcprop_tag tag;
       uint32_t order;
};

struct vcprop_tag_fbpitch {
       struct vcprop_tag tag;
       uint32_t linebytes;
};

#define VCPROP_ALPHA_ENABLED    0
#define VCPROP_ALPHA_REVERSED   1
#define VCPROP_ALPHA_IGNORED    2

struct vcprop_tag_fbalpha {
       struct vcprop_tag tag;
       uint32_t state;
};

struct vcprop_tag_edidblock {
       struct vcprop_tag tag;
       uint32_t blockno;
       uint32_t status;
       uint8_t data[128];
};

struct vcprop_tag_numdpy {
       struct vcprop_tag tag;
       uint32_t count;
};

struct vcprop_tag_setdpy {
       struct vcprop_tag tag;
       uint32_t display_num;
};

struct vcprop_tag_cursorinfo {
       struct vcprop_tag tag;
       uint32_t width;
       uint32_t height;
       uint32_t format;
       uint32_t pixels;        /* bus address in VC memory */
       uint32_t hotspot_x;
       uint32_t hotspot_y;
};

struct vcprop_tag_cursorstate {
       struct vcprop_tag tag;
       uint32_t enable;        /* 1 - visible */
       uint32_t x;
       uint32_t y;
       uint32_t flags;         /* 0 - display coord. 1 - fb coord. */
};

struct vcprop_tag_allocmem {
       struct vcprop_tag tag;
       uint32_t size;  /* handle returned here */
       uint32_t align;
       uint32_t flags;
/*
* flag definitions from
* https://github.com/raspberrypi/firmware/wiki/Mailbox-property-interface
*/
#define MEM_FLAG_DISCARDABLE    (1 << 0) /* can be resized to 0 at any time. Use for cached data */
#define MEM_FLAG_NORMAL         (0 << 2) /* normal allocating alias. Don't use from ARM */
#define MEM_FLAG_DIRECT         (1 << 2) /* 0xC alias uncached */
#define MEM_FLAG_COHERENT       (2 << 2) /* 0x8 alias. Non-allocating in L2 but coherent */
#define MEM_FLAG_L1_NONALLOCATING (MEM_FLAG_DIRECT | MEM_FLAG_COHERENT) /* Allocating in L2 */
#define MEM_FLAG_ZERO           (1 << 4)  /* initialise buffer to all zeros */
#define MEM_FLAG_NO_INIT        (1 << 5) /* don't initialise (default is initialise to all ones */
#define MEM_FLAG_HINT_PERMALOCK (1 << 6) /* Likely to be locked for long periods of time. */
};

/* also for unlock and release */
struct vcprop_tag_lockmem {
       struct vcprop_tag tag;
       uint32_t handle;        /* bus address returned here */
};

struct vcprop_tag_vchiqinit {
       struct vcprop_tag tag;
       uint32_t base;
};

struct vcprop_tag_notifyxhcireset {
       struct vcprop_tag tag;
       uint32_t deviceaddress;
};

struct vcprop_buffer_hdr {
       uint32_t vpb_len;
       uint32_t vpb_rcode;
#define VCPROP_PROCESS_REQUEST 0
#define VCPROP_REQ_SUCCESS      (1U << 31)
#define VCPROP_REQ_EPARSE       (1U << 0)
};

static inline bool
vcprop_buffer_success_p(struct vcprop_buffer_hdr *vpbh)
{

       return le32toh(vpbh->vpb_rcode) & VCPROP_REQ_SUCCESS;
}

static inline bool
vcprop_tag_success_p(struct vcprop_tag *vpbt)
{

       return le32toh(vpbt->vpt_rcode) & VCPROPTAG_RESPONSE;
}

static inline size_t
vcprop_tag_resplen(struct vcprop_tag *vpbt)
{

       return le32toh(vpbt->vpt_rcode) & ~VCPROPTAG_RESPONSE;
}

uint32_t rpi_alloc_mem(uint32_t, uint32_t, uint32_t);
bus_addr_t rpi_lock_mem(uint32_t);
int rpi_unlock_mem(uint32_t);
int rpi_release_mem(uint32_t);

int rpi_fb_set_video(int);

int rpi_fb_movecursor(int, int, int);
int rpi_fb_initcursor(bus_addr_t, int, int);

int rpi_fb_set_pixelorder(uint32_t);
int rpi_fb_get_pixelorder(uint32_t *);

int rpi_set_domain(uint32_t, uint32_t);
int rpi_get_domain(uint32_t, uint32_t *);

int rpi_vchiq_init(uint32_t *);

int rpi_notify_xhci_reset(uint32_t);

#endif  /* _EVBARM_RPI_VCPROP_H_ */