1 /* SPDX-License-Identifier: MIT */ 2 #ifndef __NVKM_FLCNEN_H__ 3 #define __NVKM_FLCNEN_H__ 4 #define nvkm_falcon(p) container_of((p), struct nvkm_falcon, engine) 5 #include <core/engine.h> 6 struct nvkm_fifo_chan; 7 struct nvkm_gpuobj; 8 9 enum nvkm_falcon_dmaidx { 10 FALCON_DMAIDX_UCODE = 0, 11 FALCON_DMAIDX_VIRT = 1, 12 FALCON_DMAIDX_PHYS_VID = 2, 13 FALCON_DMAIDX_PHYS_SYS_COH = 3, 14 FALCON_DMAIDX_PHYS_SYS_NCOH = 4, 15 FALCON_SEC2_DMAIDX_UCODE = 6, 16 }; 17 18 struct nvkm_falcon { 19 const struct nvkm_falcon_func *func; 20 const struct nvkm_subdev *owner; 21 const char *name; 22 u32 addr; 23 24 struct mutex mutex; 25 struct mutex dmem_mutex; 26 bool oneinit; 27 28 const struct nvkm_subdev *user; 29 30 u8 version; 31 u8 secret; 32 bool debug; 33 34 struct nvkm_memory *core; 35 bool external; 36 37 struct { 38 u32 limit; 39 u32 *data; 40 u32 size; 41 u8 ports; 42 } code; 43 44 struct { 45 u32 limit; 46 u32 *data; 47 u32 size; 48 u8 ports; 49 } data; 50 51 struct nvkm_engine engine; 52 }; 53 54 /* This constructor must be called from the owner's oneinit() hook and 55 * *not* its constructor. This is to ensure that DEVINIT has been 56 * completed, and that the device is correctly enabled before we touch 57 * falcon registers. 58 */ 59 int nvkm_falcon_v1_new(struct nvkm_subdev *owner, const char *name, u32 addr, 60 struct nvkm_falcon **); 61 62 void nvkm_falcon_del(struct nvkm_falcon **); 63 int nvkm_falcon_get(struct nvkm_falcon *, const struct nvkm_subdev *); 64 void nvkm_falcon_put(struct nvkm_falcon *, const struct nvkm_subdev *); 65 66 int nvkm_falcon_new__(const struct nvkm_falcon_func *, bool old, struct nvkm_device *, 67 enum nvkm_subdev_type, int inst, bool enable, u32 addr, struct nvkm_engine **); 68 #define nvkm_falcon_new__o(f,d,i, e,a,s) nvkm_falcon_new__((f), true, (d), (i), -1 , (e), (a), (s)) 69 #define nvkm_falcon_new__n(f,d,t,i,e,a,s) nvkm_falcon_new__((f), false, (d), (t), (i), (e), (a), (s)) 70 #define nvkm_falcon_new___(_1,_2,_3,_4,_5,_6,_7,IMPL,...) IMPL 71 #define nvkm_falcon_new_(A...) nvkm_falcon_new___(A, nvkm_falcon_new__n, nvkm_falcon_new__o)(A) 72 73 struct nvkm_falcon_func { 74 struct { 75 u32 *data; 76 u32 size; 77 } code; 78 struct { 79 u32 *data; 80 u32 size; 81 } data; 82 void (*init)(struct nvkm_falcon *); 83 void (*intr)(struct nvkm_falcon *, struct nvkm_fifo_chan *); 84 85 u32 debug; 86 u32 fbif; 87 88 void (*load_imem)(struct nvkm_falcon *, void *, u32, u32, u16, u8, bool); 89 void (*load_dmem)(struct nvkm_falcon *, void *, u32, u32, u8); 90 void (*read_dmem)(struct nvkm_falcon *, u32, u32, u8, void *); 91 u32 emem_addr; 92 void (*bind_context)(struct nvkm_falcon *, struct nvkm_memory *); 93 int (*wait_for_halt)(struct nvkm_falcon *, u32); 94 int (*clear_interrupt)(struct nvkm_falcon *, u32); 95 void (*set_start_addr)(struct nvkm_falcon *, u32 start_addr); 96 void (*start)(struct nvkm_falcon *); 97 int (*enable)(struct nvkm_falcon *falcon); 98 void (*disable)(struct nvkm_falcon *falcon); 99 int (*reset)(struct nvkm_falcon *); 100 101 struct { 102 u32 head; 103 u32 tail; 104 u32 stride; 105 } cmdq, msgq; 106 107 struct nvkm_sclass sclass[]; 108 }; 109 110 static inline u32 111 nvkm_falcon_rd32(struct nvkm_falcon *falcon, u32 addr) 112 { 113 return nvkm_rd32(falcon->owner->device, falcon->addr + addr); 114 } 115 116 static inline void 117 nvkm_falcon_wr32(struct nvkm_falcon *falcon, u32 addr, u32 data) 118 { 119 nvkm_wr32(falcon->owner->device, falcon->addr + addr, data); 120 } 121 122 static inline u32 123 nvkm_falcon_mask(struct nvkm_falcon *falcon, u32 addr, u32 mask, u32 val) 124 { 125 struct nvkm_device *device = falcon->owner->device; 126 127 return nvkm_mask(device, falcon->addr + addr, mask, val); 128 } 129 130 void nvkm_falcon_load_imem(struct nvkm_falcon *, void *, u32, u32, u16, u8, 131 bool); 132 void nvkm_falcon_load_dmem(struct nvkm_falcon *, void *, u32, u32, u8); 133 void nvkm_falcon_read_dmem(struct nvkm_falcon *, u32, u32, u8, void *); 134 void nvkm_falcon_bind_context(struct nvkm_falcon *, struct nvkm_memory *); 135 void nvkm_falcon_set_start_addr(struct nvkm_falcon *, u32); 136 void nvkm_falcon_start(struct nvkm_falcon *); 137 int nvkm_falcon_wait_for_halt(struct nvkm_falcon *, u32); 138 int nvkm_falcon_clear_interrupt(struct nvkm_falcon *, u32); 139 int nvkm_falcon_enable(struct nvkm_falcon *); 140 void nvkm_falcon_disable(struct nvkm_falcon *); 141 int nvkm_falcon_reset(struct nvkm_falcon *); 142 #endif 143