util.h

   1 /*-
   2  * Copyright (C) 2011, 2012 glevand <geoffrey.levand@mail.ru>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer,
  10  *    without modification, immediately at the beginning of the file.
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in the
  13  *    documentation and/or other materials provided with the distribution.
  14  *
  15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  *
  26  * $FreeBSD$
  27  */
  28
  29 #ifndef _UTIL_H
  30 #define _UTIL_H
  31
  32 #define ARRAY_SIZE(_a)          (sizeof(_a) / sizeof((_a)[0]))
  33 #define ROUNDUP(_x, _y)         ((((_x) + ((_y) - 1)) / (_y)) * (_y))
  34
  35 struct surface_desc {
  36         uint32_t sd_color_loc[4];
  37         uint32_t sd_color_off[4];
  38         uint32_t sd_color_pitch[4];
  39         uint8_t sd_color_fmt;
  40         uint8_t sd_color_target;
  41         uint32_t sd_depth_loc;
  42         uint32_t sd_depth_off;
  43         uint32_t sd_depth_pitch;
  44         uint8_t sd_depth_fmt;
  45         uint16_t sd_x;
  46         uint16_t sd_y;
  47         uint16_t sd_w;
  48         uint16_t sd_h;
  49 };
  50
  51 struct texture_desc {
  52         uint8_t td_loc;
  53         uint32_t td_off;
  54         uint32_t td_pitch;
  55         uint16_t td_w;
  56         uint16_t td_h;
  57         uint8_t td_fmt;
  58         uint8_t td_border;
  59         uint16_t td_depth;
  60         uint8_t td_dimension;
  61         uint8_t td_mipmap;
  62         uint8_t td_cubemap;
  63         uint32_t td_remap;
  64 };
  65
  66 static inline void
  67 memset32(void *buf, uint32_t val, int word_count)
  68 {
  69         uint32_t *ptr = buf;
  70
  71         while (word_count--)
  72                 *ptr++ = val;
  73 }
  74
  75 static inline uint32_t
  76 get_channel_id(const volatile void *driver_info)
  77 {
  78         return (*(uint32_t *) ((uint8_t *) driver_info + 0xc));
  79 }
  80
  81 static inline uint32_t
  82 get_label_area_offset(const volatile void *driver_info)
  83 {
  84         return (*(uint32_t *) ((uint8_t *) driver_info + 0x30));
  85 }
  86
  87 static inline uint32_t
  88 get_report_data_area_offset(const volatile void *driver_info)
  89 {
  90         return (*(uint32_t *) ((uint8_t *) driver_info + 0x34));
  91 }
  92
  93 static inline int
  94 get_flip_status(const volatile void *driver_info, uint8_t head)
  95 {
  96         uint32_t val;
  97
  98         val =  *(uint32_t *) ((uint8_t *) driver_info + 0x10c0 + head * 0x40);
  99
 100         return !(val >> 31);
 101 }
 102
 103 static inline int
 104 wait_fifo_idle(volatile uint32_t *control)
 105 {
 106         int count = 10000;
 107
 108         while (count--) {
 109                 if (control[0x10] == control[0x11])
 110                         break;
 111
 112                 usleep(100);
 113         }
 114
 115         if (control[0x10] != control[0x11])
 116                 return (-1);
 117
 118         return (0);
 119 }
 120
 121 static inline uint32_t *
 122 get_label_addr(const volatile void *driver_info, const volatile void *reports,
 123     uint32_t index)
 124 {
 125         return ((uint32_t *) ((uint8_t *) reports +
 126             get_label_area_offset(driver_info) + (index << 4)));
 127 }
 128
 129 static inline uint32_t
 130 get_label_value(const volatile void *driver_info, const volatile void *reports,
 131     uint32_t index)
 132 {
 133         uint32_t val;
 134
 135         val =  *get_label_addr(driver_info, reports, index);
 136
 137         return (val);
 138 }
 139
 140 static inline uint64_t *
 141 get_timestamp_addr(const volatile void *driver_info, const volatile void *reports,
 142     uint32_t index)
 143 {
 144         return ((uint64_t *) ((uint8_t *) reports +
 145             get_report_data_area_offset(driver_info) + (index << 4)));
 146 }
 147
 148 static inline uint64_t
 149 get_timestamp_value(const volatile void *driver_info, const volatile void *reports,
 150     uint32_t index)
 151 {
 152         uint64_t val;
 153
 154         val =  *get_timestamp_addr(driver_info, reports, index);
 155
 156         return (val);
 157 }
 158
 159 int setup_control(int fd, int context_id, unsigned long put, unsigned long get,
 160     unsigned int ref);
 161
 162 int memory_allocate(int fd, int context_id, int type, int size, int align,
 163     unsigned long *handle, unsigned int *gpu_addr, void **map);
 164
 165 int display_buffer_set(int fd, int context_id, int buffer_id, int width, int height,
 166     int pitch, unsigned long offset);
 167
 168 int set_flip_mode(int fd, int context_id, int head, int mode);
 169
 170 int reset_flip_status(int fd, int context_id, int head);
 171
 172 int flip(int fd, int context_id, int head, unsigned long offset);
 173
 174 uint32_t get_tiled_pitch_size(uint32_t pitch);
 175
 176 /*
 177  * How to convert image to JPG format:
 178  *
 179  * convert -depth 8 -size 1920x1080 rgba:image.argb \
 180  *      -channel All -separate -clone 0 -delete 0 -combine -channel BA \
 181  *      -negate +channel -background white -flatten image.jpg
 182  *
 183  * convert image.jpg -resize 640x480 image_small.jpg
 184  */
 185 int save_image(const char *filename, const char *buf, int len);
 186
 187 void dump_fifo(FILE *fp, const uint32_t *fifo, unsigned int word_count);
 188
 189 int set_reference(uint32_t *fifo, uint32_t val);
 190
 191 int transfer_data(uint32_t *fifo, uint32_t src, uint32_t dst,
 192     uint32_t dst_offset, int32_t dst_pitch,
 193     uint32_t src_offset, int32_t src_pitch,
 194     uint32_t row_length, uint32_t row_count);
 195
 196 int transfer_inline(uint32_t *fifo, uint32_t dst, uint32_t dst_offset,
 197     const uint32_t *data, uint32_t word_count);
 198
 199 int flip_display_buffer(uint32_t *fifo, uint8_t channel_id, uint8_t buffer_id,
 200     uint8_t head);
 201
 202 int set_depth_mask(uint32_t *fifo, uint32_t mask);
 203
 204 int set_color_mask(uint32_t *fifo, uint32_t mask);
 205
 206 int set_color_mask_mrt(uint32_t *fifo, uint32_t mask);
 207
 208 int set_clear_color(uint32_t *fifo, uint32_t color);
 209
 210 int set_scissor(uint32_t *fifo, uint16_t x, uint16_t y, uint16_t w, uint16_t h);
 211
 212 int set_front_poly_mode(uint32_t *fifo, uint32_t mode);
 213
 214 int set_shade_mode(uint32_t *fifo, uint32_t mode);
 215
 216 int blend_enable(uint32_t *fifo, uint32_t enable);
 217
 218 int clear_surface(uint32_t *fifo, uint32_t mask);
 219
 220 int set_surface(uint32_t *fifo, const struct surface_desc *sd);
 221
 222 int wait_label(uint32_t *fifo, uint32_t index, uint32_t val);
 223
 224 int write_label(uint32_t *fifo, uint32_t index, uint32_t val);
 225
 226 int write_backend_label(uint32_t *fifo, uint32_t index, uint32_t val);
 227
 228 int write_texture_label(uint32_t *fifo, uint32_t index, uint32_t val);
 229
 230 int set_viewport(uint32_t *fifo, uint16_t x, uint16_t y, uint16_t w, uint16_t h,
 231     float zmin, float zmax, const float offset[4], const float scale[4]);
 232
 233 int load_vertex_prg(uint32_t *fifo, uint16_t slot, const uint32_t *prg, int instr_count);
 234
 235 int set_vertex_prg_reg_count(uint32_t *fifo, unsigned int count);
 236
 237 int set_vertex_prg_start_slot(uint32_t *fifo, uint16_t slot);
 238
 239 int set_vertex_prg_const(uint32_t *fifo, uint32_t start, uint32_t count,
 240     const float *val);
 241
 242 /*
 243  *  0 ATTR0, POSITION Vertex (float4)
 244  *  1 ATTR1, BLENDWEIGHT Vertex weight (float)
 245  *  2 ATTR2, NORMAL Normal (float3)
 246  *  3 ATTR3, COLOR, COLOR0, DIFFUSE Color (float4)
 247  *  4 ATTR4, COLOR1, SPECULAR Secondary color (float4)
 248  *  5 ATTR5, FOGCOORD, TESSFACTOR Fog coordinate (float)
 249  *  6 ATTR6, PSIZE Point size (float)
 250  *  7 ATTR7, BLENDINDICES Palette index for skinning (float4)
 251  *  8 ATTR8, TEXCOORD0 Texture coordinate 0 (float4)
 252  *  9 ATTR9, TEXCOORD1 Texture coordinate 1 (float4)
 253  * 10 ATTR10, TEXCOORD2 Texture coordinate 2 (float4)
 254  * 11 ATTR11, TEXCOORD3 Texture coordinate 3 (float4)
 255  * 12 ATTR12, TEXCOORD4 Texture coordinate 4 (float4)
 256  * 13 ATTR13, TEXCOORD5 Texture coordinate 5 (float4)
 257  * 14 ATTR14, TEXCOORD6, TANGENT Texture coordinate 6 (float4) Tangent vector (float4)
 258  * 15 ATTR15, TEXCOORD7, BINORMAL Texture coordinate 7 (float4) Binormal vector (float4)
 259  */
 260 int set_vertex_attr_inmask(uint32_t *fifo, uint32_t mask);
 261
 262 /*
 263  *  0 COLOR, COLOR0, COL0 Front diffuse color
 264  *  1 COLOR1, COL1 Front specular color
 265  *  2 BCOL0 Back diffuse color
 266  *  3 BCOL1 Back specular color
 267  *  4 FOG, FOGC Fog
 268  *  5 PSIZE, PSIZ Point size
 269  *  6 CLP0 User clip plane 0
 270  *  7 CLP1 User clip plane 1
 271  *  8 CLP2 User clip plane 2
 272  *  9 CLP3 User clip plane 3
 273  * 10 CLP4 User clip plane 4
 274  * 11 CLP5 User clip plane 5
 275  * 12 TEXCOORD8, TEX8 Texture coordinate 8
 276  * 13 TEXCOORD9, TEX9 Texture coordinate 9
 277  * 14 TEXCOORD0, TEX0 Texture coordinate 0
 278  * 15 TEXCOORD1, TEX1 Texture coordinate 1
 279  * 16 TEXCOORD2, TEX2 Texture coordinate 2
 280  * 17 TEXCOORD3, TEX3 Texture coordinate 3
 281  * 18 TEXCOORD4, TEX4 Texture coordinate 4
 282  * 19 TEXCOORD5, TEX5 Texture coordinate 5
 283  * 20 TEXCOORD6, TEX6 Texture coordinate 6
 284  * 21 TEXCOORD7, TEX7 Texture coordinate 7
 285  */
 286 int set_vertex_attr_outmask(uint32_t *fifo, uint32_t mask);
 287
 288 int set_frag_prg(uint32_t *fifo, uint8_t location, uint32_t offset);
 289
 290 int frag_prg_ctrl(uint32_t *fifo, uint8_t reg_count, uint8_t replace_txp_with_tex,
 291     uint8_t pixel_kill, uint8_t output_from_h0, uint8_t depth_replace);
 292
 293 int draw_begin(uint32_t *fifo, uint32_t mode);
 294
 295 int draw_end(uint32_t *fifo);
 296
 297 int set_vertex_data_arrfmt(uint32_t *fifo, uint8_t reg, uint16_t freq,
 298     uint8_t stride, uint8_t size, uint8_t type);
 299
 300 int set_vertex_data_2f(uint32_t *fifo, uint8_t reg, const float val[2]);
 301
 302 int set_vertex_data_4f(uint32_t *fifo, uint8_t reg, const float val[4]);
 303
 304 int set_vertex_data_arr(uint32_t *fifo, uint8_t reg,
 305     uint16_t freq, uint8_t stride, uint8_t size, uint8_t type,
 306     uint8_t location, uint32_t offset);
 307
 308 int draw_arrays(uint32_t *fifo, uint32_t mode, uint32_t first, uint32_t count);
 309
 310 int invalidate_vertex_cache(uint32_t *fifo);
 311
 312 int set_texture(uint32_t *fifo, uint8_t index, const struct texture_desc *td);
 313
 314 int texture_ctrl(uint32_t *fifo, uint8_t index, uint8_t enable,
 315     uint16_t min_lod, uint16_t max_lod, uint8_t max_aniso);
 316
 317 int set_texture_addr(uint32_t *fifo, uint8_t index,
 318     uint8_t wrap_s, uint8_t wrap_t, uint8_t wrap_r, uint8_t unsigned_remap,
 319     uint8_t zfunc, uint8_t gamma);
 320
 321 int set_texture_filter(uint32_t *fifo, uint8_t index,
 322     uint16_t bias, uint8_t min, uint8_t mag, uint8_t conv);
 323
 324 int invalidate_texture_cache(uint32_t *fifo, uint32_t val);
 325
 326 int set_timestamp(uint32_t *fifo, uint32_t index);
 327
 328 #endif