root/drivers/video/fbdev/sticore.h

/* [<][>][^][v][top][bottom][index][help] */

INCLUDED FROM


   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef STICORE_H
   3 #define STICORE_H
   4 
   5 /* generic STI structures & functions */
   6 
   7 #if 0
   8 #define DPRINTK(x)      printk x
   9 #else
  10 #define DPRINTK(x) 
  11 #endif
  12 
  13 #define MAX_STI_ROMS 4          /* max no. of ROMs which this driver handles */
  14 
  15 #define STI_REGION_MAX 8        /* hardcoded STI constants */
  16 #define STI_DEV_NAME_LENGTH 32
  17 #define STI_MONITOR_MAX 256
  18 
  19 #define STI_FONT_HPROMAN8 1
  20 #define STI_FONT_KANA8 2
  21 
  22 #define ALT_CODE_TYPE_UNKNOWN 0x00      /* alt code type values */
  23 #define ALT_CODE_TYPE_PA_RISC_64 0x01
  24 
  25 /* The latency of the STI functions cannot really be reduced by setting
  26  * this to 0;  STI doesn't seem to be designed to allow calling a different
  27  * function (or the same function with different arguments) after a
  28  * function exited with 1 as return value.
  29  *
  30  * As all of the functions below could be called from interrupt context,
  31  * we have to spin_lock_irqsave around the do { ret = bla(); } while(ret==1)
  32  * block.  Really bad latency there.
  33  *
  34  * Probably the best solution to all this is have the generic code manage
  35  * the screen buffer and a kernel thread to call STI occasionally.
  36  * 
  37  * Luckily, the frame buffer guys have the same problem so we can just wait
  38  * for them to fix it and steal their solution.   prumpf
  39  */
  40  
  41 #include <asm/io.h>
  42 
  43 #define STI_WAIT 1
  44 
  45 #define STI_PTR(p)      ( virt_to_phys(p) )
  46 #define PTR_STI(p)      ( phys_to_virt((unsigned long)p) )
  47 
  48 #define sti_onscreen_x(sti) (sti->glob_cfg->onscreen_x)
  49 #define sti_onscreen_y(sti) (sti->glob_cfg->onscreen_y)
  50 
  51 /* sti_font_xy() use the native font ROM ! */
  52 #define sti_font_x(sti) (PTR_STI(sti->font)->width)
  53 #define sti_font_y(sti) (PTR_STI(sti->font)->height)
  54 
  55 #ifdef CONFIG_64BIT
  56 #define STI_LOWMEM      (GFP_KERNEL | GFP_DMA)
  57 #else
  58 #define STI_LOWMEM      (GFP_KERNEL)
  59 #endif
  60 
  61 
  62 /* STI function configuration structs */
  63 
  64 typedef union region {
  65         struct { 
  66                 u32 offset      : 14;   /* offset in 4kbyte page */
  67                 u32 sys_only    : 1;    /* don't map to user space */
  68                 u32 cache       : 1;    /* map to data cache */
  69                 u32 btlb        : 1;    /* map to block tlb */
  70                 u32 last        : 1;    /* last region in list */
  71                 u32 length      : 14;   /* length in 4kbyte page */
  72         } region_desc;
  73 
  74         u32 region;                     /* complete region value */
  75 } region_t;
  76 
  77 #define REGION_OFFSET_TO_PHYS( rt, hpa ) \
  78         (((rt).region_desc.offset << 12) + (hpa))
  79 
  80 struct sti_glob_cfg_ext {
  81          u8 curr_mon;                   /* current monitor configured */
  82          u8 friendly_boot;              /* in friendly boot mode */
  83         s16 power;                      /* power calculation (in Watts) */
  84         s32 freq_ref;                   /* frequency reference */
  85         u32 sti_mem_addr;               /* pointer to global sti memory (size=sti_mem_request) */
  86         u32 future_ptr;                 /* pointer to future data */
  87 };
  88 
  89 struct sti_glob_cfg {
  90         s32 text_planes;                /* number of planes used for text */
  91         s16 onscreen_x;                 /* screen width in pixels */
  92         s16 onscreen_y;                 /* screen height in pixels */
  93         s16 offscreen_x;                /* offset width in pixels */
  94         s16 offscreen_y;                /* offset height in pixels */
  95         s16 total_x;                    /* frame buffer width in pixels */
  96         s16 total_y;                    /* frame buffer height in pixels */
  97         u32 region_ptrs[STI_REGION_MAX]; /* region pointers */
  98         s32 reent_lvl;                  /* storage for reentry level value */
  99         u32 save_addr;                  /* where to save or restore reentrant state */
 100         u32 ext_ptr;                    /* pointer to extended glob_cfg data structure */
 101 };
 102 
 103 
 104 /* STI init function structs */
 105 
 106 struct sti_init_flags {
 107         u32 wait : 1;           /* should routine idle wait or not */
 108         u32 reset : 1;          /* hard reset the device? */
 109         u32 text : 1;           /* turn on text display planes? */
 110         u32 nontext : 1;        /* turn on non-text display planes? */
 111         u32 clear : 1;          /* clear text display planes? */
 112         u32 cmap_blk : 1;       /* non-text planes cmap black? */
 113         u32 enable_be_timer : 1; /* enable bus error timer */
 114         u32 enable_be_int : 1;  /* enable bus error timer interrupt */
 115         u32 no_chg_tx : 1;      /* don't change text settings */
 116         u32 no_chg_ntx : 1;     /* don't change non-text settings */
 117         u32 no_chg_bet : 1;     /* don't change berr timer settings */
 118         u32 no_chg_bei : 1;     /* don't change berr int settings */
 119         u32 init_cmap_tx : 1;   /* initialize cmap for text planes */
 120         u32 cmt_chg : 1;        /* change current monitor type */
 121         u32 retain_ie : 1;      /* don't allow reset to clear int enables */
 122         u32 caller_bootrom : 1; /* set only by bootrom for each call */
 123         u32 caller_kernel : 1;  /* set only by kernel for each call */
 124         u32 caller_other : 1;   /* set only by non-[BR/K] caller */
 125         u32 pad : 14;           /* pad to word boundary */
 126         u32 future_ptr;         /* pointer to future data */
 127 };
 128 
 129 struct sti_init_inptr_ext {
 130         u8  config_mon_type;    /* configure to monitor type */
 131         u8  pad[1];             /* pad to word boundary */
 132         u16 inflight_data;      /* inflight data possible on PCI */
 133         u32 future_ptr;         /* pointer to future data */
 134 };
 135 
 136 struct sti_init_inptr {
 137         s32 text_planes;        /* number of planes to use for text */
 138         u32 ext_ptr;            /* pointer to extended init_graph inptr data structure*/
 139 };
 140 
 141 
 142 struct sti_init_outptr {
 143         s32 errno;              /* error number on failure */
 144         s32 text_planes;        /* number of planes used for text */
 145         u32 future_ptr;         /* pointer to future data */
 146 };
 147 
 148 
 149 
 150 /* STI configuration function structs */
 151 
 152 struct sti_conf_flags {
 153         u32 wait : 1;           /* should routine idle wait or not */
 154         u32 pad : 31;           /* pad to word boundary */
 155         u32 future_ptr;         /* pointer to future data */
 156 };
 157 
 158 struct sti_conf_inptr {
 159         u32 future_ptr;         /* pointer to future data */
 160 };
 161 
 162 struct sti_conf_outptr_ext {
 163         u32 crt_config[3];      /* hardware specific X11/OGL information */     
 164         u32 crt_hdw[3];
 165         u32 future_ptr;
 166 };
 167 
 168 struct sti_conf_outptr {
 169         s32 errno;              /* error number on failure */
 170         s16 onscreen_x;         /* screen width in pixels */
 171         s16 onscreen_y;         /* screen height in pixels */
 172         s16 offscreen_x;        /* offscreen width in pixels */
 173         s16 offscreen_y;        /* offscreen height in pixels */
 174         s16 total_x;            /* frame buffer width in pixels */
 175         s16 total_y;            /* frame buffer height in pixels */
 176         s32 bits_per_pixel;     /* bits/pixel device has configured */
 177         s32 bits_used;          /* bits which can be accessed */
 178         s32 planes;             /* number of fb planes in system */
 179          u8 dev_name[STI_DEV_NAME_LENGTH]; /* null terminated product name */
 180         u32 attributes;         /* flags denoting attributes */
 181         u32 ext_ptr;            /* pointer to future data */
 182 };
 183 
 184 struct sti_rom {
 185          u8 type[4];
 186          u8 res004;
 187          u8 num_mons;
 188          u8 revno[2];
 189         u32 graphics_id[2];
 190 
 191         u32 font_start;
 192         u32 statesize;
 193         u32 last_addr;
 194         u32 region_list;
 195 
 196         u16 reentsize;
 197         u16 maxtime;
 198         u32 mon_tbl_addr;
 199         u32 user_data_addr;
 200         u32 sti_mem_req;
 201 
 202         u32 user_data_size;
 203         u16 power;
 204          u8 bus_support;
 205          u8 ext_bus_support;
 206          u8 alt_code_type;
 207          u8 ext_dd_struct[3];
 208         u32 cfb_addr;
 209 
 210         u32 init_graph;
 211         u32 state_mgmt;
 212         u32 font_unpmv;
 213         u32 block_move;
 214         u32 self_test;
 215         u32 excep_hdlr;
 216         u32 inq_conf;
 217         u32 set_cm_entry;
 218         u32 dma_ctrl;
 219          u8 res040[7 * 4];
 220         
 221         u32 init_graph_addr;
 222         u32 state_mgmt_addr;
 223         u32 font_unp_addr;
 224         u32 block_move_addr;
 225         u32 self_test_addr;
 226         u32 excep_hdlr_addr;
 227         u32 inq_conf_addr;
 228         u32 set_cm_entry_addr;
 229         u32 image_unpack_addr;
 230         u32 pa_risx_addrs[7];
 231 };
 232 
 233 struct sti_rom_font {
 234         u16 first_char;
 235         u16 last_char;
 236          u8 width;
 237          u8 height;
 238          u8 font_type;          /* language type */
 239          u8 bytes_per_char;
 240         u32 next_font;
 241          u8 underline_height;
 242          u8 underline_pos;
 243          u8 res008[2];
 244 };
 245 
 246 /* sticore internal font handling */
 247 
 248 struct sti_cooked_font {
 249         struct sti_rom_font *raw;
 250         struct sti_cooked_font *next_font;
 251 };
 252 
 253 struct sti_cooked_rom {
 254         struct sti_rom *raw;
 255         struct sti_cooked_font *font_start;
 256 };
 257 
 258 /* STI font printing function structs */
 259 
 260 struct sti_font_inptr {
 261         u32 font_start_addr;    /* address of font start */
 262         s16 index;              /* index into font table of character */
 263         u8 fg_color;            /* foreground color of character */
 264         u8 bg_color;            /* background color of character */
 265         s16 dest_x;             /* X location of character upper left */
 266         s16 dest_y;             /* Y location of character upper left */
 267         u32 future_ptr;         /* pointer to future data */
 268 };
 269 
 270 struct sti_font_flags {
 271         u32 wait : 1;           /* should routine idle wait or not */
 272         u32 non_text : 1;       /* font unpack/move in non_text planes =1, text =0 */
 273         u32 pad : 30;           /* pad to word boundary */
 274         u32 future_ptr;         /* pointer to future data */
 275 };
 276         
 277 struct sti_font_outptr {
 278         s32 errno;              /* error number on failure */
 279         u32 future_ptr;         /* pointer to future data */
 280 };
 281 
 282 /* STI blockmove structs */
 283 
 284 struct sti_blkmv_flags {
 285         u32 wait : 1;           /* should routine idle wait or not */
 286         u32 color : 1;          /* change color during move? */
 287         u32 clear : 1;          /* clear during move? */
 288         u32 non_text : 1;       /* block move in non_text planes =1, text =0 */
 289         u32 pad : 28;           /* pad to word boundary */
 290         u32 future_ptr;         /* pointer to future data */
 291 };
 292 
 293 struct sti_blkmv_inptr {
 294         u8 fg_color;            /* foreground color after move */
 295         u8 bg_color;            /* background color after move */
 296         s16 src_x;              /* source upper left pixel x location */
 297         s16 src_y;              /* source upper left pixel y location */
 298         s16 dest_x;             /* dest upper left pixel x location */
 299         s16 dest_y;             /* dest upper left pixel y location */
 300         s16 width;              /* block width in pixels */
 301         s16 height;             /* block height in pixels */
 302         u32 future_ptr;         /* pointer to future data */
 303 };
 304 
 305 struct sti_blkmv_outptr {
 306         s32 errno;              /* error number on failure */
 307         u32 future_ptr;         /* pointer to future data */
 308 };
 309 
 310 
 311 /* sti_all_data is an internal struct which needs to be allocated in
 312  * low memory (< 4GB) if STI is used with 32bit STI on a 64bit kernel */
 313 
 314 struct sti_all_data {
 315         struct sti_glob_cfg glob_cfg;
 316         struct sti_glob_cfg_ext glob_cfg_ext;
 317 
 318         struct sti_conf_inptr           inq_inptr;
 319         struct sti_conf_outptr          inq_outptr; /* configuration */
 320         struct sti_conf_outptr_ext      inq_outptr_ext;
 321 
 322         struct sti_init_inptr_ext       init_inptr_ext;
 323         struct sti_init_inptr           init_inptr;
 324         struct sti_init_outptr          init_outptr;
 325 
 326         struct sti_blkmv_inptr          blkmv_inptr;
 327         struct sti_blkmv_outptr         blkmv_outptr;
 328 
 329         struct sti_font_inptr           font_inptr;
 330         struct sti_font_outptr          font_outptr;
 331 
 332         /* leave as last entries */
 333         unsigned long save_addr[1024 / sizeof(unsigned long)];
 334            /* min 256 bytes which is STI default, max sti->sti_mem_request */
 335         unsigned long sti_mem_addr[256 / sizeof(unsigned long)];
 336         /* do not add something below here ! */
 337 };
 338 
 339 /* internal generic STI struct */
 340 
 341 struct sti_struct {
 342         spinlock_t lock;
 343                 
 344         /* the following fields needs to be filled in by the word/byte routines */
 345         int font_width; 
 346         int font_height;
 347         /* char **mon_strings; */
 348         int sti_mem_request;
 349         u32 graphics_id[2];
 350 
 351         struct sti_cooked_rom *rom;
 352 
 353         unsigned long font_unpmv;
 354         unsigned long block_move;
 355         unsigned long init_graph;
 356         unsigned long inq_conf;
 357 
 358         /* all following fields are initialized by the generic routines */
 359         int text_planes;
 360         region_t regions[STI_REGION_MAX];
 361         unsigned long regions_phys[STI_REGION_MAX];
 362 
 363         struct sti_glob_cfg *glob_cfg;  /* points into sti_all_data */
 364 
 365         struct sti_cooked_font *font;   /* ptr to selected font (cooked) */
 366 
 367         struct pci_dev *pd;
 368 
 369         /* PCI data structures (pg. 17ff from sti.pdf) */
 370         u8 rm_entry[16]; /* pci region mapper array == pci config space offset */
 371 
 372         /* pointer to the fb_info where this STI device is used */
 373         struct fb_info *info;
 374 
 375         /* pointer to all internal data */
 376         struct sti_all_data *sti_data;
 377 };
 378 
 379 
 380 /* sticore interface functions */
 381 
 382 struct sti_struct *sti_get_rom(unsigned int index); /* 0: default sti */
 383 
 384 
 385 /* sticore main function to call STI firmware */
 386 
 387 int sti_call(const struct sti_struct *sti, unsigned long func,
 388                 const void *flags, void *inptr, void *outptr,
 389                 struct sti_glob_cfg *glob_cfg);
 390 
 391 
 392 /* functions to call the STI ROM directly */
 393 
 394 void sti_putc(struct sti_struct *sti, int c, int y, int x);
 395 void sti_set(struct sti_struct *sti, int src_y, int src_x,
 396              int height, int width, u8 color);
 397 void sti_clear(struct sti_struct *sti, int src_y, int src_x,
 398                int height, int width, int c);
 399 void sti_bmove(struct sti_struct *sti, int src_y, int src_x,
 400                int dst_y, int dst_x, int height, int width);
 401 
 402 #endif  /* STICORE_H */

/* [<][>][^][v][top][bottom][index][help] */