#include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef _WIN32 # define WIN32_LEAN_AND_MEAN # ifndef NOMINMAX # define NOMINMAX # endif # include # include #else # include # include #endif #pragma clang diagnostic ignored "-Wnested-anon-types" #pragma clang diagnostic ignored "-Wlanguage-extension-token" #pragma clang diagnostic ignored "-Wgnu-anonymous-struct" #pragma clang diagnostic ignored "-Wmicrosoft-enum-value" #include #include #include #define GGML_COMMON_IMPL_CPP #include "ggml-backend-impl.h" #include "ggml-common.h" #include "ggml-hexagon.h" #include "ggml-impl.h" #include "ggml-quants.h" #include "htp-opnode.h" #include "htp-ops.h" #include "htp/matmul-ops.h" #include "htp/flash-attn-ops.h" #include "htp/unary-ops.h" #include "htp/get-rows-ops.h" #include "htp/set-rows-ops.h" #include "htp_iface.h" #include "htp-drv.h" using intvec = std::vector; using uintvec = std::vector; using u32vec = std::vector; #define GGML_HEXAGON_MAX_SESSIONS 16 #define GGML_HEXAGON_FENCE_BUFFER_SIZE 8192 #define GGML_HEXAGON_FENCE_SLOT_SIZE 128 struct ggml_hexagon_device_config { int physical_idx = 0; int virtual_idx = 0; std::string name; }; static ggml_hexagon_device_config opt_device_configs[GGML_HEXAGON_MAX_SESSIONS]; static int get_domain_id(int physical_idx) { switch (physical_idx) { case 0: return 3; // CDSP0 (all devices) case 1: return 4; // CDSP1 (IQ9, IQ10) case 2: return 18; // CDSP2 (IQ10) case 3: return 19; // CDSP3 (IQ10) default: return CDSP_DOMAIN_ID + physical_idx; } } static std::string get_domain_name(int physical_idx) { if (physical_idx == 0) { return CDSP_DOMAIN_NAME; } return std::string("cdsp") + std::to_string(physical_idx); } static int opt_arch = 0; // autodetect static size_t opt_ndev = 1; static size_t opt_nhvx = 0; // use all static int opt_nhmx = 1; // when set, enable HMX; when 0, use HVX only static size_t opt_vmem = HTP_OP_MAX_VMEM_DEFAULT; // max available va space for buffer mappings static size_t opt_mbuf = 1ul * 1024 * 1024 * 1024; // max buffer size static int opt_etm = 0; static int opt_verbose = 0; static int opt_profile = 0; // profiling mode (0-disabled, 1-basic, 2-pmu) static bool opt_hostbuf = false; static int opt_mm_select = 3; // 3 = HMX -> Tiled -> Flat -> CPU, 2 = Tiled -> Flat -> CPU, 1 = Flat -> CPU static int opt_fa_select = 2; // 2 = HMX -> HVX -> CPU, 1 = HVX -> CPU, 0 = CPU (unsupported) static int opt_ar_select = 2; // 2 = fused ALLREDUCE+ADD (DMA, default), 1 = unfused ALLREDUCE (DMA), 0 = fallback to CPY+FENCE // Default PMU events, if profiling with PMU (mode=2) is enabled // See https://docs.qualcomm.com/doc/80-N2040-60/topic/pmu-events.html // https://docs.qualcomm.com/doc/80-N2040-61/topic/hvx-pmu-events.html static u32vec opt_pmu_evt { 0x3, 0x111, 0x100, 0x105, 0x240, 0x256, 0x7D, 0x8C }; static int opt_opbatch = 1024; // max number of ops in a batch static int opt_opqueue = 64; // max number of pending batches static int opt_optrace = 0; // trace buffer size per thread (0 means default) static int opt_oppoll = 0; // polling for batch completions static int opt_opfusion = 1; // enable/disable op fusion static std::regex* opt_opfilter = NULL; // regex of ops to not claim #define HEX_VERBOSE(...) \ if (opt_verbose) GGML_LOG_DEBUG(__VA_ARGS__) static const char * status_to_str(uint32_t status) { switch (status) { case HTP_STATUS_OK: return "OK"; case HTP_STATUS_NO_SUPPORT: return "NO-SUPPORT"; case HTP_STATUS_INVAL_PARAMS: return "INVAL-PARAMS"; case HTP_STATUS_VTCM_TOO_SMALL: return "VTCM-TOO-SMALL"; case HTP_STATUS_INTERNAL_ERR: return "INTERNAL-ERROR"; default: return "UNKNOWN"; } } // ** debug helpers static void ggml_hexagon_dump_op_exec(const std::string &sess_name, const htp_opnode & node, const uint32_t req_flags) { if (!opt_verbose) return; htp_opformat fmt(node); GGML_LOG_DEBUG("ggml-hex: %s execute-op %s|%s|%s|%s|%s|%s|%s|flags 0x%x\n", sess_name.c_str(), node.op_name().c_str(), fmt.names, fmt.dims, fmt.types, fmt.strides, fmt.buffs, fmt.kparams, req_flags); } static void ggml_hexagon_dump_op_supp(const std::string &sess_name, const struct ggml_tensor * op, bool supp) { if (!opt_verbose) return; htp_opformat fmt(htp_opformat(htp_opnode(HTP_OP_INVALID, const_cast(op)))); GGML_LOG_DEBUG("ggml-hex: %s supports-op %s|%s|%s|%s|%s|%s|%s\n", sess_name.c_str(), ggml_op_desc(op), fmt.names, fmt.dims, fmt.types, fmt.strides, fmt.buffs, supp ? "yes" : "no"); } static const char * htp_event_name(uint16_t id) { switch (id) { case HTP_TRACE_EVT_DMA: return "DMA"; case HTP_TRACE_EVT_HVX_COMP: return "HVX_COMP"; case HTP_TRACE_EVT_HVX_A_QUANT: return "HVX_A_QUANT"; case HTP_TRACE_EVT_HVX_A_PREP: return "HVX_A_PREP"; case HTP_TRACE_EVT_HVX_W_DEQUANT: return "HVX_W_DEQUANT"; case HTP_TRACE_EVT_HVX_W_PREP: return "HVX_W_PREP"; case HTP_TRACE_EVT_HVX_O_PROC: return "HVX_O_PROC"; case HTP_TRACE_EVT_HVX_FA_QK: return "HVX_QK_FA"; case HTP_TRACE_EVT_HVX_FA_SFM: return "HVX_SFM_FA"; case HTP_TRACE_EVT_HVX_FA_Q_PREP: return "HVX_Q_PREP"; case HTP_TRACE_EVT_HVX_FA_K_PREP: return "HVX_K_PREP"; case HTP_TRACE_EVT_HVX_FA_V_PREP: return "HVX_V_PREP"; case HTP_TRACE_EVT_HMX_COMP: return "HMX_COMP"; case HTP_TRACE_EVT_L2FLUSH: return "L2FLUSH"; case HTP_TRACE_EVT_INIT: return "INIT"; case HTP_TRACE_EVT_BUFF: return "BUFF"; case HTP_TRACE_EVT_FENCE: return "FENCE"; default: return "UNKNOWN"; } } static void ggml_hexagon_dump_op_prof(const std::string &sess_name, const htp_opnode & node, const htp_prof_desc & pd) { if (!opt_profile) return; uint32_t op_usec = pd.usecs; uint32_t op_cycles = pd.cycles_stop - pd.cycles_start; const uint32_t * pmu = pd.pmu; char pmu_str[256] = ""; if (opt_profile == 2) { static_assert(HTP_PROF_PMU_NCNT == 8, "current implementation assumes 8 PMU counters"); snprintf(pmu_str, sizeof(pmu_str), " pmu [%u,%u,%u,%u,%u,%u,%u,%u]", pmu[0], pmu[1], pmu[2], pmu[3], pmu[4], pmu[5], pmu[6], pmu[7]); } htp_opformat fmt(node); float mhz = op_usec > 0 ? (float) op_cycles / op_usec : 0.0f; GGML_LOG_DEBUG("ggml-hex: %s profile-op %s|%s|%s|%s|%s|%s|usec %u cycles %u start %u mhz %.1f%s\n", sess_name.c_str(), node.op_name().c_str(), fmt.names, fmt.dims, fmt.types, fmt.strides, fmt.kparams, op_usec, op_cycles, pd.cycles_start, mhz, pmu_str); } static void ggml_hexagon_dump_batch_prof(const std::string & sess_name, const htp_opbatch_rsp & rsp) { uint64_t batch_cycles = rsp.cycles_stop - rsp.cycles_start; float batch_mhz = rsp.usecs > 0 ? (float) batch_cycles / rsp.usecs : 0.0f; char evt_str[256] = "----"; if (opt_profile == 3) { snprintf(evt_str, sizeof(evt_str), "evt-cnt %u,%u,%u,%u,%u,%u,%u,%u,%u,%u,%u", rsp.n_traces[0], rsp.n_traces[1], rsp.n_traces[2], rsp.n_traces[3], rsp.n_traces[4], rsp.n_traces[5], rsp.n_traces[6], rsp.n_traces[7], rsp.n_traces[8], rsp.n_traces[9], rsp.n_traces[10]); } GGML_LOG_DEBUG("ggml-hex: %s profile-op OPBATCH|----|n-ops %u|%s|----|----|usec %u cycles %llu start %llu mhz %.1f\n", sess_name.c_str(), rsp.n_ops, evt_str, rsp.usecs, (unsigned long long) batch_cycles, (unsigned long long) rsp.cycles_start, batch_mhz); } static void ggml_hexagon_dump_trace_events(const std::string & sess_name, const htp_opbatch_rsp & rsp, const htp_trace_desc * trace_events, uint32_t n_traces) { if (opt_profile == 3 && trace_events) { uint32_t valid_cnt[HTP_MAX_NTHREADS + 1] = {0}; for (uint32_t t = 0; t <= HTP_MAX_NTHREADS; t++) { uint32_t count = rsp.n_traces[t]; valid_cnt[t] = count > n_traces ? n_traces : count; } for (uint32_t t = 0; t <= HTP_MAX_NTHREADS; t++) { for (uint32_t idx = 0; idx < valid_cnt[t]; idx++) { const auto & e = trace_events[t * n_traces + idx]; bool is_stop = (e.info & 0x8000) != 0; uint16_t info = e.info & 0x7FFF; GGML_LOG_DEBUG("ggml-hex: %s trace-evt %s: thread %u info %u %s %u\n", sess_name.c_str(), htp_event_name(e.id), t, info, is_stop ? "stop" : "start", e.cycles); } } } } enum ggml_hexagon_tensor_flags { GGML_HEXAGON_TENSOR_REPACK = (1 << 0), GGML_HEXAGON_TENSOR_WEIGHT = (1 << 1), GGML_HEXAGON_TENSOR_FENCE = (1 << 2), GGML_HEXAGON_TENSOR_FUSEABLE = (1 << 3), }; static inline bool ggml_hexagon_is_repack_type(enum ggml_type type) { return type == GGML_TYPE_Q4_0 || type == GGML_TYPE_Q4_1 || type == GGML_TYPE_Q8_0 || type == GGML_TYPE_IQ4_NL || type == GGML_TYPE_MXFP4; } static inline bool ggml_hexagon_is_hmx_weight_type(enum ggml_type type) { return type == GGML_TYPE_F16 || type == GGML_TYPE_F32 || ggml_hexagon_is_repack_type(type); } struct ggml_hexagon_session; static void ggml_hexagon_precompute_matmul_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, struct htp_mm_kernel_params * kparams ); static void ggml_hexagon_precompute_fused_matmul_add_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * src2, const struct ggml_tensor * dst, struct htp_mm_kernel_params * kparams ); static void ggml_hexagon_precompute_unary_params( const struct ggml_hexagon_session * sess, uint32_t op, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, struct htp_unary_kernel_params * kparams ); static void ggml_hexagon_precompute_get_rows_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, struct htp_get_rows_kernel_params * kparams ); static void ggml_hexagon_precompute_set_rows_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, struct htp_set_rows_kernel_params * kparams ); static void ggml_hexagon_precompute_fused_mmnx_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, int32_t n_weights, struct htp_mm_kernel_params * kparams ); static bool ggml_hexagon_precompute_allreduce_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * dst, uint32_t rank, uint32_t n_ranks, bool has_add, bool is_row_bcast, struct htp_allreduce_kernel_params * kparams ); static bool mm_is_hmx_eligible(const ggml_tensor * t); static bool is_mergeable_mul_mat(const ggml_tensor * t); static bool is_mergeable_mul_mat_pair(const ggml_tensor * n1, const ggml_tensor * n2); // ** backend sessions struct ggml_hexagon_tensor_extra { std::vector shadow_buf; size_t shadow_size { 0 }; uint32_t flags { 0 }; }; static inline bool ggml_hexagon_tensor_is_fuseable(const struct ggml_tensor * t) { if (!t || !t->extra) return false; auto extra = (const struct ggml_hexagon_tensor_extra *) t->extra; return (extra->flags & GGML_HEXAGON_TENSOR_FUSEABLE) != 0; } struct htp_opnode; struct ggml_hexagon_opbatch; struct ggml_hexagon_opqueue; struct ggml_hexagon_shared_buffer; struct ggml_hexagon_session; struct ggml_backend_hexagon_comm_context { std::vector backends; size_t n_backends = 0; uint32_t fence_seq = 0; }; struct ggml_hexagon_event { ggml_hexagon_session * sess = nullptr; uint64_t seq = 0; }; struct ggml_hexagon_session { std::string name; remote_handle64 handle; dspqueue_t queue; uint32_t session_id; uint32_t domain_id; uint64_t queue_id; int dev_id; int phys_idx; int virt_idx; bool valid_session; bool valid_handle; bool valid_queue; bool valid_iface; std::atomic op_pending; ggml_hexagon_opbatch* op_batch; ggml_hexagon_opqueue* op_queue; std::unordered_map> cloned_buffers; std::unordered_set sync_peers; ggml_backend_buffer_type buffer_type = {}; ggml_backend_buffer_type host_buffer_type = {}; uint32_t n_threads = 0; uint32_t n_hvx = 0; uint32_t n_hmx = 0; uint64_t vtcm_size = 0; size_t max_vmem = 0; size_t max_bufsize = 0; uint32_t fence_seq; uint64_t cached_uid = 0; std::vector cached_nodes; mutable std::unordered_set needs_repack; ggml_hexagon_session(int dev_id, ggml_backend_dev_t dev) noexcept(false); ~ggml_hexagon_session() noexcept(true); const char* c_name() const { return name.c_str(); } void allocate(int dev_id) noexcept(false); void release() noexcept(true); void enqueue_op(const htp_opnode & node); void enqueue_cpy(const ggml_tensor * src, ggml_tensor * dst, const ggml_tensor * sync_tensor = nullptr, uint32_t fence_seq = 0); void enqueue_fence(const ggml_tensor * sync_tensor, uint32_t fence_seq = 0); void enqueue_allreduce(const ggml_tensor * dst, const std::vector & src_tensors, const std::vector & sync_tensors, uint32_t rank, uint32_t n_ranks, uint32_t fence_seq_entry = 0, uint32_t fence_seq_exit = 0); void flush(bool all = true); void flush_pending(bool all = false); void flush_batch(size_t min_ops = 1); uint64_t record_event(); void wait_event(uint64_t seq); bool clone_buffer(const ggml_hexagon_shared_buffer*); void add_sync_peer(ggml_hexagon_session * peer) { sync_peers.insert(peer); } void flush_sync_peers() { if (sync_peers.empty()) return; for (auto * peer : sync_peers) { peer->flush_batch(); } sync_peers.clear(); } }; // ** backend buffers struct ggml_backend_hexagon_buffer_type_context { ggml_backend_hexagon_buffer_type_context(const std::string & name, ggml_hexagon_session * sess) { this->sess = sess; this->name = name; } ggml_hexagon_session * sess; std::string name; }; struct ggml_hexagon_rpcmem_block { uint8_t * base = nullptr; int fd = -1; size_t size = 0; ggml_hexagon_rpcmem_block(size_t size) { base = (uint8_t *) rpcmem_alloc2(RPCMEM_HEAP_ID_SYSTEM, RPCMEM_DEFAULT_FLAGS, size); if (!base) { throw std::runtime_error("ggml-hex: rpcmem_alloc failed"); } fd = rpcmem_to_fd(base); if (fd < 0) { rpcmem_free(base); throw std::runtime_error("ggml-hex: rpcmem_to_fd failed"); } this->size = size; } ~ggml_hexagon_rpcmem_block() { if (base) { rpcmem_free(base); } } }; struct ggml_hexagon_shared_buffer { ggml_hexagon_session * sess; std::shared_ptr mem; std::vector tensor_extra; uint32_t fence_head = 0; size_t fences_size = 0; bool mapped; bool pinned; const char * c_name() const { return sess->c_name(); } uint8_t * base() const { return mem ? mem->base : nullptr; } size_t size() const { return mem ? mem->size : 0; } int fd() const { return mem ? mem->fd : -1; } uint8_t * alloc_fence() { if (fences_size == 0) return nullptr; int max_slots = fences_size / GGML_HEXAGON_FENCE_SLOT_SIZE; uint32_t slot = (fence_head++) % max_slots; size_t guard_offset = size() - fences_size; uint8_t * fence_ptr = base() + guard_offset + (size_t)slot * GGML_HEXAGON_FENCE_SLOT_SIZE; return fence_ptr; } void mmap() { if (!this->mem) return; fastrpc_map_flags flags = this->pinned ? FASTRPC_MAP_FD : FASTRPC_MAP_FD_DELAYED; int err = fastrpc_mmap(sess->domain_id, fd(), (void *) base(), 0, size(), flags); if (err != 0) { GGML_LOG_ERROR("ggml-hex: %s buffer mapping failed : domain_id %d size %zu fd %d error 0x%08x\n", sess->c_name(), sess->domain_id, size(), fd(), (unsigned) err); throw std::runtime_error("ggml-hex: fastrpc_mmap failed (see log for details)"); } HEX_VERBOSE("ggml-hex: %s mapped buffer: base %p size %zu fd %d pinned %u\n", sess->c_name(), (void *) base(), size(), fd(), pinned); this->mapped = true; } void unmap() { if (!this->mapped) return; if (!this->pinned && mem) { // HTP might still hold a reference, tell it drop it htp_iface_munmap(sess->handle, fd()); } if (mem) { fastrpc_munmap(sess->domain_id, fd(), (void *) base(), size()); } HEX_VERBOSE("ggml-hex: %s unmapped buffer: base %p size %zu fd %d\n", sess->c_name(), (void *) base(), size(), fd()); this->mapped = false; } void alloc(size_t size) { if (this->mem) return; this->mem = std::make_shared(size); HEX_VERBOSE("ggml-hex: %s allocated buffer: base %p size %zu fd %d pinned %d\n", sess->c_name(), (void *) base(), this->size(), fd(), (int) pinned); mmap(); } void free() { unmap(); // The memory is freed when the shared_ptr refcount drops to 0. HEX_VERBOSE("ggml-hex: %s release ref on buffer: base %p size %zu fd %d\n", sess->c_name(), (void *) base(), size(), fd()); this->mem = nullptr; } ggml_hexagon_shared_buffer(ggml_hexagon_session * sess, size_t size, bool pinned = false, size_t fence_size = 0) { this->sess = sess; this->mapped = false; this->pinned = pinned; this->fences_size = fence_size; // Size adjustment inside the buffer class size_t guard_offset = (size + 4095) & ~4095; size_t total_size = guard_offset; if (fence_size > 0) { total_size += 4096 + fence_size; } alloc(total_size); } // Clone constructor for cross-session mapping ggml_hexagon_shared_buffer(ggml_hexagon_session * sess, const ggml_hexagon_shared_buffer & other) { this->sess = sess; this->mem = other.mem; this->mapped = false; this->pinned = other.pinned; this->fences_size = other.fences_size; } ~ggml_hexagon_shared_buffer() { free(); for (auto * extra : tensor_extra) { delete extra; } } }; static ggml_hexagon_session * ggml_backend_hexagon_buffer_get_sess(ggml_backend_buffer_t buffer) { return static_cast(buffer->buft->context)->sess; } static void ggml_backend_hexagon_buffer_free_buffer(ggml_backend_buffer_t buffer) { auto sbuf = static_cast(buffer->context); delete sbuf; } static void * ggml_backend_hexagon_buffer_get_base(ggml_backend_buffer_t buffer) { auto sbuf = static_cast(buffer->context); return sbuf->base(); } static enum ggml_status ggml_backend_hexagon_buffer_init_tensor(ggml_backend_buffer_t buffer, ggml_tensor * tensor) { auto sbuf = static_cast(buffer->context); auto sess = sbuf->sess; HEX_VERBOSE("ggml-hex: %s init-tensor %s : base %p data %p nbytes %zu\n", sess->c_name(), tensor->name, (void *) sbuf->base(), tensor->data, ggml_nbytes(tensor)); auto extra = new ggml_hexagon_tensor_extra(); sbuf->tensor_extra.push_back(extra); tensor->extra = extra; if (ggml_hexagon_is_repack_type(tensor->type)) { if (sess->needs_repack.count(tensor)) { extra->flags |= GGML_HEXAGON_TENSOR_REPACK; sess->needs_repack.erase(tensor); } } return GGML_STATUS_SUCCESS; } // ** Repack helpers for tiled quantized weights static void unpack_q4_0_quants(uint8_t * qs, const block_q4_0 * x, unsigned int bi) { static const int qk = QK4_0; for (unsigned int i = 0; i < qk / 2; ++i) { const int x0 = (x->qs[i] & 0x0F); const int x1 = (x->qs[i] >> 4); qs[bi * qk + i + 0] = x0; qs[bi * qk + i + qk / 2] = x1; } } static void pack_q4_0_quants(block_q4_0 * x, const uint8_t * qs, unsigned int bi) { static const int qk = QK4_0; for (unsigned int i = 0; i < qk / 2; ++i) { const uint8_t x0 = qs[bi * qk + i + 0]; const uint8_t x1 = qs[bi * qk + i + qk / 2]; x->qs[i] = x0 | (x1 << 4); } } static void unpack_q4_1_quants(uint8_t * qs, const block_q4_1 * x, unsigned int bi) { static const int qk = QK4_1; for (unsigned int i = 0; i < qk / 2; ++i) { const int x0 = (x->qs[i] & 0x0F); const int x1 = (x->qs[i] >> 4); qs[bi * qk + i + 0] = x0; qs[bi * qk + i + qk / 2] = x1; } } static void pack_q4_1_quants(block_q4_1 * x, const uint8_t * qs, unsigned int bi) { static const int qk = QK4_1; for (unsigned int i = 0; i < qk / 2; ++i) { const uint8_t x0 = qs[bi * qk + i + 0]; const uint8_t x1 = qs[bi * qk + i + qk / 2]; x->qs[i] = x0 | (x1 << 4); } } static void unpack_mxfp4_quants(uint8_t * qs, const block_mxfp4 * x, unsigned int bi) { static const int qk = QK_MXFP4; for (unsigned int i = 0; i < qk / 2; ++i) { const int x0 = (x->qs[i] & 0x0F); const int x1 = (x->qs[i] >> 4); qs[bi * qk + i + 0] = x0; qs[bi * qk + i + qk / 2] = x1; } } static void pack_mxfp4_quants(block_mxfp4 * x, const uint8_t * qs, unsigned int bi) { static const int qk = QK_MXFP4; for (unsigned int i = 0; i < qk / 2; ++i) { const uint8_t x0 = qs[bi * qk + i + 0]; const uint8_t x1 = qs[bi * qk + i + qk / 2]; x->qs[i] = x0 | (x1 << 4); } } // repack q4_0 data into q4_0_tiled tensor static void repack_q4_0_tiled(ggml_tensor * t, const void * data, size_t offset, size_t size) { const block_q4_0 * src_matrix = (const block_q4_0 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_Q4_0; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { const block_q4_0 * src_slice = src_matrix + (slice_idx - start_slice) * (ne1 * (ne0 / 32)); uint8_t * matrix_dst = (uint8_t *) t->data + slice_idx * matrix_size; for (int ct = 0; ct < n_col_tiles; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { uint8_t * tile_dst = matrix_dst + (ct * n_k_tiles + kt) * tile_size; uint8_t tile_quants[32][32]; for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r < ne1 && kt < ne0 / 32) { unpack_q4_0_quants(tile_quants[row], &src_slice[r * (ne0 / 32) + kt], 0); } else { memset(tile_quants[row], 8, 32); } } for (int cp = 0; cp < 16; cp++) { for (int row = 0; row < 32; row++) { tile_dst[cp * 32 + row] = (tile_quants[row][2 * cp + 1] << 4) | tile_quants[row][2 * cp]; } } ggml_half * scale_dst = (ggml_half *)(tile_dst + 512); for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; scale_dst[row] = (r < ne1 && kt < ne0 / 32) ? src_slice[r * (ne0 / 32) + kt].d : 0; } } } } } // repack q4_0_tiled tensor into q4_0 data static void repack_tiled_q4_0(void * data, const ggml_tensor * t, size_t offset, size_t size) { block_q4_0 * dst_matrix = (block_q4_0 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_Q4_0; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); size_t row_size_bytes = ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { size_t cur_start_byte = (std::max)(offset, (size_t) slice_idx * slice_size); size_t cur_end_byte = (std::min)(offset + size, (size_t) (slice_idx + 1) * slice_size); size_t slice_offset_start = cur_start_byte - (size_t) slice_idx * slice_size; size_t slice_offset_end = cur_end_byte - (size_t) slice_idx * slice_size; int64_t start_row = slice_offset_start / row_size_bytes; int64_t end_row = (slice_offset_end + row_size_bytes - 1) / row_size_bytes; end_row = (std::min)(end_row, ne1); int start_ct = start_row / 32; int end_ct = (end_row + 31) / 32; end_ct = (std::min)(end_ct, n_col_tiles); block_q4_0 * dst_slice = dst_matrix + (cur_start_byte - offset) / sizeof(block_q4_0); const uint8_t * matrix_src = (const uint8_t *) t->data + slice_idx * matrix_size; for (int ct = start_ct; ct < end_ct; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { const uint8_t * tile_src = matrix_src + (ct * n_k_tiles + kt) * tile_size; uint8_t tile_quants[32][32]; for (int cp = 0; cp < 16; cp++) { for (int row = 0; row < 32; row++) { uint8_t val = tile_src[cp * 32 + row]; tile_quants[row][2 * cp + 0] = val & 0x0F; tile_quants[row][2 * cp + 1] = val >> 4; } } for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { pack_q4_0_quants(&dst_slice[(r - start_row) * (ne0 / 32) + kt], tile_quants[row], 0); } } const ggml_half * scale_src = (const ggml_half *)(tile_src + 512); for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { dst_slice[(r - start_row) * (ne0 / 32) + kt].d = scale_src[row]; } } } } } } // repack q4_1 data into q4_1_tiled tensor static void repack_q4_1_tiled(ggml_tensor * t, const void * data, size_t offset, size_t size) { const block_q4_1 * src_matrix = (const block_q4_1 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_Q4_1; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { const block_q4_1 * src_slice = src_matrix + (slice_idx - start_slice) * (ne1 * (ne0 / 32)); uint8_t * matrix_dst = (uint8_t *) t->data + slice_idx * matrix_size; for (int ct = 0; ct < n_col_tiles; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { uint8_t * tile_dst = matrix_dst + (ct * n_k_tiles + kt) * tile_size; uint8_t tile_quants[32][32]; for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r < ne1 && kt < ne0 / 32) { unpack_q4_1_quants(tile_quants[row], &src_slice[r * (ne0 / 32) + kt], 0); } else { memset(tile_quants[row], 0, 32); } } for (int cp = 0; cp < 16; cp++) { for (int row = 0; row < 32; row++) { tile_dst[cp * 32 + row] = (tile_quants[row][2 * cp + 1] << 4) | tile_quants[row][2 * cp]; } } ggml_half * scale_dst = (ggml_half *)(tile_dst + 512); for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r < ne1 && kt < ne0 / 32) { scale_dst[2 * row + 0] = src_slice[r * (ne0 / 32) + kt].d; scale_dst[2 * row + 1] = src_slice[r * (ne0 / 32) + kt].m; } else { scale_dst[2 * row + 0] = 0; scale_dst[2 * row + 1] = 0; } } } } } } // repack q4_1_tiled tensor into q4_1 data static void repack_tiled_q4_1(void * data, const ggml_tensor * t, size_t offset, size_t size) { block_q4_1 * dst_matrix = (block_q4_1 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_Q4_1; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); size_t row_size_bytes = ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { size_t cur_start_byte = (std::max)(offset, (size_t) slice_idx * slice_size); size_t cur_end_byte = (std::min)(offset + size, (size_t) (slice_idx + 1) * slice_size); size_t slice_offset_start = cur_start_byte - (size_t) slice_idx * slice_size; size_t slice_offset_end = cur_end_byte - (size_t) slice_idx * slice_size; int64_t start_row = slice_offset_start / row_size_bytes; int64_t end_row = (slice_offset_end + row_size_bytes - 1) / row_size_bytes; end_row = (std::min)(end_row, ne1); int start_ct = start_row / 32; int end_ct = (end_row + 31) / 32; end_ct = (std::min)(end_ct, n_col_tiles); block_q4_1 * dst_slice = dst_matrix + (cur_start_byte - offset) / sizeof(block_q4_1); const uint8_t * matrix_src = (const uint8_t *) t->data + slice_idx * matrix_size; for (int ct = start_ct; ct < end_ct; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { const uint8_t * tile_src = matrix_src + (ct * n_k_tiles + kt) * tile_size; uint8_t tile_quants[32][32]; for (int cp = 0; cp < 16; cp++) { for (int row = 0; row < 32; row++) { uint8_t val = tile_src[cp * 32 + row]; tile_quants[row][2 * cp + 0] = val & 0x0F; tile_quants[row][2 * cp + 1] = val >> 4; } } for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { pack_q4_1_quants(&dst_slice[(r - start_row) * (ne0 / 32) + kt], tile_quants[row], 0); } } const ggml_half * scale_src = (const ggml_half *)(tile_src + 512); for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { dst_slice[(r - start_row) * (ne0 / 32) + kt].d = scale_src[2 * row]; dst_slice[(r - start_row) * (ne0 / 32) + kt].m = scale_src[2 * row + 1]; } } } } } } // repack q8_0 data into q8_0_tiled tensor static void repack_q8_0_tiled(ggml_tensor * t, const void * data, size_t offset, size_t size) { const block_q8_0 * src_matrix = (const block_q8_0 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_Q8_0; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { const block_q8_0 * src_slice = src_matrix + (slice_idx - start_slice) * (ne1 * (ne0 / 32)); uint8_t * matrix_dst = (uint8_t *) t->data + slice_idx * matrix_size; for (int ct = 0; ct < n_col_tiles; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { uint8_t * tile_dst = matrix_dst + (ct * n_k_tiles + kt) * tile_size; for (int cp = 0; cp < 16; cp++) { int col0 = cp * 2; int col1 = col0 + 1; for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; const block_q8_0 * b = (r < ne1 && kt < ne0 / 32) ? &src_slice[r * (ne0 / 32) + kt] : NULL; tile_dst[cp * 64 + 2 * row + 0] = b ? b->qs[col0] : 0; tile_dst[cp * 64 + 2 * row + 1] = b ? b->qs[col1] : 0; } } ggml_half * scale_dst = (ggml_half *)(tile_dst + 1024); for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; scale_dst[row] = (r < ne1 && kt < ne0 / 32) ? src_slice[r * (ne0 / 32) + kt].d : 0; } } } } } // repack q8_0_tiled tensor into q8_0 data static void repack_tiled_q8_0(void * data, const ggml_tensor * t, size_t offset, size_t size) { block_q8_0 * dst_matrix = (block_q8_0 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_Q8_0; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); size_t row_size_bytes = ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { size_t cur_start_byte = (std::max)(offset, (size_t) slice_idx * slice_size); size_t cur_end_byte = (std::min)(offset + size, (size_t) (slice_idx + 1) * slice_size); size_t slice_offset_start = cur_start_byte - (size_t) slice_idx * slice_size; size_t slice_offset_end = cur_end_byte - (size_t) slice_idx * slice_size; int64_t start_row = slice_offset_start / row_size_bytes; int64_t end_row = (slice_offset_end + row_size_bytes - 1) / row_size_bytes; end_row = (std::min)(end_row, ne1); int start_ct = start_row / 32; int end_ct = (end_row + 31) / 32; end_ct = (std::min)(end_ct, n_col_tiles); block_q8_0 * dst_slice = dst_matrix + (cur_start_byte - offset) / sizeof(block_q8_0); const uint8_t * matrix_src = (const uint8_t *) t->data + slice_idx * matrix_size; for (int ct = start_ct; ct < end_ct; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { const uint8_t * tile_src = matrix_src + (ct * n_k_tiles + kt) * tile_size; for (int cp = 0; cp < 16; cp++) { int col0 = cp * 2; int col1 = col0 + 1; for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { block_q8_0 & b = dst_slice[(r - start_row) * (ne0 / 32) + kt]; b.qs[col0] = tile_src[cp * 64 + 2 * row + 0]; b.qs[col1] = tile_src[cp * 64 + 2 * row + 1]; } } } const ggml_half * scale_src = (const ggml_half *)(tile_src + 1024); for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { dst_slice[(r - start_row) * (ne0 / 32) + kt].d = scale_src[row]; } } } } } } // repack mxfp4 data into mxfp4_tiled tensor static void repack_mxfp4_tiled(ggml_tensor * t, const void * data, size_t offset, size_t size) { const block_mxfp4 * src_matrix = (const block_mxfp4 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_MXFP4; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { const block_mxfp4 * src_slice = src_matrix + (slice_idx - start_slice) * (ne1 * (ne0 / 32)); uint8_t * matrix_dst = (uint8_t *) t->data + slice_idx * matrix_size; for (int ct = 0; ct < n_col_tiles; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { uint8_t * tile_dst = matrix_dst + (ct * n_k_tiles + kt) * tile_size; uint8_t tile_quants[32][32]; for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r < ne1 && kt < ne0 / 32) { unpack_mxfp4_quants(tile_quants[row], &src_slice[r * (ne0 / 32) + kt], 0); } else { memset(tile_quants[row], 0, 32); } } for (int cp = 0; cp < 16; cp++) { for (int row = 0; row < 32; row++) { tile_dst[cp * 32 + row] = (tile_quants[row][2 * cp + 1] << 4) | tile_quants[row][2 * cp]; } } uint8_t * scale_dst = tile_dst + 512; for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; scale_dst[row] = (r < ne1 && kt < ne0 / 32) ? src_slice[r * (ne0 / 32) + kt].e : 0; } } } } } // repack mxfp4_tiled tensor into mxfp4 data static void repack_tiled_mxfp4(void * data, const ggml_tensor * t, size_t offset, size_t size) { block_mxfp4 * dst_matrix = (block_mxfp4 *) data; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; int64_t ne0_padded = hex_round_up(ne0, 32); int64_t ne1_padded = hex_round_up(ne1, 32); int n_col_tiles = ne1_padded / 32; int n_k_tiles = ne0_padded / 32; const size_t tile_size = HTP_MM_WEIGHT_TILE_SIZE_MXFP4; const size_t matrix_size = n_col_tiles * n_k_tiles * tile_size; size_t slice_size = ne1 * ggml_row_size(t->type, ne0); size_t row_size_bytes = ggml_row_size(t->type, ne0); int64_t start_slice = offset / slice_size; int64_t end_slice = (offset + size + slice_size - 1) / slice_size; if (end_slice > ne2 * ne3) { end_slice = ne2 * ne3; } for (int64_t slice_idx = start_slice; slice_idx < end_slice; slice_idx++) { size_t cur_start_byte = (std::max)(offset, (size_t) slice_idx * slice_size); size_t cur_end_byte = (std::min)(offset + size, (size_t) (slice_idx + 1) * slice_size); size_t slice_offset_start = cur_start_byte - (size_t) slice_idx * slice_size; size_t slice_offset_end = cur_end_byte - (size_t) slice_idx * slice_size; int64_t start_row = slice_offset_start / row_size_bytes; int64_t end_row = (slice_offset_end + row_size_bytes - 1) / row_size_bytes; end_row = (std::min)(end_row, ne1); int start_ct = start_row / 32; int end_ct = (end_row + 31) / 32; end_ct = (std::min)(end_ct, n_col_tiles); block_mxfp4 * dst_slice = dst_matrix + (cur_start_byte - offset) / sizeof(block_mxfp4); const uint8_t * matrix_src = (const uint8_t *) t->data + slice_idx * matrix_size; for (int ct = start_ct; ct < end_ct; ct++) { for (int kt = 0; kt < n_k_tiles; kt++) { const uint8_t * tile_src = matrix_src + (ct * n_k_tiles + kt) * tile_size; uint8_t tile_quants[32][32]; for (int cp = 0; cp < 16; cp++) { for (int row = 0; row < 32; row++) { uint8_t val = tile_src[cp * 32 + row]; tile_quants[row][2 * cp + 0] = val & 0x0F; tile_quants[row][2 * cp + 1] = val >> 4; } } for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { pack_mxfp4_quants(&dst_slice[(r - start_row) * (ne0 / 32) + kt], tile_quants[row], 0); } } const uint8_t * scale_src = tile_src + 512; for (int row = 0; row < 32; row++) { int64_t r = ct * 32 + row; if (r >= start_row && r < end_row && kt < ne0 / 32) { dst_slice[(r - start_row) * (ne0 / 32) + kt].e = scale_src[row]; } } } } } } static void repack_tensor_tiled(ggml_tensor * tensor, const void * data, size_t size) { switch (tensor->type) { case GGML_TYPE_Q4_0: repack_q4_0_tiled(tensor, data, 0, size); break; case GGML_TYPE_Q4_1: repack_q4_1_tiled(tensor, data, 0, size); break; case GGML_TYPE_Q8_0: repack_q8_0_tiled(tensor, data, 0, size); break; case GGML_TYPE_IQ4_NL: repack_q4_0_tiled(tensor, data, 0, size); break; case GGML_TYPE_MXFP4: repack_mxfp4_tiled(tensor, data, 0, size); break; default: break; } } static void ggml_backend_hexagon_buffer_set_tensor(ggml_backend_buffer_t buffer, ggml_tensor * tensor, const void * data, size_t offset, size_t size) { auto extra = (ggml_hexagon_tensor_extra *) tensor->extra; auto sbuf = (ggml_hexagon_shared_buffer *) buffer->context; auto sess = sbuf->sess; if (ggml_backend_buffer_get_usage(buffer) == GGML_BACKEND_BUFFER_USAGE_WEIGHTS) { extra->flags |= GGML_HEXAGON_TENSOR_WEIGHT; if (ggml_hexagon_is_repack_type(tensor->type)) { extra->flags |= GGML_HEXAGON_TENSOR_REPACK; } } HEX_VERBOSE("ggml-hex: %s set-tensor %s : data %p offset %zu size %zu usage %d flags 0x%x\n", sess->c_name(), tensor->name, data, offset, size, (int) buffer->usage, extra->flags); if ((extra->flags & GGML_HEXAGON_TENSOR_REPACK) == 0) { memcpy((char *) tensor->data + offset, data, size); return; } if (offset == 0 && size == ggml_nbytes(tensor) && extra->shadow_buf.empty()) { repack_tensor_tiled(tensor, data, size); return; } if (extra->shadow_buf.size() < ggml_nbytes(tensor)) { extra->shadow_buf.resize(ggml_nbytes(tensor)); } memcpy(extra->shadow_buf.data() + offset, data, size); extra->shadow_size += size; if (extra->shadow_size >= ggml_nbytes(tensor)) { repack_tensor_tiled(tensor, extra->shadow_buf.data(), extra->shadow_buf.size()); extra->shadow_buf.clear(); extra->shadow_buf.shrink_to_fit(); extra->shadow_size = 0; } } static void ggml_backend_hexagon_buffer_get_tensor(ggml_backend_buffer_t buffer, const ggml_tensor * tensor, void * data, size_t offset, size_t size) { auto extra = (ggml_hexagon_tensor_extra *) tensor->extra; auto sbuf = (ggml_hexagon_shared_buffer *) buffer->context; auto sess = sbuf->sess; HEX_VERBOSE("ggml-hex: %s get-tensor %s : data %p offset %zu size %zu usage %d flags 0x%x\n", sess->c_name(), tensor->name, data, offset, size, (int) buffer->usage, extra->flags); if ((extra->flags & GGML_HEXAGON_TENSOR_REPACK) == 0) { memcpy(data, (const char *) tensor->data + offset, size); return; } switch (tensor->type) { case GGML_TYPE_Q4_0: GGML_ASSERT(offset == 0); GGML_ASSERT(offset + size <= ggml_nbytes(tensor)); repack_tiled_q4_0(data, tensor, offset, size); break; case GGML_TYPE_Q4_1: GGML_ASSERT(offset == 0); GGML_ASSERT(offset + size <= ggml_nbytes(tensor)); repack_tiled_q4_1(data, tensor, offset, size); break; case GGML_TYPE_Q8_0: GGML_ASSERT(offset == 0); GGML_ASSERT(offset + size <= ggml_nbytes(tensor)); repack_tiled_q8_0(data, tensor, offset, size); break; case GGML_TYPE_IQ4_NL: GGML_ASSERT(offset == 0); GGML_ASSERT(offset + size <= ggml_nbytes(tensor)); repack_tiled_q4_0(data, tensor, offset, size); break; case GGML_TYPE_MXFP4: GGML_ASSERT(offset == 0); GGML_ASSERT(offset + size <= ggml_nbytes(tensor)); repack_tiled_mxfp4(data, tensor, offset, size); break; default: memcpy(data, (const char *) tensor->data + offset, size); break; } } static bool ggml_backend_hexagon_buffer_cpy_tensor(ggml_backend_buffer_t buffer, const struct ggml_tensor * src, struct ggml_tensor * dst) { // we might optimize this later, for now take the slow path (ie get/set_tensor) return false; GGML_UNUSED(buffer); GGML_UNUSED(src); GGML_UNUSED(dst); } static void ggml_backend_hexagon_buffer_set_tensor_2d(ggml_backend_buffer_t buffer, ggml_tensor * tensor, const void * data, size_t offset, size_t size, size_t n_copies, size_t stride_tensor, size_t stride_data) { auto extra = (ggml_hexagon_tensor_extra *) tensor->extra; auto sbuf = (ggml_hexagon_shared_buffer *) buffer->context; auto sess = sbuf->sess; if (ggml_backend_buffer_get_usage(buffer) == GGML_BACKEND_BUFFER_USAGE_WEIGHTS) { extra->flags |= GGML_HEXAGON_TENSOR_WEIGHT; if (ggml_hexagon_is_repack_type(tensor->type)) { extra->flags |= GGML_HEXAGON_TENSOR_REPACK; } } HEX_VERBOSE("ggml-hex: %s set-tensor-2d %s : data %p offset %zu size %zu n_copies %zu stride_tensor %zu stride_data %zu usage %d flags 0x%x\n", sess->c_name(), tensor->name, data, offset, size, n_copies, stride_tensor, stride_data, (int) buffer->usage, extra->flags); if ((extra->flags & GGML_HEXAGON_TENSOR_REPACK) == 0) { for (size_t i = 0; i < n_copies; i++) { memcpy((uint8_t *) tensor->data + offset + i * stride_tensor, (const uint8_t *) data + i * stride_data, size); } return; } if (extra->shadow_buf.size() < ggml_nbytes(tensor)) { extra->shadow_buf.resize(ggml_nbytes(tensor)); } for (size_t i = 0; i < n_copies; i++) { memcpy(extra->shadow_buf.data() + offset + i * stride_tensor, (const uint8_t *) data + i * stride_data, size); } extra->shadow_size += n_copies * size; if (extra->shadow_size >= ggml_nbytes(tensor)) { repack_tensor_tiled(tensor, extra->shadow_buf.data(), extra->shadow_buf.size()); extra->shadow_buf.clear(); extra->shadow_buf.shrink_to_fit(); extra->shadow_size = 0; } } static void ggml_backend_hexagon_buffer_get_tensor_2d(ggml_backend_buffer_t buffer, const ggml_tensor * tensor, void * data, size_t offset, size_t size, size_t n_copies, size_t stride_tensor, size_t stride_data) { auto extra = (ggml_hexagon_tensor_extra *) tensor->extra; auto sbuf = (ggml_hexagon_shared_buffer *) buffer->context; auto sess = sbuf->sess; HEX_VERBOSE("ggml-hex: %s get-tensor-2d %s : data %p offset %zu size %zu n_copies %zu stride_tensor %zu stride_data %zu usage %d\n", sess->c_name(), tensor->name, data, offset, size, n_copies, stride_tensor, stride_data, (int) buffer->usage); if ((extra->flags & GGML_HEXAGON_TENSOR_REPACK) == 0) { for (size_t i = 0; i < n_copies; i++) { memcpy((uint8_t *)data + i * stride_data, (const uint8_t *)tensor->data + offset + i * stride_tensor, size); } return; } size_t temp_size = n_copies > 0 ? (n_copies - 1) * stride_tensor + size : 0; size_t slice_size = tensor->ne[1] * ggml_row_size(tensor->type, tensor->ne[0]); size_t slice_offset = offset % slice_size; size_t row_size_bytes = ggml_row_size(tensor->type, tensor->ne[0]); GGML_ASSERT((slice_offset % row_size_bytes) == 0 && "offset must be aligned to row boundary"); GGML_ASSERT((temp_size % row_size_bytes) == 0 && "temp_size must be a multiple of row size"); GGML_ASSERT((slice_offset / row_size_bytes) % 32 == 0 && "offset must be aligned to tile size (32 rows)"); GGML_ASSERT((offset + temp_size) <= ggml_nbytes(tensor)); std::vector temp_buf(temp_size); switch (tensor->type) { case GGML_TYPE_Q4_0: repack_tiled_q4_0(temp_buf.data(), tensor, offset, temp_size); break; case GGML_TYPE_Q4_1: repack_tiled_q4_1(temp_buf.data(), tensor, offset, temp_size); break; case GGML_TYPE_Q8_0: repack_tiled_q8_0(temp_buf.data(), tensor, offset, temp_size); break; case GGML_TYPE_IQ4_NL: repack_tiled_q4_0(temp_buf.data(), tensor, offset, temp_size); break; case GGML_TYPE_MXFP4: repack_tiled_mxfp4(temp_buf.data(), tensor, offset, temp_size); break; default: memcpy(temp_buf.data(), (const uint8_t *) tensor->data + offset, temp_size); break; } for (size_t i = 0; i < n_copies; i++) { memcpy((uint8_t *) data + i * stride_data, temp_buf.data() + i * stride_tensor, size); } } static void ggml_backend_hexagon_buffer_clear(ggml_backend_buffer_t buffer, uint8_t value) { auto sbuf = (ggml_hexagon_shared_buffer *) buffer->context; auto sess = sbuf->sess; HEX_VERBOSE("ggml-hex: %s clear-buff base %p size %zu\n", sess->c_name(), (void *) sbuf->base(), sbuf->size()); memset(sbuf->base(), value, sbuf->size()); } static ggml_backend_buffer_i ggml_backend_hexagon_buffer_interface = { /* .free_buffer = */ ggml_backend_hexagon_buffer_free_buffer, /* .get_base = */ ggml_backend_hexagon_buffer_get_base, /* .init_tensor = */ ggml_backend_hexagon_buffer_init_tensor, /* .memset_tensor = */ NULL, /* .set_tensor = */ ggml_backend_hexagon_buffer_set_tensor, /* .get_tensor = */ ggml_backend_hexagon_buffer_get_tensor, /* .set_tensor_2d = */ ggml_backend_hexagon_buffer_set_tensor_2d, /* .get_tensor_2d = */ ggml_backend_hexagon_buffer_get_tensor_2d, /* .cpy_tensor = */ ggml_backend_hexagon_buffer_cpy_tensor, /* .clear = */ ggml_backend_hexagon_buffer_clear, /* .reset = */ NULL, }; // ** backend buffer type static void ggml_backend_hexagon_host_buffer_set_tensor(ggml_backend_buffer_t buffer, ggml_tensor * tensor, const void * data, size_t offset, size_t size) { memcpy((char *) tensor->data + offset, data, size); GGML_UNUSED(buffer); } static void ggml_backend_hexagon_host_buffer_get_tensor(ggml_backend_buffer_t buffer, const ggml_tensor * tensor, void * data, size_t offset, size_t size) { memcpy(data, (const char *) tensor->data + offset, size); GGML_UNUSED(buffer); } static ggml_backend_buffer_i ggml_backend_hexagon_host_buffer_interface = { /* .free_buffer = */ ggml_backend_hexagon_buffer_free_buffer, /* .get_base = */ ggml_backend_hexagon_buffer_get_base, /* .init_tensor = */ ggml_backend_hexagon_buffer_init_tensor, /* .memset_tensor = */ NULL, /* .set_tensor = */ ggml_backend_hexagon_host_buffer_set_tensor, /* .get_tensor = */ ggml_backend_hexagon_host_buffer_get_tensor, /* .set_tensor_2d = */ NULL, /* .get_tensor_2d = */ NULL, /* .cpy_tensor = */ ggml_backend_hexagon_buffer_cpy_tensor, /* .clear = */ ggml_backend_hexagon_buffer_clear, /* .reset = */ NULL, }; // ** backend buffer type static const char * ggml_backend_hexagon_buffer_type_name(ggml_backend_buffer_type_t buffer_type) { return static_cast(buffer_type->context)->name.c_str(); } static ggml_backend_buffer_t ggml_backend_hexagon_buffer_type_alloc_buffer( ggml_backend_buffer_type_t buffer_type, size_t size) { auto sess = static_cast(buffer_type->context)->sess; try { ggml_hexagon_shared_buffer * sbuf = new ggml_hexagon_shared_buffer(sess, size, false, GGML_HEXAGON_FENCE_BUFFER_SIZE); return ggml_backend_buffer_init(buffer_type, ggml_backend_hexagon_buffer_interface, sbuf, size); } catch (const std::exception & exc) { GGML_LOG_ERROR("ggml-hex: %s failed to allocate device buffer context: %s\n", sess->c_name(), exc.what()); return nullptr; } } static ggml_backend_buffer_t ggml_backend_hexagon_host_buffer_type_alloc_buffer( ggml_backend_buffer_type_t buffer_type, size_t size) { auto sess = static_cast(buffer_type->context)->sess; try { ggml_hexagon_shared_buffer * sbuf = new ggml_hexagon_shared_buffer(sess, size, false, GGML_HEXAGON_FENCE_BUFFER_SIZE); return ggml_backend_buffer_init(buffer_type, ggml_backend_hexagon_host_buffer_interface, sbuf, size); } catch (const std::exception & exc) { GGML_LOG_ERROR("ggml-hex: %s failed to allocate host buffer context: %s\n", sess->c_name(), exc.what()); return nullptr; } } static size_t ggml_backend_hexagon_buffer_type_get_alignment(ggml_backend_buffer_type_t buft) { return 128; // HVX alignment GGML_UNUSED(buft); } static size_t ggml_backend_hexagon_buffer_type_get_alloc_size(ggml_backend_buffer_type_t buft, const struct ggml_tensor * t) { if (ggml_hexagon_is_repack_type(t->type)) { int64_t ne0 = hex_round_up(t->ne[0], 32); int64_t ne1 = hex_round_up(t->ne[1], 32); int64_t ne2 = t->ne[2]; int64_t ne3 = t->ne[3]; return ggml_row_size(t->type, ne0) * ne1 * ne2 * ne3; } return ggml_nbytes(t); GGML_UNUSED(buft); } static size_t ggml_backend_hexagon_buffer_type_get_max_size(ggml_backend_buffer_type_t buft) { auto * context = static_cast(buft->context); return context->sess->max_bufsize; } static bool ggml_backend_hexagon_buffer_type_is_host(ggml_backend_buffer_type_t buft) { return false; GGML_UNUSED(buft); } static bool ggml_backend_hexagon_host_buffer_type_is_host(ggml_backend_buffer_type_t buft) { return true; GGML_UNUSED(buft); } static ggml_backend_buffer_type_i ggml_backend_hexagon_buffer_type_interface = { /* .get_name = */ ggml_backend_hexagon_buffer_type_name, /* .alloc_buffer = */ ggml_backend_hexagon_buffer_type_alloc_buffer, /* .get_alignment = */ ggml_backend_hexagon_buffer_type_get_alignment, /* .get_max_size = */ ggml_backend_hexagon_buffer_type_get_max_size, /* .get_alloc_size = */ ggml_backend_hexagon_buffer_type_get_alloc_size, /* .is_host = */ ggml_backend_hexagon_buffer_type_is_host, }; static ggml_backend_buffer_type_i ggml_backend_hexagon_host_buffer_type_interface = { /* .get_name = */ ggml_backend_hexagon_buffer_type_name, /* .alloc_buffer = */ ggml_backend_hexagon_host_buffer_type_alloc_buffer, /* .get_alignment = */ ggml_backend_hexagon_buffer_type_get_alignment, /* .get_max_size = */ ggml_backend_hexagon_buffer_type_get_max_size, /* .get_alloc_size = */ ggml_backend_hexagon_buffer_type_get_alloc_size, /* .is_host = */ ggml_backend_hexagon_host_buffer_type_is_host, }; static bool ggml_backend_buffer_is_hexagon(const struct ggml_backend_buffer * b) { return b->buft->iface.get_alignment == ggml_backend_hexagon_buffer_type_get_alignment; } struct ggml_hexagon_opbatch { ggml_hexagon_session* sess; std::vector ops; // htp_opnode of ops std::vector h_bufs; // htp buffer descriptors std::vector h_tens; // htp tensor descriptors std::vector h_ops; // htp op descriptors std::unordered_map b_map; // buffer fd to index std::unordered_map t_map; // tensor ptr to index std::unordered_multimap d_map; // tensor data to index unsigned int n_bufs; // num buffers in the batch unsigned int n_tens; // num tensors ... unsigned int n_ops; // num ops ... size_t b_vmem; // sum of all buffer sizes unsigned int n_bufs_max; unsigned int n_tens_max; unsigned int n_ops_max; size_t b_vmem_max; void reset() { n_bufs = 0; n_tens = 0; n_ops = 0; b_vmem = 0; b_map.clear(); t_map.clear(); d_map.clear(); ops.resize(n_ops_max); } ggml_hexagon_opbatch(ggml_hexagon_session *sess, size_t batch_size, size_t max_vmem) { this->sess = sess; n_bufs_max = HTP_OP_MAX_BUFS; n_ops_max = batch_size; n_tens_max = std::min(n_ops_max + n_ops_max * HTP_OP_MAX_INPUTS, HTP_OP_MAX_TENSORS); b_vmem_max = max_vmem; ops.resize(n_ops_max); h_bufs.resize(n_bufs_max); h_tens.resize(n_tens_max); h_ops.resize(n_ops_max); b_map.reserve(n_bufs_max); t_map.reserve(n_tens_max); d_map.reserve(n_tens_max); GGML_LOG_INFO("ggml-hex: %s op batching: n-bufs %u n-tensors %u n-ops %u vmem %zu\n", sess->c_name(), n_bufs_max, n_tens_max, n_ops_max, b_vmem_max); reset(); } bool empty() const { return n_ops == 0; } // add buffer and return its index int add_buffer(ggml_hexagon_shared_buffer * sbuf) { // Lookup by fd auto it = b_map.find(sbuf->fd()); if (it != b_map.end()) { return it->second; } // Add new buffer to the batch int bi = n_bufs++; GGML_ASSERT(n_bufs < HTP_OP_MAX_BUFS); b_map.insert({sbuf->fd(), bi}); htp_buf_desc &b = h_bufs[bi]; b.base = (uint64_t) sbuf->base(); b.fd = sbuf->fd(); b.size = sbuf->size(); b_vmem += b.size; HEX_VERBOSE("ggml-hex: %s add-buffer #%u : fd %d base %p size %zu : vmem %zu\n", sess->c_name(), bi, b.fd, (void*) sbuf->base(), (size_t) b.size, b_vmem); return bi; } bool same_shape(const htp_tensor * h, const ggml_tensor * t) const { auto extra = (ggml_hexagon_tensor_extra *) t->extra; int64_t ne0 = t->ne[0]; int64_t ne1 = t->ne[1]; const bool is_repack = (extra->flags & GGML_HEXAGON_TENSOR_REPACK) != 0; if (is_repack) { ne0 = hex_round_up(ne0, 32); ne1 = hex_round_up(ne1, 32); } int64_t nb1 = is_repack ? ggml_row_size(t->type, ne0) : t->nb[1]; int64_t nb2 = is_repack ? nb1 * ne1 : t->nb[2]; int64_t nb3 = is_repack ? nb2 * t->ne[2] : t->nb[3]; return (h->type == t->type) && (h->ne[0] == ne0) && (h->ne[1] == ne1) && (h->ne[2] == t->ne[2]) && (h->ne[3] == t->ne[3]) && (h->nb[0] == t->nb[0]) && (h->nb[1] == nb1) && (h->nb[2] == nb2) && (h->nb[3] == nb3); } // add tensor and return its index int add_tensor(const ggml_tensor * t) { auto extra = (ggml_hexagon_tensor_extra *) t->extra; auto sbuf = static_cast(t->buffer->context); // First lookup by tensor data auto range = d_map.equal_range(t->data); for (auto it = range.first; it != range.second; ++it) { htp_tensor * h = &h_tens[it->second]; if (same_shape(h, t)) { return it->second; } } // Lookup by tensor ptr auto it = t_map.find(t); if (it != t_map.end()) { return it->second; } // Add new tensor to the batch int ti = n_tens++; GGML_ASSERT(n_tens <= n_tens_max); t_map.insert({t, ti}); d_map.insert({t->data, ti}); uint64_t t_offset = (uint8_t *) t->data - sbuf->base(); size_t t_size = ggml_nbytes(t); htp_tensor &h = h_tens[ti]; h.bi = add_buffer(sbuf); h.ti = ti; h.data = t_offset; h.type = t->type; const bool is_repack = (extra->flags & GGML_HEXAGON_TENSOR_REPACK) != 0; if (is_repack) { h.ne[0] = hex_round_up(t->ne[0], 32); h.ne[1] = hex_round_up(t->ne[1], 32); h.ne[2] = t->ne[2]; h.ne[3] = t->ne[3]; h.nb[0] = t->nb[0]; h.nb[1] = ggml_row_size(t->type, h.ne[0]); h.nb[2] = h.nb[1] * h.ne[1]; h.nb[3] = h.nb[2] * h.ne[2]; h.size = h.nb[3] * h.ne[3]; t_size = h.size; } else { h.size = t_size; h.ne[0] = t->ne[0]; h.ne[1] = t->ne[1]; h.ne[2] = t->ne[2]; h.ne[3] = t->ne[3]; h.nb[0] = t->nb[0]; h.nb[1] = t->nb[1]; h.nb[2] = t->nb[2]; h.nb[3] = t->nb[3]; } h.flags = 0; if ((extra->flags & GGML_HEXAGON_TENSOR_WEIGHT) != 0) { h.flags |= HTP_TENSOR_WEIGHT; } if ((extra->flags & GGML_HEXAGON_TENSOR_REPACK) != 0) { h.flags |= HTP_TENSOR_REPACK; } if ((extra->flags & GGML_HEXAGON_TENSOR_FENCE) != 0) { h.flags |= HTP_TENSOR_FENCE; } HEX_VERBOSE("ggml-hex: %s add-tensor #%u %s : bi %d data %p offset %zu size %zu flags 0x%x : %zu:%zu:%zu:%zu\n", sess->c_name(), ti, t->name, h.bi, (void*) t->data, (size_t) t_offset, t_size, h.flags, (size_t) h.ne[0], (size_t) h.ne[1], (size_t) h.ne[2], (size_t) h.ne[3]); return ti; } bool fit_op(const htp_opnode & node) const { if (n_ops >= n_ops_max ) return false; // check how much extras we will need size_t extra_bufs = 0; size_t extra_vmem = 0; size_t extra_tens = 0; auto fit_tensor = [&](const ggml_tensor *t) { if (!t) return; if (!t_map.count(t)) { extra_tens++; auto sbuf = static_cast(t->buffer->context); if (!b_map.count(sbuf->fd())) { extra_vmem += sbuf->size(); extra_bufs += 1; } } }; for (const auto * src : node.get_inputs()) { fit_tensor(src); } for (const auto * output : node.get_outputs()) { fit_tensor(output); } if ((extra_bufs + n_bufs) > n_bufs_max) return false; if ((extra_tens + n_tens) > n_tens_max) return false; if ((extra_vmem + b_vmem) > b_vmem_max) return false; return true; } // assumes that fit_op() was called first and returned true void add_op(const htp_opnode & node) { // Add new op unsigned int n = n_ops++; GGML_ASSERT(n_ops <= n_ops_max); ops[n] = node; htp_op_desc &o = h_ops[n]; memcpy(o.params, node.node->op_params, sizeof(node.node->op_params)); memcpy(o.kernel_params, node.kernel_params, sizeof(o.kernel_params)); o.opcode = node.opcode; o.flags = 0; ggml_hexagon_dump_op_exec(sess->c_name(), ops[n], o.flags); auto inputs = node.get_inputs(); for (unsigned int i=0; i < HTP_OP_MAX_INPUTS; i++) { o.src[i] = (i < inputs.size() && inputs[i]) ? add_tensor(inputs[i]) : 0xffff; } auto outputs = node.get_outputs(); for (unsigned int i=0; i < HTP_OP_MAX_OUTPUTS; i++) { o.dst[i] = (i < outputs.size() && outputs[i]) ? add_tensor(outputs[i]) : 0xffff; } } bool try_fuse_allreduce_add(const htp_opnode & node) { if (n_ops == 0 || opt_ar_select != 2) return false; if (node.opcode != HTP_OP_ADD) return false; htp_opnode & last_node = ops[n_ops - 1]; if (last_node.opcode != HTP_OP_ALLREDUCE) return false; auto * ar_kparams = (struct htp_allreduce_kernel_params *) last_node.kernel_params; const uint32_t rank = (uint32_t) ar_kparams->rank; const ggml_tensor * ar_local = (rank < last_node.inputs.size()) ? last_node.inputs[rank] : nullptr; const ggml_tensor * add_src0 = node.src0(); const ggml_tensor * add_src1 = node.src1(); if (!add_src0 || !add_src1 || !ar_local) return false; if (!ggml_hexagon_tensor_is_fuseable(ar_local)) return false; const ggml_tensor * res_tensor = nullptr; if (add_src0 == ar_local || add_src0->data == ar_local->data) { res_tensor = add_src1; } else if (add_src1 == ar_local || add_src1->data == ar_local->data) { res_tensor = add_src0; } else { return false; } if (!res_tensor || !res_tensor->data) return false; if (ar_local->type != res_tensor->type) return false; const bool is_same_shape = (ar_local->ne[0] == res_tensor->ne[0] && ar_local->ne[1] == res_tensor->ne[1] && ar_local->ne[2] == res_tensor->ne[2] && ar_local->ne[3] == res_tensor->ne[3]); const bool is_row_bcast = (ar_local->ne[0] == res_tensor->ne[0] && res_tensor->ne[1] == 1 && res_tensor->ne[2] == 1 && res_tensor->ne[3] == 1); if (!is_same_shape && !is_row_bcast) return false; if (is_same_shape) { if (ar_local->nb[1] != res_tensor->nb[1] || ar_local->nb[2] != res_tensor->nb[2] || ar_local->nb[3] != res_tensor->nb[3]) { return false; } if (ggml_is_contiguous(ar_local) != ggml_is_contiguous(res_tensor)) { return false; } } if (ggml_is_contiguous(ar_local) != ggml_is_contiguous(node.dst())) { return false; } struct htp_allreduce_kernel_params new_kparams; if (!ggml_hexagon_precompute_allreduce_params( sess, node.dst(), (uint32_t) ar_kparams->rank, (uint32_t) ar_kparams->n_ranks, true, is_row_bcast, &new_kparams )) { HEX_VERBOSE("ggml-hex: %s skip ALLREDUCE_ADD fusion: solver failed\n", sess->c_name()); return false; } size_t extra_bufs = 0, extra_vmem = 0, extra_tens = 0; auto fit_t = [&](const ggml_tensor * t) { if (!t) return; if (!t_map.count(t)) { extra_tens++; auto sbuf = static_cast(t->buffer->context); if (!b_map.count(sbuf->fd())) { extra_vmem += sbuf->size(); extra_bufs += 1; } } }; fit_t(res_tensor); fit_t(node.dst()); if ((extra_bufs + n_bufs) > n_bufs_max || (extra_tens + n_tens) > n_tens_max || (extra_vmem + b_vmem) > b_vmem_max) { return false; } last_node.opcode = HTP_OP_ALLREDUCE_ADD; last_node.name = "ALLREDUCE+ADD"; last_node.inputs.push_back(res_tensor); last_node.outputs.clear(); last_node.outputs.push_back(node.dst()); last_node.fused.push_back(node.node); memcpy(last_node.kernel_params, &new_kparams, sizeof(new_kparams)); htp_op_desc & o = h_ops[n_ops - 1]; o.opcode = HTP_OP_ALLREDUCE_ADD; memcpy(o.kernel_params, &new_kparams, sizeof(new_kparams)); const uint32_t n_ranks = (uint32_t) ar_kparams->n_ranks; o.src[2 * n_ranks] = add_tensor(res_tensor); o.dst[0] = add_tensor(node.dst()); for (uint32_t d = 1; d < HTP_OP_MAX_OUTPUTS; d++) { o.dst[d] = 0xffff; } HEX_VERBOSE("ggml-hex: %s fused ALLREDUCE+ADD (#%u)\n", sess->c_name(), n_ops - 1); return true; } bool try_fuse_rms_norm_mul(const htp_opnode & node) { if (n_ops == 0) return false; if (node.opcode != HTP_OP_MUL) return false; htp_opnode & last_node = ops[n_ops - 1]; if (last_node.opcode != HTP_OP_RMS_NORM) return false; const ggml_tensor * mul_src0 = node.src0(); const ggml_tensor * mul_src1 = node.src1(); const ggml_tensor * rms_out = last_node.dst(); if (!mul_src0 || !mul_src1 || !rms_out) return false; if (!ggml_hexagon_tensor_is_fuseable(rms_out)) return false; const ggml_tensor * weight = nullptr; if (mul_src0 == rms_out || mul_src0->data == rms_out->data) { weight = mul_src1; } else if (mul_src1 == rms_out || mul_src1->data == rms_out->data) { weight = mul_src0; } else { return false; } if (!weight || !weight->data) return false; const ggml_tensor * src0 = last_node.src0(); if (!src0 || !src0->data) return false; if (src0->ne[0] != weight->ne[0] || src0->ne[0] != node.dst()->ne[0]) { return false; } const bool is_row_bcast = (weight->ne[1] == 1 && weight->ne[2] == 1 && weight->ne[3] == 1); const bool is_same_shape = (src0->ne[0] == weight->ne[0] && src0->ne[1] == weight->ne[1] && src0->ne[2] == weight->ne[2] && src0->ne[3] == weight->ne[3]); if (!is_row_bcast && !is_same_shape) return false; if (!ggml_are_same_shape(src0, node.dst())) { return false; } if (ggml_is_contiguous(src0) != ggml_is_contiguous(node.dst())) { return false; } struct htp_unary_kernel_params new_kparams; ggml_hexagon_precompute_unary_params( sess, HTP_OP_RMS_NORM_MUL, src0, weight, node.dst(), &new_kparams ); if ((size_t) new_kparams.vtcm_size > sess->vtcm_size) { HEX_VERBOSE("ggml-hex: %s skip RMS_NORM_MUL fusion: VTCM needed (%d) > budget (%zu)\n", sess->c_name(), new_kparams.vtcm_size, sess->vtcm_size); return false; } size_t extra_bufs = 0, extra_vmem = 0, extra_tens = 0; auto fit_t = [&](const ggml_tensor * t) { if (!t) return; if (!t_map.count(t)) { extra_tens++; auto sbuf = static_cast(t->buffer->context); if (!b_map.count(sbuf->fd())) { extra_vmem += sbuf->size(); extra_bufs += 1; } } }; fit_t(weight); fit_t(node.dst()); if ((extra_bufs + n_bufs) > n_bufs_max || (extra_tens + n_tens) > n_tens_max || (extra_vmem + b_vmem) > b_vmem_max) { return false; } last_node.opcode = HTP_OP_RMS_NORM_MUL; last_node.name = "RMS_NORM+MUL"; last_node.inputs.clear(); last_node.inputs.push_back(src0); last_node.inputs.push_back(weight); last_node.outputs.clear(); last_node.outputs.push_back(node.dst()); last_node.fused.push_back(node.node); memcpy(last_node.kernel_params, &new_kparams, sizeof(new_kparams)); htp_op_desc & o = h_ops[n_ops - 1]; o.opcode = HTP_OP_RMS_NORM_MUL; memcpy(o.kernel_params, &new_kparams, sizeof(new_kparams)); o.src[0] = add_tensor(src0); o.src[1] = add_tensor(weight); for (uint32_t s = 2; s < HTP_OP_MAX_INPUTS; s++) { o.src[s] = 0xffff; } o.dst[0] = add_tensor(node.dst()); for (uint32_t d = 1; d < HTP_OP_MAX_OUTPUTS; d++) { o.dst[d] = 0xffff; } HEX_VERBOSE("ggml-hex: %s fused RMS_NORM+MUL (#%u)\n", sess->c_name(), n_ops - 1); return true; } bool try_fuse_mul_mat_add(const htp_opnode & node) { if (n_ops == 0) return false; if (node.opcode != HTP_OP_ADD) return false; htp_opnode & last_node = ops[n_ops - 1]; if (last_node.opcode != HTP_OP_MUL_MAT) return false; const ggml_tensor * add_src0 = node.src0(); const ggml_tensor * add_src1 = node.src1(); const ggml_tensor * mm_out = last_node.dst(); if (!add_src0 || !add_src1 || !mm_out) return false; if (!ggml_hexagon_tensor_is_fuseable(mm_out)) return false; const ggml_tensor * src2 = nullptr; if (add_src0 == mm_out || add_src0->data == mm_out->data) { src2 = add_src1; } else if (add_src1 == mm_out || add_src1->data == mm_out->data) { src2 = add_src0; } else { return false; } if (!src2 || !src2->data) return false; const ggml_tensor * src0 = last_node.src0(); const ggml_tensor * src1 = last_node.src1(); if (!src0 || !src1) return false; struct htp_mm_kernel_params kparams; ggml_hexagon_precompute_fused_matmul_add_params(sess, src0, src1, src2, node.dst(), &kparams); const int src1_nrows = src1->ne[1] * src1->ne[2] * src1->ne[3]; const bool can_fuse = (kparams.n_hmx > 0) || (src1_nrows == 1); if (!can_fuse) return false; if ((size_t) kparams.vtcm_size > sess->vtcm_size) { HEX_VERBOSE("ggml-hex: %s skip MUL_MAT_ADD fusion: VTCM needed (%d) > budget (%zu)\n", sess->c_name(), kparams.vtcm_size, sess->vtcm_size); return false; } size_t extra_bufs = 0, extra_vmem = 0, extra_tens = 0; auto fit_t = [&](const ggml_tensor * t) { if (!t) return; if (!t_map.count(t)) { extra_tens++; auto sbuf = static_cast(t->buffer->context); if (!b_map.count(sbuf->fd())) { extra_vmem += sbuf->size(); extra_bufs += 1; } } }; fit_t(src2); fit_t(node.dst()); if ((extra_bufs + n_bufs) > n_bufs_max || (extra_tens + n_tens) > n_tens_max || (extra_vmem + b_vmem) > b_vmem_max) { return false; } last_node.opcode = HTP_OP_MUL_MAT_ADD; last_node.name = "MUL_MAT+ADD"; last_node.inputs.clear(); last_node.inputs.push_back(src0); last_node.inputs.push_back(src1); last_node.inputs.push_back(src2); last_node.outputs.clear(); last_node.outputs.push_back(node.dst()); last_node.fused.push_back(node.node); memcpy(last_node.kernel_params, &kparams, sizeof(kparams)); htp_op_desc & o = h_ops[n_ops - 1]; o.opcode = HTP_OP_MUL_MAT_ADD; memcpy(o.kernel_params, &kparams, sizeof(kparams)); o.src[0] = add_tensor(src0); o.src[1] = add_tensor(src1); o.src[2] = add_tensor(src2); for (uint32_t s = 3; s < HTP_OP_MAX_INPUTS; s++) { o.src[s] = 0xffff; } o.dst[0] = add_tensor(node.dst()); for (uint32_t d = 1; d < HTP_OP_MAX_OUTPUTS; d++) { o.dst[d] = 0xffff; } HEX_VERBOSE("ggml-hex: %s fused MUL_MAT+ADD (#%u)\n", sess->c_name(), n_ops - 1); return true; } bool try_fuse_mul_mat_nx(const htp_opnode & node) { if (n_ops == 0 || node.opcode != HTP_OP_MUL_MAT) return false; if (!is_mergeable_mul_mat(node.node)) return false; const ggml_tensor * w_in = node.src0(); const ggml_tensor * x_in = node.src1(); const ggml_tensor * d_in = node.dst(); if (!w_in || !x_in || !d_in) return false; htp_opnode & last_node = ops[n_ops - 1]; // Case 1: last_node is already MUL_MAT_NX if (last_node.opcode == HTP_OP_MUL_MAT_NX) { const uint32_t curr_n = (uint32_t) last_node.outputs.size(); if (curr_n >= HTP_OP_MAX_OUTPUTS || curr_n + 1 >= HTP_OP_MAX_INPUTS) { return false; } const ggml_tensor * w0 = last_node.inputs[0]; const ggml_tensor * x = last_node.inputs[curr_n]; if (x_in != x || w_in->type != w0->type || w_in->ne[0] != w0->ne[0]) { return false; } struct htp_mm_kernel_params kparams; ggml_hexagon_precompute_fused_mmnx_params(sess, w0, x, curr_n + 1, &kparams); if ((size_t) kparams.vtcm_size > sess->vtcm_size) { HEX_VERBOSE("ggml-hex: %s skip NX fusion: VTCM needed (%d) > budget (%zu)\n", sess->c_name(), kparams.vtcm_size, sess->vtcm_size); return false; } size_t extra_bufs = 0, extra_vmem = 0, extra_tens = 0; auto fit_t = [&](const ggml_tensor * t) { if (!t) return; if (!t_map.count(t)) { extra_tens++; auto sbuf = static_cast(t->buffer->context); if (!b_map.count(sbuf->fd())) { extra_vmem += sbuf->size(); extra_bufs += 1; } } }; fit_t(w_in); fit_t(d_in); if ((extra_bufs + n_bufs) > n_bufs_max || (extra_tens + n_tens) > n_tens_max || (extra_vmem + b_vmem) > b_vmem_max) { return false; } last_node.inputs[curr_n] = w_in; last_node.inputs.push_back(x); last_node.outputs.push_back(d_in); last_node.fused.push_back(node.node); memcpy(last_node.kernel_params, &kparams, sizeof(kparams)); htp_op_desc & o = h_ops[n_ops - 1]; memcpy(o.kernel_params, &kparams, sizeof(kparams)); for (uint32_t s = 0; s <= curr_n + 1; s++) { o.src[s] = add_tensor(last_node.inputs[s]); } for (uint32_t s = curr_n + 2; s < HTP_OP_MAX_INPUTS; s++) { o.src[s] = 0xffff; } for (uint32_t d = 0; d <= curr_n; d++) { o.dst[d] = add_tensor(last_node.outputs[d]); } for (uint32_t d = curr_n + 1; d < HTP_OP_MAX_OUTPUTS; d++) { o.dst[d] = 0xffff; } HEX_VERBOSE("ggml-hex: %s fused MUL_MAT_NX (N=%u, #%u)\n", sess->c_name(), curr_n + 1, n_ops - 1); return true; } // Case 2: last_node is single MUL_MAT if (last_node.opcode == HTP_OP_MUL_MAT) { if (!is_mergeable_mul_mat_pair(last_node.node, node.node)) { return false; } const ggml_tensor * w0 = last_node.src0(); const ggml_tensor * x = last_node.src1(); const ggml_tensor * w1 = node.src0(); if (!w0 || !x || !w1) return false; struct htp_mm_kernel_params kparams; ggml_hexagon_precompute_fused_mmnx_params(sess, w0, x, 2, &kparams); if ((size_t) kparams.vtcm_size > sess->vtcm_size) { HEX_VERBOSE("ggml-hex: %s skip NX fusion: VTCM needed (%d) > budget (%zu)\n", sess->c_name(), kparams.vtcm_size, sess->vtcm_size); return false; } size_t extra_bufs = 0, extra_vmem = 0, extra_tens = 0; auto fit_t = [&](const ggml_tensor * t) { if (!t) return; if (!t_map.count(t)) { extra_tens++; auto sbuf = static_cast(t->buffer->context); if (!b_map.count(sbuf->fd())) { extra_vmem += sbuf->size(); extra_bufs += 1; } } }; fit_t(w1); fit_t(node.dst()); if ((extra_bufs + n_bufs) > n_bufs_max || (extra_tens + n_tens) > n_tens_max || (extra_vmem + b_vmem) > b_vmem_max) { return false; } const ggml_tensor * dst_0 = last_node.dst(); const ggml_tensor * dst_1 = node.dst(); last_node.opcode = HTP_OP_MUL_MAT_NX; last_node.name = "MUL_MAT_NX"; last_node.inputs.clear(); last_node.inputs.push_back(w0); last_node.inputs.push_back(w1); last_node.inputs.push_back(x); last_node.outputs.clear(); last_node.outputs.push_back(dst_0); last_node.outputs.push_back(dst_1); last_node.fused.push_back(node.node); memcpy(last_node.kernel_params, &kparams, sizeof(kparams)); htp_op_desc & o = h_ops[n_ops - 1]; o.opcode = HTP_OP_MUL_MAT_NX; memcpy(o.kernel_params, &kparams, sizeof(kparams)); o.src[0] = add_tensor(w0); o.src[1] = add_tensor(w1); o.src[2] = add_tensor(x); for (uint32_t s = 3; s < HTP_OP_MAX_INPUTS; s++) { o.src[s] = 0xffff; } o.dst[0] = add_tensor(dst_0); o.dst[1] = add_tensor(dst_1); for (uint32_t d = 2; d < HTP_OP_MAX_OUTPUTS; d++) { o.dst[d] = 0xffff; } HEX_VERBOSE("ggml-hex: %s fused MUL_MAT_NX (N=2, #%u)\n", sess->c_name(), n_ops - 1); return true; } return false; } enum ggml_hexagon_fusion_flags { GGML_HEXAGON_FUSE_ALLREDUCE_ADD = (1 << 1), // 2 GGML_HEXAGON_FUSE_RMS_NORM_MUL = (1 << 2), // 4 GGML_HEXAGON_FUSE_MUL_MAT_ADD = (1 << 3), // 8 GGML_HEXAGON_FUSE_MUL_MAT_NX = (1 << 4), // 16 }; static inline bool ggml_hexagon_is_fusion_enabled(int flag) { if (opt_opfusion <= 0) return false; if (opt_opfusion == 1) return true; // 1 enables all return (opt_opfusion & flag) != 0; } bool try_fuse(const htp_opnode & node) { if (!opt_opfusion) return false; if (ggml_hexagon_is_fusion_enabled(GGML_HEXAGON_FUSE_ALLREDUCE_ADD) && try_fuse_allreduce_add(node)) return true; if (ggml_hexagon_is_fusion_enabled(GGML_HEXAGON_FUSE_RMS_NORM_MUL) && try_fuse_rms_norm_mul(node)) return true; if (ggml_hexagon_is_fusion_enabled(GGML_HEXAGON_FUSE_MUL_MAT_ADD) && try_fuse_mul_mat_add(node)) return true; if (ggml_hexagon_is_fusion_enabled(GGML_HEXAGON_FUSE_MUL_MAT_NX) && try_fuse_mul_mat_nx(node)) return true; return false; } }; struct ggml_hexagon_registry { ggml_hexagon_registry(ggml_backend_reg_t reg); ~ggml_hexagon_registry(); ggml_backend_device devices[GGML_HEXAGON_MAX_SESSIONS]; }; struct ggml_hexagon_opqueue { // Shared buffer for storing batches ggml_hexagon_shared_buffer *shm_buf; size_t shm_blk_size; uint64_t req_seq = 0; uint64_t rsp_seq = 0; using opvec = std::vector; std::queue done; // completed batch ids std::vector op_cache; // per batch op cache std::vector start_usec; // per batch start time ggml_hexagon_opqueue(ggml_hexagon_session *sess, size_t batch_size, size_t depth) { size_t n_bufs = HTP_OP_MAX_BUFS; size_t n_ops = batch_size; size_t n_tensors = n_ops * HTP_OP_MAX_OUTPUTS + n_ops * HTP_OP_MAX_INPUTS; size_t tr_size = 0; if (opt_profile == 3) { tr_size = (HTP_MAX_NTHREADS + 1) * opt_optrace * sizeof(htp_trace_desc); } shm_blk_size = sizeof(htp_buf_desc) * n_bufs + sizeof(htp_tensor) * n_tensors + sizeof(htp_op_desc) * n_ops + sizeof(htp_prof_desc) * n_ops + tr_size; shm_buf = new ggml_hexagon_shared_buffer(sess, shm_blk_size * depth, true /* pinned */); op_cache.resize(depth); start_usec.resize(depth, 0); // init done queue for (unsigned int i = 0; i < depth; i++) { done.push(i); } if (opt_verbose) { GGML_LOG_INFO("ggml-hex: %s allocated opqueue : batch-size %zu depth %zu shm-size %zu shm-block-size %zu\n", sess->c_name(), batch_size, depth, shm_buf->size(), shm_blk_size); } } ~ggml_hexagon_opqueue() { delete shm_buf; } // push new batch bool push(htp_opbatch_req& req, dspqueue_buffer& dbuf, ggml_hexagon_opbatch* op_batch) { static_assert(sizeof(htp_opbatch_req) % 8 == 0, "sizeof(htp_opbatch_req) must be multiple of 8"); static_assert(sizeof(htp_opbatch_rsp) % 8 == 0, "sizeof(htp_opbatch_rsp) must be multiple of 8"); static_assert(sizeof(htp_buf_desc) % 8 == 0, "sizeof(htp_buf_desc) must be multiple of 8"); static_assert(sizeof(htp_tensor) % 8 == 0, "sizeof(htp_tensor) must be multiple of 8"); static_assert(sizeof(htp_op_desc) % 8 == 0, "sizeof(htp_op_desc) must be multiple of 8"); static_assert(sizeof(htp_prof_desc) % 8 == 0, "sizeof(htp_prof_desc) must be multiple of 8"); if (done.empty()) { return false; } req.id = done.front(); done.pop(); // batch id req.n_bufs = op_batch->n_bufs; req.n_tensors = op_batch->n_tens; req.n_ops = op_batch->n_ops; req.seq = ++req_seq; op_cache[req.id] = std::move(op_batch->ops); start_usec[req.id] = ggml_time_us(); const size_t b_size = sizeof(htp_buf_desc) * req.n_bufs; const size_t t_size = sizeof(htp_tensor) * req.n_tensors; const size_t o_size = sizeof(htp_op_desc) * req.n_ops; const size_t p_size = sizeof(htp_prof_desc) * req.n_ops; size_t tr_size = 0; if (opt_profile == 3) { req.n_traces = opt_optrace; tr_size = (HTP_MAX_NTHREADS + 1) * req.n_traces * sizeof(htp_trace_desc); } else { req.n_traces = 0; } dbuf.ptr = shm_buf->base() + (req.id * shm_blk_size); dbuf.fd = shm_buf->fd(); dbuf.flags = DSPQUEUE_BUFFER_FLAG_FLUSH_SENDER | DSPQUEUE_BUFFER_FLAG_INVALIDATE_RECIPIENT; dbuf.offset = (uint8_t*) dbuf.ptr - (uint8_t*) shm_buf->base(); dbuf.size = b_size + t_size + o_size + p_size + tr_size; GGML_ASSERT(dbuf.size <= shm_blk_size); uint8_t * m_ptr = (uint8_t*) dbuf.ptr; uint8_t * b_ptr = m_ptr; m_ptr += b_size; uint8_t * t_ptr = m_ptr; m_ptr += t_size; uint8_t * o_ptr = m_ptr; memcpy(b_ptr, (void *) op_batch->h_bufs.data(), b_size); memcpy(t_ptr, (void *) op_batch->h_tens.data(), t_size); memcpy(o_ptr, (void *) op_batch->h_ops.data(), o_size); HEX_VERBOSE("ggml-hex: %s opqueue-push batch #%u : n-bufs %u n-tensors %u n-ops %u vmem %zu : b-size %zu t-size %zu o-size %zu m-size %zu\n", shm_buf->sess->c_name(), req.id, req.n_bufs, req.n_tensors, req.n_ops, op_batch->b_vmem, b_size, t_size, o_size, (size_t) dbuf.size); op_batch->reset(); if (opt_verbose > 1) { htp_buf_desc *b = (htp_buf_desc*) b_ptr; for (unsigned int i=0; i < req.n_bufs; i++) { GGML_LOG_DEBUG("ggml-hex: %s htp-buf #%u : fd %d base %p size %zu\n", shm_buf->sess->c_name(), i, b[i].fd, (void *) b[i].base, (size_t) b[i].size); } htp_tensor *t = (htp_tensor*) t_ptr; for (unsigned int i=0; i < req.n_tensors; i++) { GGML_LOG_DEBUG("ggml-hex: %s htp-tensor #%u : bi %u offset %u size %u : %zu:%zu:%zu:%zu\n", shm_buf->sess->c_name(), i, t[i].bi, t[i].data, t[i].size, (size_t) t[i].ne[0], (size_t) t[i].ne[1], (size_t) t[i].ne[2], (size_t) t[i].ne[3]); } } return true; } void pop(htp_opbatch_rsp rsp, dspqueue_buffer dbuf) { GGML_ASSERT(rsp.id < op_cache.size()); done.push(rsp.id); const size_t b_size = sizeof(htp_buf_desc) * rsp.n_bufs; const size_t t_size = sizeof(htp_tensor) * rsp.n_tensors; const size_t o_size = sizeof(htp_op_desc) * rsp.n_ops; const size_t p_size = sizeof(htp_prof_desc) * rsp.n_ops; size_t tr_size = 0; uint32_t n_traces = 0; if (opt_profile == 3) { n_traces = opt_optrace; tr_size = (HTP_MAX_NTHREADS + 1) * n_traces * sizeof(htp_trace_desc); } const size_t m_size = b_size + t_size + o_size + p_size + tr_size; GGML_ASSERT(m_size <= shm_blk_size); HEX_VERBOSE("ggml-hex: %s opqueue-pop batch #%u : n-bufs %u n-tensors %u n-ops %u : m-size %zu b-size %zu t-size %zu o-size %zu\n", shm_buf->sess->c_name(), rsp.id, rsp.n_bufs, rsp.n_tensors, rsp.n_ops, (size_t) dbuf.size, b_size, t_size, o_size); uint8_t * m_ptr = (uint8_t*) dbuf.ptr; uint8_t * p_ptr = m_ptr + (b_size + t_size + o_size); if (rsp.n_ops > 0) { auto & ops = op_cache[rsp.id]; GGML_ASSERT(rsp.n_ops <= ops.size()); const htp_prof_desc * pd = (const htp_prof_desc *) p_ptr; const htp_trace_desc * trace_events = nullptr; if (opt_profile == 3) { trace_events = (const htp_trace_desc *) (p_ptr + p_size); } if (opt_profile) { ggml_hexagon_dump_batch_prof(shm_buf->sess->name, rsp); } for (uint32_t i = 0; i < rsp.n_ops; i++) { if (opt_profile) { ggml_hexagon_dump_op_prof(shm_buf->sess->name, ops[i], pd[i]); } } if (opt_profile) { ggml_hexagon_dump_trace_events(shm_buf->sess->name, rsp, trace_events, n_traces); } } if (rsp.seq > rsp_seq) { rsp_seq = rsp.seq; } } }; // Flush HTP response queue i.e wait for all outstanding requests to complete void ggml_hexagon_session::flush_pending(bool all) { while (this->op_pending) { struct htp_opbatch_rsp rsp; uint32_t rsp_size; uint32_t flags; struct dspqueue_buffer dbuf; uint32_t n_dbufs; // Read response packet from queue const uint32_t timeo = opt_oppoll ? 0 : DSPQUEUE_TIMEOUT; int err = dspqueue_read(this->queue, &flags, 1, &n_dbufs, &dbuf, sizeof(rsp), &rsp_size, (uint8_t *) &rsp, timeo); if (err == AEE_EEXPIRED || err == AEE_EWOULDBLOCK) { continue; } if (err != 0) { GGML_ABORT("ggml-hex: dspqueue_read failed: 0x%08x\n", (unsigned) err); } // Basic sanity checks if (rsp_size != sizeof(rsp) || n_dbufs != 1) { GGML_ABORT("ggml-hex: %s dspcall : bad response : size %u dspbufs %u\n", this->c_name(), rsp_size, n_dbufs); } if (rsp.status != HTP_STATUS_OK) { GGML_LOG_ERROR("ggml-hex: %s dspcall : dsp-rsp: %s\n", this->c_name(), status_to_str(rsp.status)); // TODO: handle errors } op_queue->pop(rsp, dbuf); this->op_pending--; // atomic dec if (!all) break; } } void ggml_hexagon_session::flush_batch(size_t min_ops) { if (op_batch->n_ops < min_ops) { return; } htp_opbatch_req req {}; dspqueue_buffer dbuf{}; if (!op_queue->push(req, dbuf, op_batch)) { flush_pending(false); op_queue->push(req, dbuf, op_batch); } // Bump pending flag (cleared in the session::flush once we get the response) this->op_pending++; // atomic inc HEX_VERBOSE("ggml-hex: %s queue-opbatch: %p size %u\n", this->c_name(), dbuf.ptr, dbuf.size); int err = dspqueue_write(this->queue, 0, 1, &dbuf, sizeof(req), (const uint8_t*) &req, DSPQUEUE_TIMEOUT); if (err != 0) { GGML_ABORT("ggml-hex: %s dspqueue_write failed: 0x%08x\n", this->c_name(), (unsigned) err); } } void ggml_hexagon_session::flush(bool all) { flush_sync_peers(); flush_batch(); flush_pending(all); } void ggml_hexagon_session::enqueue_op(const htp_opnode & node) { for (auto t : node.get_inputs()) { if (t && t->buffer && ggml_backend_buffer_is_hexagon(t->buffer)) { if (ggml_backend_hexagon_buffer_get_sess(t->buffer) != this) { this->clone_buffer(static_cast(t->buffer->context)); } } } for (auto t : node.get_outputs()) { if (t && t->buffer && ggml_backend_buffer_is_hexagon(t->buffer)) { if (ggml_backend_hexagon_buffer_get_sess(t->buffer) != this) { this->clone_buffer(static_cast(t->buffer->context)); } } } if (opt_opfusion && op_batch->try_fuse(node)) { return; } if (!op_batch->fit_op(node)) { flush_batch(); } op_batch->add_op(node); } void ggml_hexagon_session::enqueue_cpy(const ggml_tensor * src, ggml_tensor * dst, const ggml_tensor * sync_tensor, uint32_t fence_seq) { htp_opnode cpy_node(HTP_OP_CPY); ggml_tensor* node = cpy_node.add_dummy(*dst); node->op = GGML_OP_CPY; node->src[0] = const_cast(src); node->src[1] = sync_tensor ? cpy_node.add_dummy(*sync_tensor) : nullptr; if (sync_tensor) { node->op_params[0] = (int32_t) fence_seq; } cpy_node.init(node); if (sync_tensor) { cpy_node.name = "CPY+FENCE"; } this->enqueue_op(cpy_node); } void ggml_hexagon_session::enqueue_fence(const ggml_tensor * sync_tensor, uint32_t fence_seq) { htp_opnode sync_node(HTP_OP_FENCE); ggml_tensor* node = sync_node.add_dummy(*sync_tensor); node->op = GGML_OP_NONE; node->src[0] = node; node->op_params[0] = (int32_t) fence_seq; sync_node.init(node); sync_node.name = "FENCE"; this->enqueue_op(sync_node); } static bool ggml_hexagon_precompute_allreduce_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * dst, uint32_t rank, uint32_t n_ranks, bool has_add, bool is_row_bcast, struct htp_allreduce_kernel_params * kparams ) { memset(kparams, 0, sizeof(*kparams)); kparams->rank = (int32_t) rank; kparams->n_ranks = (int32_t) n_ranks; kparams->is_row_bcast = (has_add && is_row_bcast) ? 1 : 0; const uint32_t n_bufs = n_ranks + 1 + (has_add ? 1 : 0); const uint32_t nelem = (uint32_t) ggml_nelements(dst); const uint32_t elem_size = (dst->type == GGML_TYPE_F16) ? sizeof(ggml_fp16_t) : sizeof(float); const bool is_contiguous = ggml_is_contiguous(dst); const uint32_t ne0 = (uint32_t) dst->ne[0]; const uint32_t ne1 = (uint32_t) (dst->ne[1] * dst->ne[2] * dst->ne[3]); kparams->ne0 = (int32_t) ne0; kparams->ne1 = (int32_t) ne1; const bool use_1d = is_contiguous && !(has_add && is_row_bcast && ne1 > 1); if (has_add) { kparams->n_dsts = 1; if (use_1d) { kparams->rank_elem_start = 0; kparams->rank_nelem = (int32_t) nelem; } else { kparams->rank_elem_start = 0; kparams->rank_nelem = (int32_t) ne1; } } else { kparams->n_dsts = (int32_t) n_ranks; if (use_1d) { const uint32_t rank_chunk_elems = hex_round_up((nelem + n_ranks - 1) / n_ranks, 128); const uint32_t rank_elem_start = (std::min)(rank * rank_chunk_elems, nelem); const uint32_t rank_elem_end = (std::min)(rank_elem_start + rank_chunk_elems, nelem); const uint32_t rank_nelem = rank_elem_end - rank_elem_start; kparams->rank_elem_start = (int32_t) rank_elem_start; kparams->rank_nelem = (int32_t) rank_nelem; } else { const uint32_t rank_chunk_rows = (ne1 + n_ranks - 1) / n_ranks; const uint32_t rank_r0 = (std::min)(rank * rank_chunk_rows, ne1); const uint32_t rank_r1 = (std::min)(rank_r0 + rank_chunk_rows, ne1); const uint32_t rank_nrows = rank_r1 - rank_r0; kparams->rank_elem_start = (int32_t) rank_r0; kparams->rank_nelem = (int32_t) rank_nrows; } } if (use_1d) { const uint32_t rank_nelem = (uint32_t) kparams->rank_nelem; const uint32_t n_threads = (std::min)((uint32_t) sess->n_threads, (std::max)(1u, rank_nelem / 128)); kparams->n_threads = n_threads; uint32_t block_elems = 65536; if (block_elems > rank_nelem / n_threads && rank_nelem / n_threads > 128) { block_elems = hex_round_up(rank_nelem / (n_threads * 2), 128); } block_elems = (std::max)(128u, block_elems); kparams->block_elems = block_elems; kparams->vtcm_size_per_thread = 2 * block_elems * elem_size; kparams->vtcm_size = n_threads * n_bufs * kparams->vtcm_size_per_thread; while ((size_t) kparams->vtcm_size > sess->vtcm_size && block_elems > 128) { const size_t max_bytes_per_buf = sess->vtcm_size / (n_threads * n_bufs * 2); block_elems = (uint32_t) hex_align_down((size_t) (max_bytes_per_buf / elem_size), 128); if (block_elems < 128) break; kparams->block_elems = block_elems; kparams->vtcm_size_per_thread = 2 * block_elems * elem_size; kparams->vtcm_size = n_threads * n_bufs * kparams->vtcm_size_per_thread; } if (sess->vtcm_size < (size_t) kparams->vtcm_size || block_elems < 128) { HEX_VERBOSE("ggml-hex: %s allreduce 1D solver failed to fit VTCM (%d > %zu)\n", sess->c_name(), kparams->vtcm_size, sess->vtcm_size); return false; } kparams->elems_per_thread = hex_round_up((rank_nelem + n_threads - 1) / n_threads, block_elems); kparams->kernel_type = HTP_ALLREDUCE_KERNEL_DMA_1D; return true; } else { const uint32_t rank_nrows = (uint32_t) kparams->rank_nelem; const uint32_t n_threads = (std::min)((uint32_t) sess->n_threads, (std::max)(1u, rank_nrows)); kparams->n_threads = n_threads; const uint32_t row_bytes = ne0 * elem_size; const uint32_t row_size_aligned = (uint32_t) hex_align_up(row_bytes, 128); kparams->row_size_aligned = row_size_aligned; const uint32_t nrows_per_thread = (rank_nrows + n_threads - 1) / n_threads; uint32_t block_rows = (std::min)(128u, nrows_per_thread); block_rows = (std::max)(1u, block_rows); kparams->block_elems = block_rows; kparams->vtcm_size_per_thread = 2 * (block_rows * row_size_aligned); kparams->vtcm_size = n_threads * n_bufs * kparams->vtcm_size_per_thread; while ((size_t) kparams->vtcm_size > sess->vtcm_size && block_rows > 1) { const size_t max_rows_per_buf = sess->vtcm_size / (n_threads * n_bufs * 2 * row_size_aligned); block_rows = (std::max)(1u, (uint32_t) max_rows_per_buf); kparams->block_elems = block_rows; kparams->vtcm_size_per_thread = 2 * (block_rows * row_size_aligned); kparams->vtcm_size = n_threads * n_bufs * kparams->vtcm_size_per_thread; if (max_rows_per_buf == 0) break; } if (sess->vtcm_size < (size_t) kparams->vtcm_size || block_rows < 1) { HEX_VERBOSE("ggml-hex: %s allreduce 2D solver failed to fit VTCM (%d > %zu)\n", sess->c_name(), kparams->vtcm_size, sess->vtcm_size); return false; } kparams->elems_per_thread = nrows_per_thread; kparams->kernel_type = HTP_ALLREDUCE_KERNEL_DMA_2D; return true; } } void ggml_hexagon_session::enqueue_allreduce( const ggml_tensor * dst, const std::vector & src_tensors, const std::vector & sync_tensors, uint32_t rank, uint32_t n_ranks, uint32_t fence_seq_entry, uint32_t fence_seq_exit ) { htp_opnode ar_node(HTP_OP_ALLREDUCE); ggml_tensor* node = ar_node.add_dummy(*dst); node->op = GGML_OP_NONE; node->op_params[0] = (int32_t) fence_seq_entry; node->op_params[1] = (int32_t) fence_seq_exit; ar_node.init(node); ar_node.inputs.clear(); for (size_t i = 0; i < src_tensors.size(); i++) { ar_node.inputs.push_back(src_tensors[i]); } for (size_t i = 0; i < sync_tensors.size(); i++) { ar_node.inputs.push_back(ar_node.add_dummy(*sync_tensors[i])); } ar_node.outputs.clear(); for (size_t i = 0; i < src_tensors.size(); i++) { ar_node.outputs.push_back(src_tensors[i]); } ggml_hexagon_precompute_allreduce_params( this, dst, rank, n_ranks, false, false, (struct htp_allreduce_kernel_params *) ar_node.kernel_params ); ar_node.name = "ALLREDUCE"; this->enqueue_op(ar_node); } void ggml_hexagon_session::wait_event(uint64_t seq) { flush_sync_peers(); HEX_VERBOSE("ggml-hex: %s opqueue-wait start: seq %llu, current rsp-seq %llu, pending %d\n", this->name.c_str(), (unsigned long long)seq, (unsigned long long)op_queue->rsp_seq, (int)this->op_pending); while (op_queue->rsp_seq < seq && this->op_pending > 0) { this->flush_pending(false); } HEX_VERBOSE("ggml-hex: %s opqueue-wait end: seq %llu, current rsp-seq %llu, pending %d\n", this->name.c_str(), (unsigned long long)seq, (unsigned long long)op_queue->rsp_seq, (int)this->op_pending); } uint64_t ggml_hexagon_session::record_event() { flush_batch(); return op_queue->req_seq; } bool ggml_hexagon_session::clone_buffer(const ggml_hexagon_shared_buffer *sbuf) { if (this->cloned_buffers.find(sbuf->fd()) != this->cloned_buffers.end()) return true; HEX_VERBOSE("ggml-hex: %s clone-buffer: %s base %p size %zu fd %d\n", this->name.c_str(), sbuf->c_name(), sbuf->base(), sbuf->size(), sbuf->fd()); auto clone = std::make_unique(this, *sbuf); try { clone->mmap(); } catch (const std::exception & exc) { GGML_LOG_ERROR("ggml-hex: %s lazy mapping of buffer context failed: %s\n", this->c_name(), exc.what()); return false; } this->cloned_buffers[sbuf->fd()] = std::move(clone); return true; } static size_t ggml_hexagon_measure_max_vmem(ggml_hexagon_session *sess) { // Allocate a bunch pinned buffers till failure. // This is kind of expensive but handy for figuring out exactly how much we can mmap on a specific device. // Typically we're going to allocate all/most of these buffers anyway for the model weights. std::vector sbufs; const size_t MiB = 1024 * 1024; const size_t GiB = MiB * 1024; size_t vmem = 0; size_t step = 256u * MiB; try { sbufs.push_back(new ggml_hexagon_shared_buffer(sess, GiB, true)); vmem += GiB; sbufs.push_back(new ggml_hexagon_shared_buffer(sess, GiB, true)); vmem += GiB; sbufs.push_back(new ggml_hexagon_shared_buffer(sess, GiB, true)); vmem += GiB; while (1) { sbufs.push_back(new ggml_hexagon_shared_buffer(sess, step, true)); vmem += step; } } catch (...) { } for (auto b : sbufs) { delete b; } return vmem - step; // backoff to account for overhead from internal mappings } void ggml_hexagon_session::allocate(int dev_id) noexcept(false) { const auto & config = opt_device_configs[dev_id]; int phys_idx = config.physical_idx; int virt_idx = config.virtual_idx; this->valid_session = false; this->valid_handle = false; this->valid_queue = false; this->valid_iface = false; this->phys_idx = phys_idx; this->virt_idx = virt_idx; this->domain_id = get_domain_id(phys_idx); this->session_id = 0; this->dev_id = dev_id; this->name = config.name; this->op_pending = 0; GGML_LOG_DEBUG("ggml-hex: %s allocating new session\n", this->name.c_str()); domain * my_domain = htpdrv_get_domain(this->domain_id); if (my_domain == NULL) { GGML_LOG_ERROR("ggml-hex: unable to get domain struct for CDSP (domain_id %d)\n", this->domain_id); throw std::runtime_error("ggml-hex: failed to get CDSP domain (see log for details)"); } std::string dom_name = get_domain_name(phys_idx); // Create new session if virtual_idx > 0 if (virt_idx > 0) { struct remote_rpc_reserve_new_session n; n.domain_name_len = dom_name.size(); n.domain_name = const_cast(dom_name.c_str()); n.session_name = const_cast(this->name.c_str()); n.session_name_len = this->name.size(); int err = remote_session_control(FASTRPC_RESERVE_NEW_SESSION, (void *) &n, sizeof(n)); if (err != AEE_SUCCESS) { GGML_LOG_ERROR("ggml-hex: failed to reserve new session %d (physical %d, virtual %d) : error 0x%x\n", dev_id, phys_idx, virt_idx, err); throw std::runtime_error("ggml-hex: remote_session_control(new-sess) failed (see log for details)"); } // Save the IDs this->session_id = n.session_id; this->domain_id = n.effective_domain_id; this->valid_session = true; } // Get session URI char session_uri[256]; { char htp_uri[256]; snprintf(htp_uri, sizeof(htp_uri), "file:///libggml-htp-v%u.so?htp_iface_skel_handle_invoke&_modver=1.0", opt_arch); struct remote_rpc_get_uri u = {}; u.session_id = this->session_id; u.domain_name = const_cast(dom_name.c_str()); u.domain_name_len = dom_name.size(); u.module_uri = const_cast(htp_uri); u.module_uri_len = strlen(htp_uri); u.uri = session_uri; u.uri_len = sizeof(session_uri); int err = remote_session_control(FASTRPC_GET_URI, (void *) &u, sizeof(u)); if (err != AEE_SUCCESS) { // fallback to single session uris int htp_URI_domain_len = strlen(htp_uri) + MAX_DOMAIN_NAMELEN; snprintf(session_uri, htp_URI_domain_len, "%s%s", htp_uri, my_domain->uri); GGML_LOG_WARN("ggml-hex: failed to get URI for session %d (physical %d, virtual %d) : error 0x%x. Falling back to single session URI: %s\n", dev_id, phys_idx, virt_idx, err, session_uri); } } // Enable Unsigned PD { struct remote_rpc_control_unsigned_module u; u.domain = this->domain_id; u.enable = 1; int err = remote_session_control(DSPRPC_CONTROL_UNSIGNED_MODULE, (void *) &u, sizeof(u)); if (err != AEE_SUCCESS) { GGML_LOG_ERROR("ggml-hex: failed to enable unsigned PD for session %d : error 0x%x\n", dev_id, err); throw std::runtime_error("ggml-hex: remote_session_control(unsign) failed (see log for details)"); } } // Open session int err = htp_iface_open(session_uri, &this->handle); if (err != AEE_SUCCESS) { GGML_LOG_ERROR("ggml-hex: failed to open session %d : error 0x%x\n", dev_id, err); throw std::runtime_error("ggml-hex: failed to open session (see log for details)"); } this->valid_handle = true; // Query HW info and resolve session options this->max_bufsize = opt_mbuf; { unsigned int hw_n_threads = 0; unsigned int hw_n_hvx = 0; unsigned int hw_n_hmx = 0; unsigned long long hw_vtcm_size = 0; int hw_err = htp_iface_hwinfo(this->handle, &hw_n_threads, &hw_n_hvx, &hw_n_hmx, &hw_vtcm_size); if (hw_err == 0) { this->n_threads = opt_nhvx > 0 ? (uint32_t)opt_nhvx : (uint32_t)hw_n_threads; this->n_hvx = opt_nhvx > 0 ? (uint32_t)opt_nhvx : (uint32_t)hw_n_hvx; this->n_hmx = (opt_nhmx != 0) ? (uint32_t)hw_n_hmx : 0; this->vtcm_size = (uint64_t)hw_vtcm_size; GGML_LOG_INFO("ggml-hex: %s hwinfo: threads %u, hvx %u, hmx %u, vtcm %llu MB\n", this->c_name(), this->n_threads, this->n_hvx, this->n_hmx, (unsigned long long)(this->vtcm_size / (1024 * 1024))); } else { GGML_LOG_WARN("ggml-hex: %s failed to query hwinfo (0x%x), using defaults\n", this->c_name(), hw_err); this->n_threads = opt_nhvx > 0 ? (uint32_t)opt_nhvx : 8; this->n_hvx = opt_nhvx > 0 ? (uint32_t)opt_nhvx : 8; this->n_hmx = (opt_nhmx != 0) ? 1 : 0; this->vtcm_size = 8 * 1024 * 1024; } } // Enable FastRPC QoS mode { struct remote_rpc_control_latency l; l.enable = 1; int err = remote_handle64_control(this->handle, DSPRPC_CONTROL_LATENCY, (void *) &l, sizeof(l)); if (err != 0) { GGML_LOG_WARN("ggml-hex: failed to enable fastrpc QOS mode: 0x%08x\n", (unsigned) err); } } GGML_LOG_INFO("ggml-hex: %s new session : session-id %d domain-id %d uri %s handle 0x%lx\n", this->c_name(), this->session_id, this->domain_id, session_uri, (unsigned long) this->handle); const size_t req_q_size = (sizeof(htp_opbatch_req) * opt_opqueue * 2) + 1024; const size_t rsp_q_size = (sizeof(htp_opbatch_rsp) * opt_opqueue * 2) + 1024; // Now let's setup the DSP queue err = dspqueue_create(this->domain_id, 0, // Flags req_q_size, // Request queue size (in bytes) rsp_q_size, // Response queue size (in bytes) nullptr, // Read packet callback (we handle reads explicitly) nullptr, // Error callback (we handle errors during reads) (void *) this, // Callback context &queue); if (err != 0) { GGML_LOG_ERROR("ggml-hex: %s dspqueue_create failed: 0x%08x\n", this->name.c_str(), (unsigned) err); throw std::runtime_error("ggml-hex: failed to create dspqueue (see log for details)"); } this->valid_queue = true; // Export queue for use on the DSP err = dspqueue_export(queue, &this->queue_id); if (err != 0) { GGML_LOG_ERROR("ggml-hex: dspqueue_export failed: 0x%08x\n", (unsigned) err); throw std::runtime_error("ggml-hex: dspqueue export failed (see log for details)"); } if (opt_etm) { err = htp_iface_etm(this->handle, 1); if (err != 0) { GGML_LOG_ERROR("ggml-hex: failed to enable ETM tracing: 0x%08x\n", (unsigned) err); } } // Allocate buffers and state for op batching this->op_queue = new ggml_hexagon_opqueue(this, opt_opbatch, opt_opqueue); if (!opt_vmem) { opt_vmem = ggml_hexagon_measure_max_vmem(this); GGML_LOG_INFO("ggml-hex: %s measured max vmem %zu\n", this->c_name(), opt_vmem); } this->max_vmem = opt_vmem; this->op_batch = new ggml_hexagon_opbatch(this, opt_opbatch, this->max_vmem); // Start dspqueue/opbatch processing err = htp_iface_start(this->handle, dev_id, this->queue_id, opt_nhvx, opt_nhmx, this->max_vmem); if (err != 0) { GGML_LOG_ERROR("ggml-hex: %s failed to start session: 0x%08x\n", this->c_name(), (unsigned) err); throw std::runtime_error("ggml-hex: iface start failed (see log for details)"); } this->valid_iface = true; if (opt_profile) { htp_iface_pmu_conf pmu_conf{}; std::copy(opt_pmu_evt.begin(), opt_pmu_evt.end(), pmu_conf.events); err = htp_iface_profiler(this->handle, opt_profile, &pmu_conf); if (err != 0) { GGML_LOG_ERROR("ggml-hex: failed to enable profiling: 0x%08x\n", (unsigned) err); } } } void ggml_hexagon_session::release() noexcept(true) { GGML_LOG_INFO("ggml-hex: releasing session: %s\n", this->name.c_str()); int err; if (this->valid_iface) { // Stop dspqueue/opbatch processing err = htp_iface_stop(this->handle); if (err != 0) { GGML_ABORT("ggml-hex: htp_iface_stop failed: 0x%08x\n", (unsigned) err); } } delete this->op_batch; delete this->op_queue; if (opt_etm) { err = htp_iface_etm(this->handle, 0); if (err != 0) { GGML_LOG_ERROR("ggml-hex: warn : failed to disable ETM tracing: 0x%08x\n", (unsigned) err); } } if (opt_profile) { htp_iface_pmu_conf pmu_conf{}; err = htp_iface_profiler(this->handle, 0, &pmu_conf); if (err != 0) { GGML_LOG_ERROR("ggml-hex: warn : failed to disable profiling: 0x%08x\n", (unsigned) err); } } if (this->valid_queue) { err = dspqueue_close(queue); if (err != 0) { GGML_ABORT("ggml-hex: dspqueue_close failed: 0x%08x\n", (unsigned) err); } } if (this->valid_handle) { htp_iface_close(this->handle); } this->cloned_buffers.clear(); } ggml_hexagon_session::ggml_hexagon_session(int dev_id, ggml_backend_dev_t dev) noexcept(false) { buffer_type.device = dev; host_buffer_type.device = dev; op_batch = nullptr; op_queue = nullptr; fence_seq = ((uintptr_t)this) & 0xFFFF; try { allocate(dev_id); buffer_type.iface = ggml_backend_hexagon_buffer_type_interface; buffer_type.context = new ggml_backend_hexagon_buffer_type_context(this->name, this); host_buffer_type.iface = ggml_backend_hexagon_host_buffer_type_interface; host_buffer_type.context = new ggml_backend_hexagon_buffer_type_context(this->name + "-HOST", this); } catch (const std::exception & exc) { release(); throw; } } ggml_hexagon_session::~ggml_hexagon_session() noexcept(true) { release(); delete static_cast(buffer_type.context); delete static_cast(host_buffer_type.context); } // ** backend interface static bool ggml_hexagon_flash_attn_is_hmx_eligible( const struct ggml_hexagon_session * sess, const struct ggml_tensor * q, const struct ggml_tensor * k, const struct ggml_tensor * v, const struct ggml_tensor * sinks ) { if (sess->n_hmx == 0) { return false; } if (opt_fa_select < 2) { return false; } if ((k->type != GGML_TYPE_F16 && k->type != GGML_TYPE_Q8_0) || (v->type != GGML_TYPE_F16 && v->type != GGML_TYPE_Q8_0)) { return false; } const uint32_t DK = q->ne[0]; const uint32_t DV = v->ne[0]; if (DK % 64 != 0 || DV % 64 != 0) { return false; } // Fall back to HVX for small token counts if head dimension is small (DK <= 128) const uint32_t neq1 = q->ne[1]; if (DK <= 128 && neq1 < 5) { return false; } return true; GGML_UNUSED(sinks); } static bool ggml_hexagon_precompute_flash_attn_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * op, struct htp_fa_kernel_params * kparams ) { if (opt_fa_select < 1) { return false; } memset(kparams, 0, sizeof(*kparams)); const struct ggml_tensor * q = op->src[0]; const struct ggml_tensor * k = op->src[1]; const struct ggml_tensor * v = op->src[2]; const struct ggml_tensor * mask = op->src[3]; const struct ggml_tensor * dst = op; const uint32_t neq0 = q->ne[0]; // head_dim (DK) const uint32_t neq1 = q->ne[1]; // n_tokens const uint32_t neq2 = q->ne[2]; // n_heads const uint32_t nek1 = k->ne[1]; // kv_len const uint32_t nev0 = v->ne[0]; // head_dim (DV) const uint32_t DK = neq0; const uint32_t DV = nev0; const uint32_t n_kv_heads = k->ne[2]; const uint32_t G = neq2 / n_kv_heads; float scale = 1.0f; float max_bias = 0.0f; float logit_softcap = 0.0f; memcpy(&scale, &op->op_params[0], sizeof(float)); memcpy(&max_bias, &op->op_params[1], sizeof(float)); memcpy(&logit_softcap, &op->op_params[2], sizeof(float)); if (logit_softcap != 0.0f) { scale /= logit_softcap; } kparams->scale = scale; kparams->max_bias = max_bias; kparams->logit_softcap = logit_softcap; kparams->is_q_fp32 = (q->type == GGML_TYPE_F32) ? 1 : 0; kparams->is_dst_fp32 = (dst->type == GGML_TYPE_F32) ? 1 : 0; kparams->G = G; const uint32_t n_head = q->ne[2]; kparams->n_head_log2 = 1u << (uint32_t) std::floor(std::log2(n_head)); kparams->m0 = std::pow(2.0f, -(max_bias) / kparams->n_head_log2); kparams->m1 = std::pow(2.0f, -(max_bias / 2.0f) / kparams->n_head_log2); // Check HMX eligibility const struct ggml_tensor * sinks = op->src[4]; if (ggml_hexagon_flash_attn_is_hmx_eligible(sess, q, k, v, sinks)) { size_t Br = 0, Bc = 0; int ret = hmx_fa_find_chunk_size(&Br, &Bc, G, DK, DV, neq1, nek1, sess->vtcm_size, sess->n_threads, kparams->is_q_fp32 != 0); if (ret == 0) { kparams->kernel_type = HTP_FA_KERNEL_HMX; kparams->Br = Br; kparams->Bc = Bc; kparams->n_kv_blocks = (nek1 + Bc - 1) / Bc; kparams->n_threads = (kparams->n_kv_blocks >= 3 && sess->n_threads >= 2) ? sess->n_threads : 1; kparams->u.hmx.g_br = hex_align_up(G * Br, 32); kparams->u.hmx.pipeline = (kparams->n_kv_blocks >= 3 && sess->n_threads >= 2) ? 1 : 0; kparams->vtcm_size = hmx_fa_compute_vtcm_usage(G, DK, DV, Br, Bc, kparams->n_threads, kparams->u.hmx.pipeline != 0, kparams->is_q_fp32 != 0); const size_t row_vec_bytes = hex_align_up(Bc * sizeof(uint16_t), 256); kparams->u.hmx.row_buf_stride = row_vec_bytes / 128; // HVX vector is 128 bytes const size_t m_line_bytes = hex_align_up(Bc * sizeof(uint16_t), 128); kparams->u.hmx.mask_buf_row_stride = m_line_bytes / sizeof(uint16_t); kparams->u.hmx.mask_broadcast = (mask != nullptr && mask->ne[2] == 1) ? 1 : 0; kparams->u.hmx.div_G = init_fastdiv_values(G); if (mask) { kparams->src3_div2 = init_fastdiv_values(mask->ne[2]); kparams->src3_div3 = init_fastdiv_values(mask->ne[3]); } kparams->qrows = 0; kparams->qrows_per_thread = 0; return true; } } // Fallback to HVX kparams->kernel_type = HTP_FA_KERNEL_HVX; kparams->Br = 1; kparams->Bc = 64; // FLASH_ATTN_BLOCK_SIZE kparams->n_kv_blocks = (k->ne[1] + 64 - 1) / 64; kparams->n_threads = sess->n_threads; const size_t size_q_row_padded = hex_round_up(q->ne[0] * (kparams->is_q_fp32 ? 4 : 2), 128); const size_t size_k_row_padded = hex_round_up(k->ne[0] * 2, 128); const size_t size_v_row_padded = hex_round_up(v->ne[0] * 2, 128); kparams->vtcm_size = hvx_fa_compute_vtcm_usage(DK, DV, kparams->is_q_fp32 != 0, mask != nullptr, sess->n_threads); kparams->u.hvx.size_q_row_padded = size_q_row_padded; kparams->u.hvx.size_k_row_padded = size_k_row_padded; kparams->u.hvx.size_v_row_padded = size_v_row_padded; kparams->u.hvx.src0_div21 = init_fastdiv_values(q->ne[2] * q->ne[1]); kparams->u.hvx.src0_div1 = init_fastdiv_values(q->ne[1]); kparams->broadcast_rk2 = init_fastdiv_values(q->ne[2]/k->ne[2]); kparams->broadcast_rk3 = init_fastdiv_values(q->ne[3]/k->ne[3]); kparams->broadcast_rv2 = init_fastdiv_values(q->ne[2]/v->ne[2]); kparams->broadcast_rv3 = init_fastdiv_values(q->ne[3]/v->ne[3]); if (mask) { kparams->src3_div2 = init_fastdiv_values(mask->ne[2]); kparams->src3_div3 = init_fastdiv_values(mask->ne[3]); } kparams->qrows = q->ne[1] * q->ne[2] * q->ne[3]; kparams->qrows_per_thread = (kparams->qrows + sess->n_threads - 1) / sess->n_threads; return true; } static bool ggml_hexagon_supported_flash_attn_ext(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * src2 = op->src[2]; const struct ggml_tensor * src3 = op->src[3]; const struct ggml_tensor * src4 = op->src[4]; const struct ggml_tensor * dst = op; // Check for F16/Q8_0 support if ((src0->type != GGML_TYPE_F16 && src0->type != GGML_TYPE_F32) || (src1->type != GGML_TYPE_F16 && src1->type != GGML_TYPE_Q8_0) || (src2->type != GGML_TYPE_F16 && src2->type != GGML_TYPE_Q8_0)) { return false; } if (src3 && src3->type != GGML_TYPE_F16) { // mask return false; } if (src4 && src4->type != GGML_TYPE_F32) { // sinks return false; } // For now we support F32 or F16 output as htp backend often converts output on the fly if needed, // but the op implementation writes to F16 or F32. // Let's assume dst can be F32 or F16. if (dst->type != GGML_TYPE_F32 && dst->type != GGML_TYPE_F16) { return false; } if (dst->ne[3] != 1) { return false; } struct htp_fa_kernel_params kparams; if (!ggml_hexagon_precompute_flash_attn_params(sess, op, &kparams)) { return false; } if ((size_t) kparams.vtcm_size > sess->vtcm_size) { HEX_VERBOSE("ggml-hex: skip flash_attn_ext because VTCM needed (%d) > budget (%zu)\n", kparams.vtcm_size, sess->vtcm_size); return false; } return true; } static bool ggml_hexagon_supported_gated_delta_net(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * q = op->src[0]; const struct ggml_tensor * k = op->src[1]; const struct ggml_tensor * v = op->src[2]; const struct ggml_tensor * g = op->src[3]; const struct ggml_tensor * beta = op->src[4]; const struct ggml_tensor * state = op->src[5]; const struct ggml_tensor * dst = op; if (!q || !k || !v || !g || !beta || !state) { return false; } if (q->type != GGML_TYPE_F32 || k->type != GGML_TYPE_F32 || v->type != GGML_TYPE_F32 || g->type != GGML_TYPE_F32 || beta->type != GGML_TYPE_F32 || state->type != GGML_TYPE_F32 || dst->type != GGML_TYPE_F32) { return false; } if (!ggml_is_contiguous_rows(q) || !ggml_is_contiguous_rows(k) || !ggml_is_contiguous_rows(v) || !ggml_is_contiguous(g) || !ggml_is_contiguous(beta) || !ggml_is_contiguous(state) || !ggml_is_contiguous(dst)) { return false; } const int64_t S_v = v->ne[0]; const int64_t H = v->ne[1]; const int64_t n_tokens = v->ne[2]; const int64_t n_seqs = v->ne[3]; const int64_t K = ggml_get_op_params_i32(op, 0); if (S_v <= 0 || S_v > 128 || H <= 0 || n_tokens <= 0 || n_seqs <= 0) { return false; } if (q->ne[0] != S_v || k->ne[0] != S_v || q->ne[1] <= 0 || k->ne[1] <= 0 || q->ne[2] != n_tokens || k->ne[2] != n_tokens || q->ne[3] <= 0 || k->ne[3] <= 0 || (n_seqs % q->ne[3]) != 0 || (n_seqs % k->ne[3]) != 0) { return false; } if ((g->ne[0] != 1 && g->ne[0] != S_v) || beta->ne[0] != 1) { return false; } // state holds s0 only [S_v, S_v, H, n_seqs]; K is op param 0. if (ggml_nelements(state) != S_v * S_v * H * n_seqs) { return false; } if (dst->ne[0] != S_v * H || dst->ne[1] != n_tokens * n_seqs + S_v * n_seqs * K) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_matmul_is_hmx_eligible( const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, int ne01_padded, bool is_matmul_id, bool is_batched ) { const int ne00 = src0->ne[0]; const int ne11 = src1->ne[1]; const int ne12 = src1->ne[2]; const int wtype = src0->type; // HMX weight tile requires N to be 32-aligned. if (ne01_padded % 32 != 0) { return false; } // HMX supports F16, F32, and repack quantized types. if (!ggml_hexagon_is_hmx_weight_type((ggml_type) wtype)) { return false; } // HMX paths require K aligned to 32. if (ne00 % 32 != 0) { return false; } // Quantized HMX kernels only handle flat 2D matmul (or matmul_id wrapping flat 2D matmuls). if (!is_matmul_id && is_batched && wtype != GGML_TYPE_F16) { return false; } // HMX assumes contiguous row-major layout. if (src0->nb[0] > src0->nb[1] || src1->nb[0] > src1->nb[1]) { return false; } // M alignment: Use HMX when M > HTP_MM_HMX_MIN_NROWS const int m = is_matmul_id ? ne12 : ne11; if (m <= HTP_MM_HMX_MIN_NROWS) { return false; } return true; GGML_UNUSED(dst); } static bool ggml_hexagon_precompute_hmx_mm_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, int wtype, int ne00_padded, int ne01_padded, int ne02, int ne11, int ne12, int ne11_padded, bool is_matmul_id, bool is_batched, size_t vtcm_budget, struct htp_mm_kernel_params * kparams ) { const int aligned_tile_size = htp_mm_get_weight_aligned_tile_size(wtype); const bool pipeline = is_matmul_id ? false : htp_mm_hmx_pipeline(ne11); const int n_threads = (int)sess->n_threads; const int ne10 = src1->ne[0]; const bool is_batched_val = is_matmul_id ? false : is_batched; const int group_size = (ne02 > 0 ? ne12 / ne02 : 1); size_t m_chunk = 0; size_t n_chunk = 0; size_t vtcm_size = 0; bool use_grouped = false; int act_threads_selected = 0; if (is_batched_val && wtype == GGML_TYPE_F16 && group_size > 1) { // Try grouped path first const bool use_dma_activation = (src1->nb[1]/sizeof(float) > (size_t)ne00_padded); if (htp_mm_hmx_solve_batched_params(wtype, ne00_padded, ne01_padded, ne11, group_size, use_dma_activation, n_threads, pipeline, vtcm_budget, &m_chunk, &n_chunk, &act_threads_selected, &vtcm_size)) { use_grouped = true; } } if (!use_grouped) { // Fallback to simple 2D path (group_size = 1) const int m_id_rows = (int) ((size_t) dst->ne[1] * dst->ne[2]); if (!htp_mm_hmx_solve_2d_params(wtype, ne00_padded, m_id_rows, ne01_padded, ne11_padded, ne11, n_threads, pipeline, is_matmul_id, aligned_tile_size, vtcm_budget, &m_chunk, &n_chunk, &act_threads_selected, &vtcm_size)) { return false; } } kparams->n_hmx = 1; kparams->pipeline = pipeline ? 1 : 0; kparams->m_chunk = m_chunk; kparams->n_chunk = n_chunk; kparams->n_threads = n_threads; kparams->n_act_threads = act_threads_selected; kparams->tile_size = htp_mm_get_weight_tile_size(wtype); kparams->aligned_tile_size = aligned_tile_size; kparams->src1_row_size = (wtype == GGML_TYPE_Q4_1) ? htp_mm_q8_1_tiled_row_size(ne10) : htp_mm_q8_0_tiled_row_size(ne10); kparams->vtcm_size = vtcm_size; kparams->vtcm_src0_size = 0; kparams->div_n_act_threads = init_fastdiv_values(act_threads_selected); kparams->div_ne00_padded = init_fastdiv_values(ne00_padded); kparams->vtcm_src1_size = 0; kparams->vtcm_dst_size = 0; if (is_batched && !is_matmul_id) { kparams->kernel_type = HTP_MM_KERNEL_HMX_F16_BATCHED; } else { kparams->kernel_type = HTP_MM_KERNEL_HMX_2D; } return true; GGML_UNUSED(src0); } static void ggml_hexagon_precompute_hvx_mm_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, int wtype, int ne02, int ne03, int ne10, int ne11, int ne12, int ne13, bool is_matmul_id, const size_t src2_row_size, size_t vtcm_budget, struct htp_mm_kernel_params * kparams ) { kparams->n_hmx = 0; const bool is_quant = (wtype != GGML_TYPE_F16 && wtype != GGML_TYPE_F32); const int src1_nrows = ne11 * ne12 * ne13; if (is_quant) { // Quantized HVX kparams->tile_size = htp_mm_get_weight_tile_size(wtype); kparams->aligned_tile_size = htp_mm_get_weight_aligned_tile_size(wtype); const bool k_align = (ne10 % 32 == 0); if (is_matmul_id) { kparams->kernel_type = (src1_nrows < (int) sess->n_threads) ? HTP_MM_KERNEL_HVX_QUANT_BLOCK : HTP_MM_KERNEL_HVX_QUANT_ROW; kparams->src1_row_size = (wtype == GGML_TYPE_Q4_1) ? htp_mm_q8_1_tiled_row_size(ne10) : htp_mm_q8_0_tiled_row_size(ne10); struct htp_mm_hvx_vtcm_layout L; uint32_t max_prefetch = (src1_nrows > HTP_MM_HMX_MIN_NROWS) ? 2 : 16; uint32_t best_n_prefetch = 2; for (uint32_t d = max_prefetch; d >= 2; d /= 2) { htp_mm_hvx_vtcm_layout_build( &L, kparams->kernel_type, wtype, ne10, src1_nrows, sess->n_threads, 0, src0->nb[1], 0, src2_row_size, d, true, false ); if (L.total_bytes <= vtcm_budget) { best_n_prefetch = d; break; } } if (best_n_prefetch == 2 && L.total_bytes > vtcm_budget) { htp_mm_hvx_vtcm_layout_build( &L, kparams->kernel_type, wtype, ne10, src1_nrows, sess->n_threads, 0, src0->nb[1], 0, src2_row_size, 2, true, false ); } kparams->n_prefetch = best_n_prefetch; kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; } else { bool try_tiled = (k_align && opt_mm_select >= 2); if (try_tiled) { kparams->src1_row_size = (wtype == GGML_TYPE_Q4_1) ? htp_mm_q8_1_tiled_row_size(ne10) : htp_mm_q8_0_tiled_row_size(ne10); if (src1_nrows < (int)sess->n_threads) { kparams->kernel_type = HTP_MM_KERNEL_HVX_QUANT_BLOCK; } else { kparams->kernel_type = HTP_MM_KERNEL_HVX_QUANT_ROW; } struct htp_mm_hvx_vtcm_layout L; uint32_t max_prefetch = (src1_nrows > HTP_MM_HMX_MIN_NROWS) ? 2 : 16; uint32_t best_n_prefetch = 2; for (uint32_t d = max_prefetch; d >= 2; d /= 2) { htp_mm_hvx_vtcm_layout_build( &L, kparams->kernel_type, wtype, ne10, src1_nrows, sess->n_threads, dst->nb[1], src0->nb[1], src1->nb[1], src2_row_size, d, false, false ); if (L.total_bytes <= vtcm_budget) { best_n_prefetch = d; break; } } if (best_n_prefetch == 2 && L.total_bytes > vtcm_budget) { htp_mm_hvx_vtcm_layout_build( &L, kparams->kernel_type, wtype, ne10, src1_nrows, sess->n_threads, dst->nb[1], src0->nb[1], src1->nb[1], src2_row_size, 2, false, false ); } kparams->n_prefetch = best_n_prefetch; if (L.total_bytes <= vtcm_budget) { kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; goto done_quant; } HEX_VERBOSE("ggml-hex: %s HVX tiled path VTCM size needed (%zu) > budget (%zu), falling back to HVX flat\n", sess->name.c_str(), L.total_bytes, vtcm_budget); } // Flat HVX fallback { kparams->src1_row_size = (wtype == GGML_TYPE_Q4_1) ? htp_mm_q8_1_flat_row_size(ne10) : htp_mm_q8_0_flat_row_size(ne10); kparams->kernel_type = HTP_MM_KERNEL_HVX_QUANT_ROW_FLAT; struct htp_mm_hvx_vtcm_layout L; htp_mm_hvx_vtcm_layout_build( &L, kparams->kernel_type, wtype, ne10, src1_nrows, sess->n_threads, dst->nb[1], src0->nb[1], src1->nb[1], src2_row_size, 16, false, false ); kparams->n_prefetch = 16; kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; } } done_quant:; } else if (wtype == GGML_TYPE_F16) { // F16 HVX const bool is_batched = (ne02 > 1) || (ne03 > 1); const bool is_permuted = ggml_is_permuted(src0) || ggml_is_permuted(src1); struct htp_mm_hvx_vtcm_layout L; htp_mm_hvx_vtcm_layout_build( &L, HTP_MM_KERNEL_HVX_F16_F16_VTCM, wtype, ne10, src1_nrows, sess->n_threads, dst->nb[1], src0->nb[1], src1->nb[1], src2_row_size, 16, false, false ); if (!is_batched && !is_permuted && L.total_bytes <= vtcm_budget) { kparams->kernel_type = HTP_MM_KERNEL_HVX_F16_F16_VTCM; kparams->src1_row_size = hex_round_up(ne10 * 2, 128); kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; kparams->n_prefetch = 16; } else { if (src1->type == GGML_TYPE_F32) { kparams->kernel_type = HTP_MM_KERNEL_HVX_F16_F32_DDR; } else { kparams->kernel_type = HTP_MM_KERNEL_HVX_F16_F16_DDR; } kparams->src1_row_size = src1->nb[1]; htp_mm_hvx_vtcm_layout_build( &L, kparams->kernel_type, wtype, ne10, src1_nrows, sess->n_threads, dst->nb[1], src0->nb[1], src1->nb[1], src2_row_size, 16, false, false ); kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; kparams->n_prefetch = 16; } } else { // F32 HVX const bool is_batched = (ne02 > 1) || (ne03 > 1); const bool is_permuted = ggml_is_permuted(src0) || ggml_is_permuted(src1); struct htp_mm_hvx_vtcm_layout L; htp_mm_hvx_vtcm_layout_build( &L, HTP_MM_KERNEL_HVX_F32_F32_VTCM, wtype, ne10, src1_nrows, sess->n_threads, dst->nb[1], src0->nb[1], src1->nb[1], src2_row_size, 16, false, false ); if (!is_batched && !is_permuted && L.total_bytes <= vtcm_budget) { kparams->kernel_type = HTP_MM_KERNEL_HVX_F32_F32_VTCM; kparams->src1_row_size = hex_round_up(ne10 * 4, 128); kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; kparams->n_prefetch = 16; } else { kparams->kernel_type = HTP_MM_KERNEL_HVX_F32_F32_DDR; kparams->src1_row_size = src1->nb[1]; htp_mm_hvx_vtcm_layout_build( &L, kparams->kernel_type, wtype, ne10, src1_nrows, sess->n_threads, dst->nb[1], src0->nb[1], src1->nb[1], src2_row_size, 16, false, false ); kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; kparams->n_prefetch = 16; } } } static void ggml_hexagon_precompute_matmul_params_impl( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, const size_t src2_row_size, struct htp_mm_kernel_params * kparams ) { memset(kparams, 0, sizeof(*kparams)); const int ne00 = src0->ne[0]; const int ne01 = src0->ne[1]; const int ne02 = src0->ne[2]; const int ne03 = src0->ne[3]; const int ne10 = src1->ne[0]; const int ne11 = src1->ne[1]; const int ne12 = src1->ne[2]; const int ne13 = src1->ne[3]; const int wtype = src0->type; const bool is_repack = ggml_hexagon_is_repack_type((ggml_type) wtype); const int ne00_padded = is_repack ? hex_round_up(ne00, 32) : ne00; const int ne01_padded = is_repack ? hex_round_up(ne01, 32) : ne01; const int ne11_padded = hex_round_up(ne11, 32); const bool is_matmul_id = (dst->op == GGML_OP_MUL_MAT_ID); const bool is_batched = (ne02 * ne03 > 1 || ne12 * ne13 > 1); const size_t vtcm_budget = sess->vtcm_size; // Check HMX eligibility and try precomputing HMX parameters bool hmx_enabled = (sess->n_hmx > 0) && (opt_mm_select >= 3); if (hmx_enabled && ggml_hexagon_matmul_is_hmx_eligible(src0, src1, dst, ne01_padded, is_matmul_id, is_batched)) { if (ggml_hexagon_precompute_hmx_mm_params(sess, src0, src1, dst, wtype, ne00_padded, ne01_padded, ne02, ne11, ne12, ne11_padded, is_matmul_id, is_batched, vtcm_budget, kparams)) { goto finalize; } } // Fallback to HVX parameter computation ggml_hexagon_precompute_hvx_mm_params(sess, src0, src1, dst, wtype, ne02, ne03, ne10, ne11, ne12, ne13, is_matmul_id, src2_row_size, vtcm_budget, kparams); finalize: kparams->div_ne12_ne1 = init_fastdiv_values(ne12 * ne11); kparams->div_ne1 = init_fastdiv_values(ne11); kparams->div_r2 = init_fastdiv_values(ne02 > 0 ? ne12 / ne02 : 1); kparams->div_r3 = init_fastdiv_values(ne03 > 0 ? ne13 / ne03 : 1); kparams->div_ne11 = init_fastdiv_values(ne11); } static void ggml_hexagon_precompute_matmul_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, struct htp_mm_kernel_params * kparams ) { ggml_hexagon_precompute_matmul_params_impl(sess, src0, src1, dst, 0, kparams); } static void ggml_hexagon_precompute_fused_matmul_add_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * src2, const struct ggml_tensor * dst, struct htp_mm_kernel_params * kparams ) { ggml_hexagon_precompute_matmul_params_impl(sess, src0, src1, dst, src2->nb[1], kparams); } static void ggml_hexagon_precompute_unary_params( const struct ggml_hexagon_session * sess, uint32_t op, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, struct htp_unary_kernel_params * kparams ) { memset(kparams, 0, sizeof(*kparams)); const uint32_t src0_nrows = src0->ne[1] * src0->ne[2] * src0->ne[3]; const uint32_t n_threads = (std::min)((uint32_t)sess->n_threads, src0_nrows); kparams->n_threads = n_threads; const size_t src0_data_row_size = src0->ne[0] * sizeof(float); const size_t dst_data_row_size = dst->ne[0] * sizeof(float); const size_t src0_row_size_aligned = hex_round_up(src0_data_row_size, 128); const size_t dst_row_size_aligned = hex_round_up(dst_data_row_size, 128); kparams->src0_row_size_aligned = src0_row_size_aligned; kparams->dst_row_size_aligned = dst_row_size_aligned; size_t src1_data_row_size = 0; size_t src1_row_size_aligned = 0; bool broadcast_weight = false; if (op == HTP_OP_RMS_NORM_MUL) { GGML_ASSERT(src1 != nullptr); src1_data_row_size = src1->ne[0] * sizeof(float); src1_row_size_aligned = hex_round_up(src1_data_row_size, 128); broadcast_weight = (src1->ne[1] * src1->ne[2] * src1->ne[3] == 1); } kparams->src1_row_size_aligned = src1_row_size_aligned; kparams->broadcast_weight = broadcast_weight; struct htp_unary_vtcm_layout L; uint32_t col_tile = 0; uint32_t vtcm_row_per_thread = 0; htp_unary_vtcm_layout_build(&L, op, src0->ne[0], dst->ne[0], op == HTP_OP_RMS_NORM_MUL ? src1->ne[0] : 0, broadcast_weight, n_threads, sess->vtcm_size, &col_tile, &vtcm_row_per_thread); kparams->col_tile = col_tile; kparams->vtcm_row_per_thread = vtcm_row_per_thread; kparams->vtcm_size = L.total_bytes; kparams->vtcm_src0_size_per_thread = L.src0_bytes; kparams->vtcm_src1_size_per_thread = L.src1_bytes; kparams->vtcm_dst_size_per_thread = L.dst_bytes; kparams->vtcm_src0_size = L.src0_bytes * n_threads; kparams->vtcm_src1_size = L.src1_bytes * n_threads; kparams->vtcm_dst_size = L.dst_bytes * n_threads; kparams->block = col_tile ? 0 : ((L.src0_bytes / 2) / src0_row_size_aligned); const uint32_t tiles_per_row = col_tile > 0 ? (src0->ne[0] + col_tile - 1) / col_tile : 1; kparams->div_ne01 = init_fastdiv_values(src0->ne[1]); kparams->div_ne02 = init_fastdiv_values(src0->ne[2]); kparams->div_ne012 = init_fastdiv_values(src0->ne[1] * src0->ne[2]); kparams->div_tpr = init_fastdiv_values(tiles_per_row); } static void ggml_hexagon_precompute_get_rows_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, const struct ggml_tensor * src1, const struct ggml_tensor * dst, struct htp_get_rows_kernel_params * kparams ) { memset(kparams, 0, sizeof(*kparams)); const uint32_t ne00 = src0->ne[0]; const uint32_t ne02 = src0->ne[2]; const uint32_t ne03 = src0->ne[3]; const uint32_t ne10 = src1->ne[0]; const uint32_t ne11 = src1->ne[1]; const uint32_t ne12 = src1->ne[2]; const uint32_t nr = ne10 * ne11 * ne12; const size_t nb01 = src0->nb[1]; const size_t nb1 = dst->nb[1]; const bool can_use_dma = (src0->type == dst->type) && (nb01 == nb1); const bool use_dma = can_use_dma && (ne00 >= 2048); kparams->use_dma = use_dma ? 1 : 0; uint32_t chunks_per_row = 1; uint32_t chunk_size = ne00; uint32_t total_tasks = nr; if (use_dma) { kparams->n_threads = (std::min)((uint32_t)sess->n_threads, nr); kparams->tasks_per_thread = (nr + kparams->n_threads - 1) / kparams->n_threads; } else { if (src0->type == GGML_TYPE_F32 && nr < sess->n_threads) { const uint32_t min_chunk_size = 1024; uint32_t max_chunks = ne00 / min_chunk_size; if (max_chunks == 0) { max_chunks = 1; } chunks_per_row = (std::min)((sess->n_threads + nr - 1) / nr, max_chunks); chunk_size = (ne00 + chunks_per_row - 1) / chunks_per_row; total_tasks = nr * chunks_per_row; } kparams->n_threads = (std::min)(total_tasks, (uint32_t)sess->n_threads); kparams->tasks_per_thread = (total_tasks + kparams->n_threads - 1) / kparams->n_threads; } kparams->chunks_per_row = chunks_per_row; kparams->chunk_size = chunk_size; kparams->total_tasks = total_tasks; kparams->div_ne10 = init_fastdiv_values(ne10); kparams->div_ne10_ne11 = init_fastdiv_values(ne10 * ne11); kparams->div_chunks_per_row = init_fastdiv_values(chunks_per_row); kparams->div_ne02 = init_fastdiv_values(ne02); kparams->div_ne03 = init_fastdiv_values(ne03); struct htp_get_rows_vtcm_layout vtcm_layout; htp_get_rows_vtcm_layout_build(&vtcm_layout, src0->type, ne00, kparams->n_threads); kparams->vtcm_size = vtcm_layout.total_bytes; } static void ggml_hexagon_precompute_set_rows_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, // values const struct ggml_tensor * src1, // indices const struct ggml_tensor * dst, // destination struct htp_set_rows_kernel_params * kparams ) { memset(kparams, 0, sizeof(*kparams)); const uint32_t nr = src0->ne[1]; kparams->n_threads = (std::min)((uint32_t)sess->n_threads, nr); kparams->tasks_per_thread = (nr + kparams->n_threads - 1) / kparams->n_threads; kparams->total_tasks = nr; kparams->div_ne11 = init_fastdiv_values(src1->ne[1]); kparams->div_ne12 = init_fastdiv_values(src1->ne[2]); kparams->div_tasks_per_thread = init_fastdiv_values(kparams->tasks_per_thread); kparams->div_ne02 = init_fastdiv_values(src0->ne[2]); struct htp_set_rows_vtcm_layout vtcm_layout; htp_set_rows_vtcm_layout_build(&vtcm_layout, dst->type, src0->ne[0], kparams->n_threads); kparams->vtcm_size = vtcm_layout.total_bytes; } static void ggml_hexagon_precompute_fused_mmnx_params( const struct ggml_hexagon_session * sess, const struct ggml_tensor * src0, // W0 const struct ggml_tensor * src1, // x int32_t n_weights, struct htp_mm_kernel_params * kparams ) { memset(kparams, 0, sizeof(*kparams)); const int wtype = src0->type; const bool is_repack = ggml_hexagon_is_repack_type((ggml_type) wtype); const int ne10 = src1->ne[0]; const int src1_nrows = src1->ne[1] * src1->ne[2] * src1->ne[3]; const size_t src1_row_size = (wtype == GGML_TYPE_Q4_1) ? htp_mm_q8_1_tiled_row_size(ne10) : htp_mm_q8_0_tiled_row_size(ne10); const size_t src0_row_size = src0->nb[1]; uint32_t best_n_prefetch = 16; if (is_repack) { const uint32_t max_prefetch = (src1_nrows > HTP_MM_HMX_MIN_NROWS) ? 2 : 16; best_n_prefetch = 2; for (uint32_t d = max_prefetch; d >= 2; d /= 2) { struct htp_mm_hvx_vtcm_layout L; htp_mm_hvx_vtcm_layout_build( &L, HTP_MM_KERNEL_HVX_QUANT_ROW, wtype, ne10, src1_nrows, sess->n_threads, 0, src0_row_size, src1_row_size, 0, d, false, true ); if (L.total_bytes <= sess->vtcm_size) { best_n_prefetch = d; break; } } } struct htp_mm_hvx_vtcm_layout L; bool try_tiled = (opt_mm_select >= 2); // Test tiled first htp_mm_hvx_vtcm_layout_build( &L, HTP_MM_KERNEL_HVX_QUANT_ROW, wtype, ne10, src1_nrows, sess->n_threads, 0, src0_row_size, src1_row_size, 0, best_n_prefetch, false, true ); if (try_tiled && L.total_bytes <= sess->vtcm_size) { kparams->kernel_type = HTP_MM_KERNEL_HVX_QUANT_ROW; kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; kparams->vtcm_size = L.total_bytes; kparams->n_prefetch = best_n_prefetch; kparams->n_weights = n_weights; } else { kparams->kernel_type = HTP_MM_KERNEL_HVX_QUANT_ROW_FLAT; size_t flat_src1_row_size = (wtype == GGML_TYPE_Q4_1) ? htp_mm_q8_1_flat_row_size(ne10) : htp_mm_q8_0_flat_row_size(ne10); htp_mm_hvx_vtcm_layout_build( &L, HTP_MM_KERNEL_HVX_QUANT_ROW_FLAT, wtype, ne10, src1_nrows, sess->n_threads, 0, src0_row_size, flat_src1_row_size, 0, best_n_prefetch, false, true ); kparams->vtcm_src0_size = L.src0_bytes; kparams->vtcm_src1_size = L.src1_bytes; kparams->vtcm_dst_size = L.dst_bytes; kparams->vtcm_size = L.total_bytes; kparams->n_prefetch = best_n_prefetch; kparams->n_weights = n_weights; } } static bool ggml_hexagon_tensor_is_host(const struct ggml_hexagon_session * sess, const struct ggml_tensor * t) { return t && t->buffer && t->buffer->buft == &sess->host_buffer_type; } static bool ggml_hexagon_tensor_is_non_host(const struct ggml_hexagon_session * sess, const struct ggml_tensor * t) { return t && t->buffer && t->buffer->buft != &sess->host_buffer_type; } static bool ggml_hexagon_supported_mul_mat(const struct ggml_hexagon_session * sess, const struct ggml_tensor * dst) { const struct ggml_tensor * src0 = dst->src[0]; const struct ggml_tensor * src1 = dst->src[1]; if (dst->type != GGML_TYPE_F32) { return false; } if (src1->type != GGML_TYPE_F32 && src1->type != GGML_TYPE_F16) { return false; } switch (src0->type) { case GGML_TYPE_Q4_0: case GGML_TYPE_Q4_1: case GGML_TYPE_Q8_0: case GGML_TYPE_IQ4_NL: case GGML_TYPE_MXFP4: if (src0->ne[0] % 32) { return false; } // hardcoded limit to refuse the lm-head for now if (src0->ne[1] > 32768) { return false; } if (src1->ne[2] != 1 || src1->ne[3] != 1) { return false; // no broadcasting (for now) } if (!src0->buffer) { sess->needs_repack.insert(src0); } break; case GGML_TYPE_F16: if (src0->nb[1] < src0->nb[0]) { return false; } if (src1->ne[2] < src0->ne[2] || src1->ne[3] < src0->ne[3]) { return false; } break; case GGML_TYPE_F32: if (src1->type != GGML_TYPE_F32) { return false; } if (src0->nb[1] < src0->nb[0]) { return false; } if (src1->ne[2] < src0->ne[2] || src1->ne[3] < src0->ne[3]) { return false; } break; default: return false; } struct htp_mm_kernel_params kparams; ggml_hexagon_precompute_matmul_params(sess, src0, src1, dst, &kparams); if ((size_t)kparams.vtcm_size > sess->vtcm_size) { HEX_VERBOSE("ggml-hex: %s supported MUL_MAT VTCM size needed (%d) > budget (%zu)\n", sess->c_name(), kparams.vtcm_size, sess->vtcm_size); return false; } return true; } static bool ggml_hexagon_supported_mul_mat_id(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * src2 = op->src[2]; const struct ggml_tensor * dst = op; if (src1->type != GGML_TYPE_F32 || dst->type != GGML_TYPE_F32 || src2->type != GGML_TYPE_I32) { return false; } switch (src0->type) { case GGML_TYPE_Q4_0: case GGML_TYPE_Q4_1: case GGML_TYPE_Q8_0: case GGML_TYPE_IQ4_NL: case GGML_TYPE_MXFP4: if ((src0->ne[0] % 32)) { return false; } if (!src0->buffer) { sess->needs_repack.insert(src0); } break; default: return false; } struct htp_mm_kernel_params kparams; ggml_hexagon_precompute_matmul_params(sess, src0, src1, dst, &kparams); if ((size_t)kparams.vtcm_size > sess->vtcm_size) { HEX_VERBOSE("ggml-hex: %s supported MUL_MAT_ID VTCM size needed (%d) > budget (%zu)\n", sess->c_name(), kparams.vtcm_size, sess->vtcm_size); return false; } return true; } static bool ggml_hexagon_supported_binary(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * dst = op; if (src0->type == GGML_TYPE_F32) { if (src1->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } } else if (src0->type == GGML_TYPE_F16) { if (src1->type != GGML_TYPE_F16) { return false; } if (dst->type != GGML_TYPE_F16) { return false; } } else { return false; } if (ggml_is_permuted(src0) || ggml_is_permuted(dst)) { return false; } if (!ggml_are_same_shape(src0, dst)) { return false; } if (!ggml_can_repeat(src1, src0) || ggml_is_permuted(src1)) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_add_id(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32) { return false; } if (src1->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } if (!ggml_are_same_shape(src0, dst)) { return false; } // REVISIT: add support for non-contigiuos tensors if (!ggml_is_contiguous(src0) || !ggml_is_contiguous(src1) || !ggml_is_contiguous(dst)) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_unary(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } if (!ggml_is_contiguous_rows(src0)) { return false; } if (!ggml_are_same_shape(src0, dst)) { return false; } // dst must be contiguous; src0 may be non-contiguous if (!ggml_is_contiguous(dst)) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_sum_rows(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } // TODO: add support for non-contigiuos tensors if (!ggml_is_contiguous(src0) || !ggml_is_contiguous(dst)) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_activations(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } if (!ggml_is_contiguous_1(src0)) { return false; } if (!ggml_is_contiguous(dst)) { return false; } if (src1) { if (src1->type != GGML_TYPE_F32) { return false; } if (!ggml_are_same_shape(src0, src1)) { return false; } if (!ggml_is_contiguous_1(src1)) { return false; } } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_softmax(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * src2 = op->src[2]; const struct ggml_tensor * dst = op; if (src2) { return false; // FIXME: add support for sinks } if (src0->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } if (src1) { if (src1->type != GGML_TYPE_F32 && src1->type != GGML_TYPE_F16) { return false; } if (src0->ne[0] != src1->ne[0]) { return false; } if (src1->ne[1] < src0->ne[1]) { return false; } if (src0->ne[2] % src1->ne[2] != 0) { return false; } if (src0->ne[3] % src1->ne[3] != 0) { return false; } } if (src1) { if (!ggml_is_contiguous(src0) || !ggml_is_contiguous(src1) || !ggml_is_contiguous(dst)) { return false; } } else { if (!ggml_is_contiguous(src0) || !ggml_is_contiguous(dst)) { return false; } } // Reject non-HVX-aligned sizes when ne[0] > HVX_F32_LANES // The HVX softmax implementation has issues with tail handling for larger non-aligned sizes // Small sizes (ne[0] <= 32) work correctly with tail-only processing const int64_t ne0 = src0->ne[0]; if (ne0 > 32 && (ne0 & (32 - 1)) != 0) { return false; } // HVX vector size constraints for softmax #define SOFTMAX_MAX_ROW_SIZE 131072 // 128K elements max for numerical precision // Reject very large row sizes to avoid numerical precision issues // Softmax accumulation over many elements can lead to precision loss if (ne0 > SOFTMAX_MAX_ROW_SIZE) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_set_rows(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; // values const struct ggml_tensor * src1 = op->src[1]; // indices const struct ggml_tensor * dst = op->src[2] ? op->src[2] : op; if (dst->type == GGML_TYPE_Q8_0 && src0->ne[0] < 32) { return false; } if (src0->type != GGML_TYPE_F32) { return false; } if (src1->type != GGML_TYPE_I32 && src1->type != GGML_TYPE_I64) { return false; } if (dst->type != GGML_TYPE_F32 && dst->type != GGML_TYPE_F16 && dst->type != GGML_TYPE_Q8_0) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_get_rows(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; // values const struct ggml_tensor * src1 = op->src[1]; // indices const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32 && src0->ne[0] < 32) { return false; } if (src0->type != GGML_TYPE_F32 && src0->type != GGML_TYPE_F16 && src0->type != GGML_TYPE_Q8_0) { return false; } if (src1->type != GGML_TYPE_I32 && src1->type != GGML_TYPE_I64) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_argsort(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; // values const struct ggml_tensor * dst = op; // indices if (src0->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_I32) { return false; } if (src0->ne[0] > (16*1024)) { // reject tensors with huge rows for now return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_rope(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const int32_t * op_params = &op->op_params[0]; // ggml_rope_set_offset: HVX kernels need a VLEN-aligned window start (32 f32 elems) if (op_params[15] % 32 != 0) { return false; } int mode = op_params[2]; // n_dims == ne0/2, so the rotation spans the full row if (mode == GGML_ROPE_TYPE_VISION) { const int n_dims = op_params[1]; if (n_dims != (int) (op->src[0]->ne[0] / 2)) { return false; } } if (mode & 1) { return false; } const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * src2 = op->src[2]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32) { return false; // FIXME: add support for GGML_TYPE_F16 for src0 } if (dst->type != GGML_TYPE_F32) { return false; } if (src1->type != GGML_TYPE_I32) { return false; } if (src2) { if (src2->type != GGML_TYPE_F32) { return false; } int n_dims = op_params[1]; if (src2->ne[0] < (n_dims / 2)) { return false; } } if (src2) { if (!ggml_is_contiguous(src1) || !ggml_is_contiguous(src2)) { return false; } } else { if (!ggml_is_contiguous(src1)) { return false; } } // src0/dst elements within a row must be contiguous (nb[0] == sizeof(float)). // nb[1] may exceed ne[0]*sizeof(float) when the tensor is a strided view of a larger one if (src0->nb[0] != sizeof(float) || dst->nb[0] != sizeof(float)) { return false; } if (src0->nb[1] < src0->ne[0] * sizeof(float) || dst->nb[1] < dst->ne[0] * sizeof(float)) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_ssm_conv(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * dst = op; // Only support FP32 for now if (src0->type != GGML_TYPE_F32 || src1->type != GGML_TYPE_F32 || dst->type != GGML_TYPE_F32) { return false; } // Check IO tensor shapes and dims if (src0->ne[3] != 1 || src1->ne[2] != 1 || src1->ne[3] != 1 || dst->ne[3] != 1) { return false; // src0 should be effectively 3D } const int d_conv = src1->ne[0]; const int d_inner = src0->ne[1]; const int n_t = dst->ne[1]; const int n_s = dst->ne[2]; if (src0->ne[0] != d_conv - 1 + n_t || src0->ne[1] != d_inner || src0->ne[2] != n_s) { return false; } if (src1->ne[0] != d_conv || src1->ne[1] != d_inner) { return false; } if (dst->ne[0] != d_inner || dst->ne[1] != n_t || dst->ne[2] != n_s) { return false; } if (src0->nb[0] != sizeof(float) || src1->nb[0] != sizeof(float) || dst->nb[0] != sizeof(float)) { return false; } if (src0->nb[1] != src0->ne[0] * sizeof(float) || src1->nb[1] != src1->ne[0] * sizeof(float)) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_im2col(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src1 = op->src[1]; const struct ggml_tensor * dst = op; const bool is_2D = ((const int32_t *) op->op_params)[6] == 1; if (!is_2D) { return false; } // For now support F32->F32 and F32->F16 only. if (src1->type != GGML_TYPE_F32 || (dst->type != GGML_TYPE_F16 && dst->type != GGML_TYPE_F32)) { return false; } if (!ggml_is_contiguous(src1) || !ggml_is_contiguous(dst)) { return false; } // For now keep padded OPs on CPU. Will revisit once we expand coverage past patch-embed OPs. const int32_t p0 = ((const int32_t *) op->op_params)[2]; const int32_t p1 = ((const int32_t *) op->op_params)[3]; if (p0 != 0 || p1 != 0) { return false; } GGML_UNUSED(sess); return true; } static bool ggml_hexagon_supported_pad(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32 || dst->type != GGML_TYPE_F32) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_cumsum(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32 || dst->type != GGML_TYPE_F32) { return false; } if (!ggml_is_contiguous(src0) || !ggml_is_contiguous(dst)) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_diag(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; // diag only supports F32 currently if (src0->type != GGML_TYPE_F32 || dst->type != GGML_TYPE_F32) { return false; } // Input must have ne[1] == 1 (vector input) if (src0->ne[1] != 1) { return false; } // Output must be square in first two dimensions if (dst->ne[0] != dst->ne[1] || dst->ne[0] != src0->ne[0]) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_solve_tri(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; // A const struct ggml_tensor * src1 = op->src[1]; // B const struct ggml_tensor * dst = op; // X if (!src0 || !src1) { return false; } if (src0->type != GGML_TYPE_F32 || src1->type != GGML_TYPE_F32 || dst->type != GGML_TYPE_F32) { return false; } if (src0->ne[0] != src0->ne[1]) { return false; } if (src0->ne[1] != src1->ne[1]) { return false; } if (src0->ne[2] != src1->ne[2] || src0->ne[3] != src1->ne[3]) { return false; } if (dst->ne[0] != src1->ne[0] || dst->ne[1] != src1->ne[1] || dst->ne[2] != src1->ne[2] || dst->ne[3] != src1->ne[3]) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_tri(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; if (src0->type != GGML_TYPE_F32) { return false; } if (dst->type != GGML_TYPE_F32) { return false; } if (!ggml_are_same_shape(src0, dst)) { return false; } if (!ggml_is_contiguous(src0) || !ggml_is_contiguous(dst)) { return false; } return true; GGML_UNUSED(sess); } static const char * ggml_backend_hexagon_name(ggml_backend_t backend) { auto sess = static_cast(backend->context); return sess->c_name(); } static void ggml_backend_hexagon_free(ggml_backend_t backend) { // we just need to delete the backend here // the sessions are allocated & freed as part of the registry delete backend; } static htp_op_code op_remap_to_htp(const ggml_tensor * t) { switch (t->op) { case GGML_OP_FLASH_ATTN_EXT: return HTP_OP_FLASH_ATTN_EXT; case GGML_OP_MUL_MAT: return HTP_OP_MUL_MAT; case GGML_OP_MUL_MAT_ID: return HTP_OP_MUL_MAT_ID; case GGML_OP_MUL: return HTP_OP_MUL; case GGML_OP_ADD: return HTP_OP_ADD; case GGML_OP_ADD_ID: return HTP_OP_ADD_ID; case GGML_OP_SUB: return HTP_OP_SUB; case GGML_OP_DIV: return HTP_OP_DIV; case GGML_OP_CPY: return HTP_OP_CPY; case GGML_OP_CONT: return HTP_OP_CPY; case GGML_OP_GET_ROWS: return HTP_OP_GET_ROWS; case GGML_OP_SET_ROWS: return HTP_OP_SET_ROWS; case GGML_OP_SUM_ROWS: return HTP_OP_SUM_ROWS; case GGML_OP_ARGSORT: return HTP_OP_ARGSORT; case GGML_OP_NORM: return HTP_OP_NORM; case GGML_OP_L2_NORM: return HTP_OP_L2_NORM; case GGML_OP_RMS_NORM: return HTP_OP_RMS_NORM; case GGML_OP_CONCAT: return HTP_OP_CONCAT; case GGML_OP_SCALE: return HTP_OP_SCALE; case GGML_OP_CLAMP: return HTP_OP_CLAMP; case GGML_OP_SQR: return HTP_OP_SQR; case GGML_OP_SQRT: return HTP_OP_SQRT; case GGML_OP_SOFT_MAX: return HTP_OP_SOFTMAX; case GGML_OP_SSM_CONV: return HTP_OP_SSM_CONV; case GGML_OP_GATED_DELTA_NET: return HTP_OP_GATED_DELTA_NET; case GGML_OP_ROPE: return HTP_OP_ROPE; case GGML_OP_REPEAT: return HTP_OP_REPEAT; case GGML_OP_CUMSUM: return HTP_OP_CUMSUM; case GGML_OP_FILL: return HTP_OP_FILL; case GGML_OP_DIAG: return HTP_OP_DIAG; case GGML_OP_SOLVE_TRI: return HTP_OP_SOLVE_TRI; case GGML_OP_TRI: return HTP_OP_TRI; case GGML_OP_PAD: return HTP_OP_PAD; case GGML_OP_IM2COL: return HTP_OP_IM2COL; case GGML_OP_UNARY: switch (ggml_get_unary_op(t)) { case GGML_UNARY_OP_SILU: return HTP_OP_UNARY_SILU; case GGML_UNARY_OP_GELU: return HTP_OP_UNARY_GELU; case GGML_UNARY_OP_GELU_QUICK: return HTP_OP_UNARY_GELU; case GGML_UNARY_OP_SIGMOID: return HTP_OP_UNARY_SIGMOID; case GGML_UNARY_OP_NEG: return HTP_OP_UNARY_NEG; case GGML_UNARY_OP_EXP: return HTP_OP_UNARY_EXP; case GGML_UNARY_OP_SOFTPLUS: return HTP_OP_UNARY_SOFTPLUS; case GGML_UNARY_OP_TANH: return HTP_OP_UNARY_TANH; default: break; } break; case GGML_OP_GLU: switch (ggml_get_glu_op(t)) { case GGML_GLU_OP_SWIGLU: return HTP_OP_GLU_SWIGLU; case GGML_GLU_OP_SWIGLU_OAI: return HTP_OP_GLU_SWIGLU_OAI; case GGML_GLU_OP_GEGLU: return HTP_OP_GLU_GEGLU; default: break; } break; default: GGML_ABORT("\nggml-hex: graph-compute %s is not supported\n", ggml_op_desc(t)); } return HTP_OP_INVALID; } static inline bool op_is_compute(ggml_tensor *node) { return !ggml_op_is_empty(node->op) && !ggml_is_empty(node) && (node->flags & GGML_TENSOR_FLAG_COMPUTE); } static bool mm_is_hmx_eligible(const ggml_tensor * t) { if (opt_nhmx == 0) { return false; } const ggml_tensor * src0 = t->src[0]; const ggml_tensor * src1 = t->src[1]; const int wtype = src0->type; const bool is_repack = ggml_hexagon_is_repack_type((ggml_type) wtype); const bool is_matmul_id = (t->op == GGML_OP_MUL_MAT_ID); const bool is_batched = (src0->ne[2] * src0->ne[3] > 1 || src1->ne[2] * src1->ne[3] > 1); const int ne01_padded = is_repack ? hex_round_up(src0->ne[1], 32) : src0->ne[1]; return ggml_hexagon_matmul_is_hmx_eligible(src0, src1, t, ne01_padded, is_matmul_id, is_batched); } static bool is_mergeable_mul_mat(const ggml_tensor * t) { if (!t || t->op != GGML_OP_MUL_MAT) return false; if (t->src[1]->type != GGML_TYPE_F32) return false; return ggml_is_quantized(t->src[0]->type) && !mm_is_hmx_eligible(t); } static bool is_mergeable_mul_mat_pair(const ggml_tensor * n1, const ggml_tensor * n2) { if (!is_mergeable_mul_mat(n1) || !is_mergeable_mul_mat(n2)) { return false; } if (n1->src[1] != n2->src[1]) { return false; } if (n1->src[0]->ne[0] != n2->src[0]->ne[0]) { return false; } if (n1->src[0]->type != n2->src[0]->type) { return false; } return true; } static ggml_status ggml_backend_hexagon_graph_compute(ggml_backend_t backend, ggml_cgraph * graph) { auto sess = static_cast(backend->context); HEX_VERBOSE("ggml-hex: %s graph-compute n_nodes %d\n", sess->c_name(), graph->n_nodes); const std::vector * nodes_ptr = nullptr; std::vector computed_nodes; // Check for cache hit bool cache_hit = (graph->uid != 0 && sess->cached_uid == graph->uid); if (cache_hit) { nodes_ptr = &sess->cached_nodes; } else { // Tag fusable tensors in graph for (int i = 0; i < graph->n_nodes; i++) { auto * extra = (ggml_hexagon_tensor_extra *) graph->nodes[i]->extra; if (!extra) continue; if (graph->nodes[i]->op == GGML_OP_RMS_NORM && ggml_can_fuse(graph, i, { GGML_OP_RMS_NORM, GGML_OP_MUL })) { extra->flags |= GGML_HEXAGON_TENSOR_FUSEABLE; } else if (graph->nodes[i]->op == GGML_OP_MUL_MAT) { if ((i + 1 < graph->n_nodes && graph->nodes[i + 1]->op == GGML_OP_ADD && ggml_can_fuse(graph, i, { GGML_OP_MUL_MAT, GGML_OP_ADD })) || ggml_node_has_n_uses(graph, i, 1)) { extra->flags |= GGML_HEXAGON_TENSOR_FUSEABLE; } } } computed_nodes.reserve(graph->n_nodes); for (int i = 0; i < graph->n_nodes; ++i) { ggml_tensor * n = graph->nodes[i]; if (!op_is_compute(n)) { continue; } htp_opnode node(HTP_OP_INVALID, n); node.opcode = op_remap_to_htp(n); if (node.opcode == HTP_OP_MUL_MAT || node.opcode == HTP_OP_MUL_MAT_ID) { ggml_hexagon_precompute_matmul_params(sess, node.node->src[0], node.node->src[1], node.node, (struct htp_mm_kernel_params *)node.kernel_params ); } else if (node.opcode == HTP_OP_FLASH_ATTN_EXT) { ggml_hexagon_precompute_flash_attn_params(sess, node.node, (struct htp_fa_kernel_params *)node.kernel_params ); } else if (htp_op_is_unary(node.opcode)) { auto inputs = node.get_inputs(); const struct ggml_tensor * src0 = inputs[0]; const struct ggml_tensor * src1 = inputs.size() > 1 ? inputs[1] : nullptr; ggml_hexagon_precompute_unary_params(sess, node.opcode, src0, src1, node.dst(), (struct htp_unary_kernel_params *)node.kernel_params ); } else if (node.opcode == HTP_OP_GET_ROWS) { ggml_hexagon_precompute_get_rows_params(sess, node.node->src[0], node.node->src[1], node.dst(), (struct htp_get_rows_kernel_params *)node.kernel_params ); } else if (node.opcode == HTP_OP_SET_ROWS) { ggml_hexagon_precompute_set_rows_params(sess, node.node->src[0], node.node->src[1], node.dst(), (struct htp_set_rows_kernel_params *)node.kernel_params ); } computed_nodes.push_back(std::move(node)); } if (graph->uid != 0) { sess->cached_uid = graph->uid; sess->cached_nodes = std::move(computed_nodes); nodes_ptr = &sess->cached_nodes; } else { nodes_ptr = &computed_nodes; } } // Queue and execute for (const auto & node : *nodes_ptr) { sess->enqueue_op(node); } return GGML_STATUS_SUCCESS; } static void ggml_backend_hexagon_synchronize(ggml_backend_t backend) { auto sess = static_cast(backend->context); HEX_VERBOSE("ggml-hex: %s synchronize\n", sess->c_name()); // Wait until all pending ops complete sess->flush(); } enum ggml_hexagon_mem_range_type { HEXAGON_MEM_RANGE_TYPE_SRC, HEXAGON_MEM_RANGE_TYPE_DST, }; struct ggml_hexagon_mem_range { uint64_t pb; uint64_t p0; uint64_t p1; ggml_hexagon_mem_range_type pt; }; struct ggml_hexagon_mem_ranges { std::vector ranges; void reset() { ranges.clear(); } void add(const ggml_hexagon_mem_range & mr) { ranges.push_back(mr); } bool check(const ggml_hexagon_mem_range & mr) const { for (const auto & cmp : ranges) { if (mr.pb != cmp.pb) { continue; } if (mr.pt == HEXAGON_MEM_RANGE_TYPE_SRC && cmp.pt == HEXAGON_MEM_RANGE_TYPE_SRC) { continue; } if (mr.p0 < cmp.p1 && mr.p1 > cmp.p0) { return false; } } return true; } }; static ggml_hexagon_mem_range ggml_hexagon_mem_range_from_tensor(const ggml_tensor * tensor, ggml_hexagon_mem_range_type pt) { const ggml_tensor * base = tensor->view_src ? tensor->view_src : tensor; ggml_hexagon_mem_range mr; if (tensor->buffer) { mr = { /*.pb =*/ (uint64_t) tensor->buffer, /*.p0 =*/ (uint64_t) tensor->data, /*.p1 =*/ (uint64_t) tensor->data + ggml_backend_buft_get_alloc_size(tensor->buffer->buft, tensor), /*.pt =*/ pt, }; } else { mr = { /*.pb =*/ (uint64_t) base, /*.p0 =*/ 0, /*.p1 =*/ 1024, /*.pt =*/ pt, }; } return mr; } static void ggml_hexagon_mem_ranges_add_node(ggml_hexagon_mem_ranges & mrs, const htp_opnode & node) { if (node.is_empty()) return; for (int i = 0; i < GGML_MAX_SRC; i++) { if (node.node->src[i]) { mrs.add(ggml_hexagon_mem_range_from_tensor(node.node->src[i], HEXAGON_MEM_RANGE_TYPE_SRC)); } } for (const auto * fused : node.fused) { for (int i = 0; i < GGML_MAX_SRC; i++) { if (fused->src[i]) { mrs.add(ggml_hexagon_mem_range_from_tensor(fused->src[i], HEXAGON_MEM_RANGE_TYPE_SRC)); } } } mrs.add(ggml_hexagon_mem_range_from_tensor(node.dst(), HEXAGON_MEM_RANGE_TYPE_DST)); } static bool ggml_hexagon_mem_ranges_check_node(const ggml_hexagon_mem_ranges & mrs, const htp_opnode & node) { if (node.is_empty()) return true; for (int i = 0; i < GGML_MAX_SRC; i++) { if (node.node->src[i]) { if (!mrs.check(ggml_hexagon_mem_range_from_tensor(node.node->src[i], HEXAGON_MEM_RANGE_TYPE_SRC))) { return false; } } } for (const auto * fused : node.fused) { for (int i = 0; i < GGML_MAX_SRC; i++) { if (fused->src[i]) { if (!mrs.check(ggml_hexagon_mem_range_from_tensor(fused->src[i], HEXAGON_MEM_RANGE_TYPE_SRC))) { return false; } } } } return mrs.check(ggml_hexagon_mem_range_from_tensor(node.dst(), HEXAGON_MEM_RANGE_TYPE_DST)); } static std::vector ggml_hexagon_graph_optimize_reorder(const std::vector & nodes) { const int n = nodes.size(); std::vector res; res.reserve(n); std::vector used(n, false); ggml_hexagon_mem_ranges mrs; // The main goal here is to stack the MUL_MAT ops with the same src1 input. // This allows us to reuse dynamically quantized src1 in VTCM. for (int i0 = 0; i0 < n; i0++) { if (used[i0]) { continue; } const auto & node0 = nodes[i0]; if (!node0.stackable()) { res.push_back(i0); used[i0] = true; continue; } // that many nodes forward to search for stackable nodes that can reuse VTCM constexpr int N_FORWARD = 16; std::vector stack; stack.push_back(i0); mrs.reset(); for (int i1 = i0 + 1; i1 < i0 + N_FORWARD && i1 < n; i1++) { if (used[i1]) { continue; } const auto & node1 = nodes[i1]; if (node1.stackable() && node1.same_input(node0) && ggml_hexagon_mem_ranges_check_node(mrs, node1)) { stack.push_back(i1); } else { ggml_hexagon_mem_ranges_add_node(mrs, node1); } } for (int idx : stack) { res.push_back(idx); used[idx] = true; } } return res; } static void ggml_backend_hexagon_graph_optimize(ggml_backend_t backend, ggml_cgraph * gf) { const int n = gf->n_nodes; constexpr int MAX_FUSE = 16; enum ggml_op ops[MAX_FUSE]; std::vector nodes; nodes.reserve(gf->n_nodes); // Pack nodes for reordering for (int i = 0; i < n; i++) { htp_opnode node(HTP_OP_INVALID, gf->nodes[i]); // fuse only ops that start with these operations // can be expanded when needed if (node.op() == GGML_OP_ADD || node.op() == GGML_OP_NORM || node.op() == GGML_OP_RMS_NORM) { ops[0] = node.op(); int f = i + 1; while (f < n && f < i + MAX_FUSE) { // conservatively allow fusing only these ops // can be expanded when needed if (gf->nodes[f]->op != GGML_OP_ADD && gf->nodes[f]->op != GGML_OP_MUL && gf->nodes[f]->op != GGML_OP_NORM && gf->nodes[f]->op != GGML_OP_RMS_NORM) { break; } ops[f - i] = gf->nodes[f]->op; f++; } f -= i; for (; f > 1; f--) { if (ggml_can_fuse(gf, i, ops, f)) { break; } } // add the fused tensors into the node info so we can unfuse them later for (int k = 1; k < f; k++) { ++i; // the .dst() becomes the last fused tensor node.add_fused(gf->nodes[i]); } } nodes.push_back(std::move(node)); } const auto order = ggml_hexagon_graph_optimize_reorder(nodes); // unfuse { int j = 0; for (const auto i : order) { const auto & node = nodes[i]; gf->nodes[j++] = node.node; for (auto * fused : node.fused) { gf->nodes[j++] = fused; } } } GGML_UNUSED(backend); } static bool ggml_hexagon_cpy_tensor_async_phys(ggml_backend_t backend_src, ggml_backend_t backend_dst, const ggml_tensor * src, ggml_tensor * dst) { auto sess_src = static_cast(backend_src->context); auto sess_dst = static_cast(backend_dst->context); auto sbuf_dst = (ggml_hexagon_shared_buffer *) dst->buffer->context; if (sess_dst->fence_seq == 0) sess_dst->fence_seq = 1; uint32_t fence_seq = sess_dst->fence_seq++; if (sess_dst->fence_seq == 0) sess_dst->fence_seq = 1; volatile uint32_t * fence = (volatile uint32_t *) sbuf_dst->alloc_fence(); HEX_VERBOSE("ggml-hex: %s cpy-tensor-async %s -> %s size %zu : seq %u\n", sess_dst->name.c_str(), src->name, dst->name, ggml_nbytes(src), fence_seq); // dummy extra (must be static) static ggml_hexagon_tensor_extra fence_extra { {}, 0, GGML_HEXAGON_TENSOR_FENCE }; ggml_tensor fence_tensor {}; fence_tensor.buffer = dst->buffer; fence_tensor.extra = &fence_extra; fence_tensor.data = (void *) fence; fence_tensor.type = GGML_TYPE_I32; fence_tensor.ne[0] = 1; fence_tensor.ne[1] = 1; fence_tensor.ne[2] = 1; fence_tensor.ne[3] = 1; fence_tensor.nb[0] = sizeof(int32_t); fence_tensor.nb[1] = sizeof(int32_t); fence_tensor.nb[2] = sizeof(int32_t); fence_tensor.nb[3] = sizeof(int32_t); fence_tensor.op = GGML_OP_NONE; sess_src->enqueue_cpy(src, dst, &fence_tensor, fence_seq); sess_dst->enqueue_fence(&fence_tensor, fence_seq); sess_dst->add_sync_peer(sess_src); return true; } static bool ggml_hexagon_cpy_tensor_async_virt(ggml_backend_t backend_src, ggml_backend_t backend_dst, const ggml_tensor * src, ggml_tensor * dst) { auto sess_src = static_cast(backend_src->context); auto sess_dst = static_cast(backend_dst->context); auto sbuf_dst = (ggml_hexagon_shared_buffer *) dst->buffer->context; if (!sess_src->clone_buffer(sbuf_dst)) { return false; } HEX_VERBOSE("ggml-hex: %s cpy-tensor-async %s -> %s size %zu\n", sess_dst->name.c_str(), src->name, dst->name, ggml_nbytes(src)); sess_src->enqueue_cpy(src, dst); sess_src->flush(true); return true; } static bool ggml_backend_hexagon_cpy_tensor_async(ggml_backend_t backend_src, ggml_backend_t backend_dst, const ggml_tensor * src, ggml_tensor * dst) { if (!ggml_backend_is_hexagon(backend_src) || !ggml_backend_is_hexagon(backend_dst)) { return false; } *(ggml_hexagon_tensor_extra *) dst->extra = *(const ggml_hexagon_tensor_extra *) src->extra; auto sess_src = static_cast(backend_src->context); auto sess_dst = static_cast(backend_dst->context); if (sess_src == sess_dst) { HEX_VERBOSE("ggml-hex: %s cpy-tensor-async %s -> %s size %zu\n", sess_dst->name.c_str(), src->name, dst->name, ggml_nbytes(src)); sess_src->enqueue_cpy(src, dst); sess_src->flush_batch(); return true; } if (sess_src->phys_idx != sess_dst->phys_idx) return ggml_hexagon_cpy_tensor_async_phys(backend_src, backend_dst, src, dst); return ggml_hexagon_cpy_tensor_async_virt(backend_src, backend_dst, src, dst); } static ggml_backend_event_t ggml_backend_hexagon_device_event_new(ggml_backend_dev_t dev) { ggml_hexagon_event * hex_event = new ggml_hexagon_event(); HEX_VERBOSE("ggml-hex: %s event-new : event %p\n", ggml_backend_dev_name(dev), (void *)hex_event); return new ggml_backend_event { /* .device = */ dev, /* .context = */ hex_event, }; } static void ggml_backend_hexagon_device_event_free(ggml_backend_dev_t dev, ggml_backend_event_t event) { GGML_UNUSED(dev); if (event == nullptr) { return; } ggml_hexagon_event * hex_event = (ggml_hexagon_event *)event->context; HEX_VERBOSE("ggml-hex: %s event-free : event %p\n", ggml_backend_dev_name(dev), (void *)hex_event); delete hex_event; delete event; } static void ggml_backend_hexagon_device_event_synchronize(ggml_backend_dev_t dev, ggml_backend_event_t event) { GGML_UNUSED(dev); ggml_hexagon_event * hex_event = (ggml_hexagon_event *)event->context; HEX_VERBOSE("ggml-hex: %s event-synchronize : event %p seq %llu\n", ggml_backend_dev_name(dev), (void *)hex_event, (unsigned long long)hex_event->seq); if (hex_event->sess != nullptr) { hex_event->sess->wait_event(hex_event->seq); } } static void ggml_backend_hexagon_event_record(ggml_backend_t backend, ggml_backend_event_t event) { auto sess = static_cast(backend->context); ggml_hexagon_event * hex_event = (ggml_hexagon_event *)event->context; hex_event->sess = sess; hex_event->seq = sess->record_event(); HEX_VERBOSE("ggml-hex: %s event-record : event %p seq %llu\n", sess->c_name(), (void *)hex_event, (unsigned long long)hex_event->seq); } static void ggml_backend_hexagon_event_wait(ggml_backend_t backend, ggml_backend_event_t event) { GGML_UNUSED(backend); ggml_hexagon_event * hex_event = (ggml_hexagon_event *)event->context; if (hex_event->sess != nullptr) { HEX_VERBOSE("ggml-hex: %s event-wait : event %p seq %llu\n", hex_event->sess->c_name(), (void *)hex_event, (unsigned long long)hex_event->seq); hex_event->sess->wait_event(hex_event->seq); } } static void ggml_backend_hexagon_set_tensor_async(ggml_backend_t backend, struct ggml_tensor * tensor, const void * data, size_t offset, size_t size) { auto sess = static_cast(backend->context); HEX_VERBOSE("ggml-hex: %s set-tensor-async %s : data %p offset %zu size %zu usage %d\n", sess->c_name(), tensor->name, data, offset, size, tensor->buffer ? (int) tensor->buffer->usage : -1); ggml_backend_tensor_set(tensor, data, offset, size); } static void ggml_backend_hexagon_get_tensor_async(ggml_backend_t backend, const struct ggml_tensor * tensor, void * data, size_t offset, size_t size) { auto sess = static_cast(backend->context); HEX_VERBOSE("ggml-hex: %s get-tensor-async %s : data %p offset %zu size %zu usage %d\n", sess->c_name(), tensor->name, data, offset, size, tensor->buffer ? (int) tensor->buffer->usage : -1); sess->flush(true); ggml_backend_tensor_get(tensor, data, offset, size); } static void ggml_backend_hexagon_set_tensor_2d_async(ggml_backend_t backend, struct ggml_tensor * tensor, const void * data, size_t offset, size_t size, size_t n_copies, size_t stride_tensor, size_t stride_data) { auto sess = static_cast(backend->context); HEX_VERBOSE("ggml-hex: %s set-tensor-2d-async %s : data %p offset %zu size %zu n_copies %zu stride_tensor %zu stride_data %zu usage %d\n", sess->c_name(), tensor->name, data, offset, size, n_copies, stride_tensor, stride_data, tensor->buffer ? (int) tensor->buffer->usage : -1); ggml_backend_tensor_set_2d(tensor, data, offset, size, n_copies, stride_tensor, stride_data); } static void ggml_backend_hexagon_get_tensor_2d_async(ggml_backend_t backend, const struct ggml_tensor * tensor, void * data, size_t offset, size_t size, size_t n_copies, size_t stride_tensor, size_t stride_data) { auto sess = static_cast(backend->context); HEX_VERBOSE("ggml-hex: %s get-tensor-2d-async %s : data %p offset %zu size %zu n_copies %zu stride_tensor %zu stride_data %zu usage %d\n", sess->c_name(), tensor->name, data, offset, size, n_copies, stride_tensor, stride_data, tensor->buffer ? (int) tensor->buffer->usage : -1); sess->flush(true); ggml_backend_tensor_get_2d(tensor, data, offset, size, n_copies, stride_tensor, stride_data); } static struct ggml_backend_i hexagon_backend_i = { /* .get_name = */ ggml_backend_hexagon_name, /* .free = */ ggml_backend_hexagon_free, /* .set_tensor_async = */ ggml_backend_hexagon_set_tensor_async, /* .get_tensor_async = */ ggml_backend_hexagon_get_tensor_async, /* .set_tensor_2d_async = */ ggml_backend_hexagon_set_tensor_2d_async, /* .get_tensor_2d_async = */ ggml_backend_hexagon_get_tensor_2d_async, /* .cpy_tensor_async = */ ggml_backend_hexagon_cpy_tensor_async, /* .synchronize = */ ggml_backend_hexagon_synchronize, /* .graph_plan_create = */ NULL, /* .graph_plan_free = */ NULL, /* .graph_plan_update = */ NULL, /* .graph_plan_compute = */ NULL, /* .graph_compute = */ ggml_backend_hexagon_graph_compute, /* .event_record = */ ggml_backend_hexagon_event_record, /* .event_wait = */ ggml_backend_hexagon_event_wait, /* .graph_optimize = */ ggml_backend_hexagon_graph_optimize, }; static ggml_guid_t ggml_backend_hexagon_guid() { static ggml_guid guid = { 0x7b, 0x57, 0xdc, 0xaf, 0xde, 0x12, 0x1d, 0x49, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11 }; return &guid; } bool ggml_backend_is_hexagon(ggml_backend_t backend) { return backend && backend->iface.get_name == ggml_backend_hexagon_name; } // device interface static ggml_backend_t ggml_backend_hexagon_device_init(ggml_backend_dev_t dev, const char * params) { auto sess = static_cast(dev->context); return new ggml_backend{ /* .guid = */ ggml_backend_hexagon_guid(), /* .interface = */ hexagon_backend_i, /* .device = */ dev, /* .context = */ sess, }; GGML_UNUSED(params); } static const char * ggml_backend_hexagon_device_get_name(ggml_backend_dev_t dev) { auto sess = static_cast(dev->context); return sess->c_name(); GGML_UNUSED(dev); } static const char * ggml_backend_hexagon_device_get_description(ggml_backend_dev_t dev) { return "Hexagon"; GGML_UNUSED(dev); } static void ggml_backend_hexagon_device_get_memory(ggml_backend_dev_t dev, size_t * free, size_t * total) { *free = 0; *total = *free; GGML_UNUSED(dev); } static enum ggml_backend_dev_type ggml_backend_hexagon_device_get_type(ggml_backend_dev_t dev) { return GGML_BACKEND_DEVICE_TYPE_GPU; GGML_UNUSED(dev); } static void ggml_backend_hexagon_device_get_props(ggml_backend_dev_t dev, struct ggml_backend_dev_props * props) { props->name = ggml_backend_hexagon_device_get_name(dev); props->description = ggml_backend_hexagon_device_get_description(dev); props->type = ggml_backend_hexagon_device_get_type(dev); ggml_backend_hexagon_device_get_memory(dev, &props->memory_free, &props->memory_total); props->caps = { /* .async = */ true, /* .host_buffer = */ false, /* .buffer_from_host_ptr = */ false, /* .events = */ true, /* .mmap_support = */ false, }; } static ggml_backend_buffer_type_t ggml_backend_hexagon_device_get_buffer_type(ggml_backend_dev_t dev) { auto sess = static_cast(dev->context); return &sess->buffer_type; } static ggml_backend_buffer_type_t ggml_backend_hexagon_device_get_host_buffer_type(ggml_backend_dev_t dev) { if (!opt_hostbuf) { return NULL; } auto sess = static_cast(dev->context); return &sess->host_buffer_type; } static bool ggml_hexagon_supported_cpy(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { GGML_UNUSED(sess); const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; // for now we can do f32 -> f16 and f16 -> f32 (without reshaping) if (src0->type != GGML_TYPE_F32 && src0->type != GGML_TYPE_F16) return false; if ( dst->type != GGML_TYPE_F32 && dst->type != GGML_TYPE_F16) return false; const bool sametype = (src0->type == dst->type); const bool transposed = ggml_is_transposed(src0) || ggml_is_transposed(dst); const bool sameshape = !transposed && ggml_are_same_shape(src0, dst); // can handle any shape and any same-type (pretty slow if reshaping is required) if (sametype) return true; // cannot handle re-shaping and type conversion at the same time if (!sameshape) return false; return true; } static bool ggml_hexagon_supported_cont(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { GGML_UNUSED(sess); const struct ggml_tensor * src0 = op->src[0]; // CONT is same-type only, supports f32 and f16 if (src0->type != GGML_TYPE_F32 && src0->type != GGML_TYPE_F16) return false; return true; } static bool ggml_hexagon_supported_repeat(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { GGML_UNUSED(sess); const struct ggml_tensor * src0 = op->src[0]; const struct ggml_tensor * dst = op; // Support f32 and f16 if (src0->type != GGML_TYPE_F32 && src0->type != GGML_TYPE_F16) return false; // src and dst must be the same type if (src0->type != dst->type) return false; // dst dims must be multiples of src dims if (dst->ne[0] % src0->ne[0] != 0) return false; if (dst->ne[1] % src0->ne[1] != 0) return false; if (dst->ne[2] % src0->ne[2] != 0) return false; if (dst->ne[3] % src0->ne[3] != 0) return false; // require contiguous tensors (no transposition) if (ggml_is_transposed(src0) || ggml_is_transposed(dst)) return false; return true; } static bool ggml_hexagon_supported_concat(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { int dim = ((const int32_t *) op->op_params)[0]; if (dim < 0 || dim >= GGML_MAX_DIMS) { return false; } for (int i = 0; i < GGML_MAX_SRC; ++i) { const struct ggml_tensor * src = op->src[i]; if (!src) { continue; } if (src->type != GGML_TYPE_F32 && src->type != GGML_TYPE_I32 && src->type != GGML_TYPE_F16) { return false; } } return true; GGML_UNUSED(sess); } static bool ggml_hexagon_supported_fill(const struct ggml_hexagon_session * sess, const struct ggml_tensor * op) { const struct ggml_tensor * dst = op; if (dst->type != GGML_TYPE_F32 && dst->type != GGML_TYPE_F16) { return false; } return true; GGML_UNUSED(sess); } static bool ggml_backend_hexagon_device_supports_op(ggml_backend_dev_t dev, const struct ggml_tensor * op) { auto sess = static_cast(dev->context); // reject ops that match the filter if (opt_opfilter && std::regex_match(ggml_op_desc(op), *opt_opfilter)) { return false; } bool supp = false; switch (op->op) { case GGML_OP_NONE: case GGML_OP_RESHAPE: case GGML_OP_VIEW: case GGML_OP_PERMUTE: case GGML_OP_TRANSPOSE: supp = true; break; case GGML_OP_MUL: case GGML_OP_ADD: case GGML_OP_SUB: case GGML_OP_DIV: supp = ggml_hexagon_supported_binary(sess, op); break; case GGML_OP_MUL_MAT: supp = ggml_hexagon_supported_mul_mat(sess, op); break; case GGML_OP_MUL_MAT_ID: supp = ggml_hexagon_supported_mul_mat_id(sess, op); break; case GGML_OP_ADD_ID: supp = ggml_hexagon_supported_add_id(sess, op); break; case GGML_OP_NORM: case GGML_OP_L2_NORM: case GGML_OP_RMS_NORM: case GGML_OP_SCALE: case GGML_OP_CLAMP: supp = ggml_hexagon_supported_unary(sess, op); break; case GGML_OP_SQR: case GGML_OP_SQRT: supp = ggml_hexagon_supported_unary(sess, op); break; case GGML_OP_SUM_ROWS: supp = ggml_hexagon_supported_sum_rows(sess, op); break; case GGML_OP_SOFT_MAX: supp = ggml_hexagon_supported_softmax(sess, op); break; case GGML_OP_UNARY: switch (ggml_get_unary_op(op)) { case GGML_UNARY_OP_NEG: case GGML_UNARY_OP_EXP: case GGML_UNARY_OP_SIGMOID: case GGML_UNARY_OP_SOFTPLUS: case GGML_UNARY_OP_TANH: case GGML_UNARY_OP_SILU: case GGML_UNARY_OP_GELU: case GGML_UNARY_OP_GELU_QUICK: supp = ggml_hexagon_supported_unary(sess, op); break; default: break; } break; case GGML_OP_GLU: switch (ggml_get_glu_op(op)) { case GGML_GLU_OP_SWIGLU: case GGML_GLU_OP_SWIGLU_OAI: case GGML_GLU_OP_GEGLU: supp = ggml_hexagon_supported_activations(sess, op); break; default: break; } break; case GGML_OP_ROPE: supp = ggml_hexagon_supported_rope(sess, op); break; case GGML_OP_FLASH_ATTN_EXT: supp = ggml_hexagon_supported_flash_attn_ext(sess, op); break; case GGML_OP_SET_ROWS: supp = ggml_hexagon_supported_set_rows(sess, op); break; case GGML_OP_GET_ROWS: supp = ggml_hexagon_supported_get_rows(sess, op); break; case GGML_OP_CPY: supp = ggml_hexagon_supported_cpy(sess, op); break; case GGML_OP_CONT: supp = ggml_hexagon_supported_cont(sess, op); break; case GGML_OP_REPEAT: supp = ggml_hexagon_supported_repeat(sess, op); break; case GGML_OP_ARGSORT: supp = ggml_hexagon_supported_argsort(sess, op); break; case GGML_OP_SSM_CONV: supp = ggml_hexagon_supported_ssm_conv(sess, op); break; case GGML_OP_IM2COL: supp = ggml_hexagon_supported_im2col(sess, op); break; case GGML_OP_GATED_DELTA_NET: supp = ggml_hexagon_supported_gated_delta_net(sess, op); break; case GGML_OP_CUMSUM: supp = ggml_hexagon_supported_cumsum(sess, op); break; case GGML_OP_CONCAT: supp = ggml_hexagon_supported_concat(sess, op); break; case GGML_OP_FILL: supp = ggml_hexagon_supported_fill(sess, op); break; case GGML_OP_DIAG: supp = ggml_hexagon_supported_diag(sess, op); break; case GGML_OP_SOLVE_TRI: supp = ggml_hexagon_supported_solve_tri(sess, op); break; case GGML_OP_TRI: supp = ggml_hexagon_supported_tri(sess, op); break; case GGML_OP_PAD: supp = ggml_hexagon_supported_pad(sess, op); break; default: break; } ggml_hexagon_dump_op_supp(sess->name, op, supp); return supp; } static bool ggml_backend_hexagon_device_supports_buft(ggml_backend_dev_t dev, ggml_backend_buffer_type_t buft) { auto sess = static_cast(dev->context); // Technically we can clone hexagon buffers from any session but for some reason the output is garbled with layer-split, // tensor-split works correctly, so it needs mode debugging and investigation. For now accept only our own buffers. #if 0 bool supp = (buft->iface.get_alignment == ggml_backend_hexagon_buffer_type_get_alignment); #else bool supp = (buft == &sess->host_buffer_type) || (buft == &sess->buffer_type); #endif HEX_VERBOSE("ggml-hex: %s device-supports-buft %s %s\n", sess->name.c_str(), ggml_backend_buft_name(buft), supp ? "yes" : "no"); return supp; } static const struct ggml_backend_device_i ggml_backend_hexagon_device_i = { /* .get_name = */ ggml_backend_hexagon_device_get_name, /* .get_description = */ ggml_backend_hexagon_device_get_description, /* .get_memory = */ ggml_backend_hexagon_device_get_memory, /* .get_type = */ ggml_backend_hexagon_device_get_type, /* .get_props = */ ggml_backend_hexagon_device_get_props, /* .init_backend = */ ggml_backend_hexagon_device_init, /* .get_buffer_type = */ ggml_backend_hexagon_device_get_buffer_type, /* .get_host_buffer_type = */ ggml_backend_hexagon_device_get_host_buffer_type, /* .buffer_from_host_ptr = */ NULL, // ggml_backend_hexagon_device_buffer_from_ptr, /* .supports_op = */ ggml_backend_hexagon_device_supports_op, /* .supports_buft = */ ggml_backend_hexagon_device_supports_buft, /* .offload_op = */ NULL, // ggml_backend_hexagon_device_offload_op, /* .event_new = */ ggml_backend_hexagon_device_event_new, /* .event_free = */ ggml_backend_hexagon_device_event_free, /* .event_synchronize = */ ggml_backend_hexagon_device_event_synchronize, }; //** backend registry ggml_hexagon_registry::ggml_hexagon_registry(ggml_backend_reg_t reg) { GGML_LOG_INFO("ggml-hex: Hexagon backend (experimental) : allocating new registry : ndev %zu\n", opt_ndev); GGML_LOG_INFO("ggml-hex: Hexagon Arch version v%d\n", opt_arch); // Create devices / sessions for (size_t i = 0; i < opt_ndev; i++) { devices[i].iface = ggml_backend_hexagon_device_i; devices[i].reg = reg; try { devices[i].context = new ggml_hexagon_session(i, &devices[i]); } catch (const std::exception & exc) { GGML_LOG_ERROR("ggml-hex: failed to create device/session %zu\n", i); devices[i].context = nullptr; } } } ggml_hexagon_registry::~ggml_hexagon_registry() { GGML_LOG_INFO("ggml-hex: releasing registry\n"); // Release devices / sessions for (size_t i = 0; i < opt_ndev; i++) { auto sess = static_cast(devices[i].context); delete sess; } } static const char * ggml_backend_hexagon_reg_get_name(ggml_backend_reg_t reg) { return "HTP"; GGML_UNUSED(reg); } static size_t ggml_backend_hexagon_reg_get_device_count(ggml_backend_reg_t reg) { return opt_ndev; GGML_UNUSED(reg); } static ggml_backend_dev_t ggml_backend_hexagon_reg_get_device(ggml_backend_reg_t reg, size_t index) { auto hreg = static_cast(reg->context); if (index >= opt_ndev || !hreg->devices[index].context) { return nullptr; } return &hreg->devices[index]; } // ** communication context for tensor-split allreduce static void * ggml_backend_hexagon_comm_init(ggml_backend_t * backends, size_t n_backends) { if (n_backends < 2 || n_backends > 4) { return nullptr; } for (size_t i = 0; i < n_backends; ++i) { if (!ggml_backend_is_hexagon(backends[i])) { return nullptr; } } auto * ctx = new ggml_backend_hexagon_comm_context(); ctx->backends.assign(backends, backends + n_backends); ctx->n_backends = n_backends; ctx->fence_seq = (((uintptr_t) ctx) & 0xFFFF) | 1; return ctx; } static void ggml_backend_hexagon_comm_free(void * comm_ctx_v) { if (!comm_ctx_v) return; delete static_cast(comm_ctx_v); } static bool ggml_backend_hexagon_comm_allreduce_tensor(void * comm_ctx_v, struct ggml_tensor ** tensors) { if (opt_ar_select == 0 || !comm_ctx_v) return false; auto * comm_ctx = static_cast(comm_ctx_v); const size_t n_backends = comm_ctx->n_backends; if (n_backends < 2 || n_backends > 4) return false; for (size_t i = 0; i < n_backends; i++) { if (!tensors[i] || !tensors[i]->buffer || !ggml_backend_buffer_is_hexagon(tensors[i]->buffer)) { return false; } if (tensors[i]->type != tensors[0]->type) { return false; } if (!ggml_is_contiguous(tensors[i])) { return false; } if (ggml_nelements(tensors[i]) != ggml_nelements(tensors[0])) { return false; } } if (tensors[0]->type != GGML_TYPE_F16 && tensors[0]->type != GGML_TYPE_F32) { return false; } for (size_t r = 0; r < n_backends; r++) { auto sess = static_cast(comm_ctx->backends[r]->context); struct htp_allreduce_kernel_params kparams; if (!ggml_hexagon_precompute_allreduce_params(sess, tensors[r], (uint32_t) r, (uint32_t) n_backends, false, false, &kparams)) { return false; } } if (comm_ctx->fence_seq == 0) comm_ctx->fence_seq = 1; uint32_t fence_seq_entry = comm_ctx->fence_seq++; if (comm_ctx->fence_seq == 0) comm_ctx->fence_seq = 1; uint32_t fence_seq_exit = comm_ctx->fence_seq++; if (comm_ctx->fence_seq == 0) comm_ctx->fence_seq = 1; volatile uint32_t * fences[GGML_HEXAGON_MAX_SESSIONS]; for (size_t i = 0; i < n_backends; i++) { auto sbuf = (ggml_hexagon_shared_buffer *) tensors[i]->buffer->context; fences[i] = (volatile uint32_t *) sbuf->alloc_fence(); } static ggml_hexagon_tensor_extra fence_extra { {}, 0, GGML_HEXAGON_TENSOR_FENCE }; ggml_tensor fence_tensors[GGML_HEXAGON_MAX_SESSIONS]; for (size_t i = 0; i < n_backends; i++) { fence_tensors[i] = {}; fence_tensors[i].buffer = tensors[i]->buffer; fence_tensors[i].extra = &fence_extra; fence_tensors[i].data = (void *) fences[i]; fence_tensors[i].type = GGML_TYPE_I32; fence_tensors[i].ne[0] = 4; fence_tensors[i].ne[1] = 1; fence_tensors[i].ne[2] = 1; fence_tensors[i].ne[3] = 1; fence_tensors[i].nb[0] = sizeof(int32_t); fence_tensors[i].nb[1] = sizeof(int32_t); fence_tensors[i].nb[2] = sizeof(int32_t); fence_tensors[i].nb[3] = sizeof(int32_t); fence_tensors[i].op = GGML_OP_NONE; } std::vector data_tensors(n_backends); std::vector sync_tensors(n_backends); for (size_t i = 0; i < n_backends; i++) { data_tensors[i] = tensors[i]; sync_tensors[i] = &fence_tensors[i]; } for (size_t r = 0; r < n_backends; r++) { auto sess = static_cast(comm_ctx->backends[r]->context); sess->enqueue_allreduce(tensors[r], data_tensors, sync_tensors, (uint32_t) r, (uint32_t) n_backends, fence_seq_entry, fence_seq_exit); for (size_t j = 0; j < n_backends; j++) { if (r != j) { sess->add_sync_peer(static_cast(comm_ctx->backends[j]->context)); } } } return true; } static void * ggml_backend_hexagon_get_proc_address(ggml_backend_reg_t reg, const char * name) { GGML_UNUSED(reg); if (strcmp(name, "ggml_backend_comm_init") == 0) { return (void *) ggml_backend_hexagon_comm_init; } if (strcmp(name, "ggml_backend_comm_free") == 0) { return (void *) ggml_backend_hexagon_comm_free; } if (strcmp(name, "ggml_backend_comm_allreduce_tensor") == 0) { return (void *) ggml_backend_hexagon_comm_allreduce_tensor; } return NULL; } template std::vector str_to_vec(const char* str) { std::stringstream ss(str); std::vector v; std::string t; while (std::getline(ss, t, ',')) { v.push_back(std::stoul(t, nullptr, 0)); } return v; } template std::string vec_to_str(std::vector v) { std::stringstream ss; ss << std::setbase(BASE) << std::showbase; for (auto i : v) { ss << i << ','; } auto str = ss.str(); str.pop_back(); // drop last comma return str; } static void ggml_hexagon_init(ggml_backend_reg * reg) { // Basic sanity checks to make sure definitions match static_assert((unsigned int) HTP_TYPE_Q4_0 == (unsigned int) GGML_TYPE_Q4_0, "please update hexagon_type to match ggml_type"); static_assert((unsigned int) HTP_TYPE_Q4_1 == (unsigned int) GGML_TYPE_Q4_1, "please update hexagon_type to match ggml_type"); static_assert((unsigned int) HTP_TYPE_Q8_0 == (unsigned int) GGML_TYPE_Q8_0, "please update hexagon_type to match ggml_type"); static_assert((unsigned int) HTP_TYPE_MXFP4 == (unsigned int) GGML_TYPE_MXFP4, "please update hexagon_type to match ggml_type"); static_assert((unsigned int) HTP_TYPE_IQ4_NL == (unsigned int) GGML_TYPE_IQ4_NL, "please update hexagon_type to match ggml_type"); const char * str_verbose = getenv("GGML_HEXAGON_VERBOSE"); const char * str_opbatch = getenv("GGML_HEXAGON_OPBATCH"); const char * str_opqueue = getenv("GGML_HEXAGON_OPQUEUE"); const char * str_oppoll = getenv("GGML_HEXAGON_OPPOLL"); const char * str_opfusion = getenv("GGML_HEXAGON_OPFUSION"); const char * str_opfilter = getenv("GGML_HEXAGON_OPFILTER"); const char * str_profile = getenv("GGML_HEXAGON_PROFILE"); const char * str_etm = getenv("GGML_HEXAGON_ETM"); const char * str_nhvx = getenv("GGML_HEXAGON_NHVX"); const char * str_nhmx = getenv("GGML_HEXAGON_NHMX"); const char * str_mm_select = getenv("GGML_HEXAGON_MM_SELECT"); const char * str_fa_select = getenv("GGML_HEXAGON_FA_SELECT"); const char * str_ar_select = getenv("GGML_HEXAGON_AR_SELECT"); const char * str_ndev = getenv("GGML_HEXAGON_NDEV"); const char * str_arch = getenv("GGML_HEXAGON_ARCH"); const char * str_vmem = getenv("GGML_HEXAGON_VMEM"); const char * str_mbuf = getenv("GGML_HEXAGON_MBUF"); const char * str_optrace = getenv("GGML_HEXAGON_OPTRACE"); const char * str_hostbuf = getenv("GGML_HEXAGON_HOSTBUF"); // Init Arch first since it affects other defaults if (!str_arch) { int err = htpdrv_get_arch(CDSP_DOMAIN_ID, &opt_arch); if (err != 0) { GGML_LOG_ERROR("ggml-hex: failed to query HTP version (err %d) defaulting to v73\n", err); opt_arch = 73; } else { if (opt_arch < 73) { GGML_LOG_WARN("ggml-hex: Hexagon arch v%d is under supported range, capping at v73\n", opt_arch); opt_arch = 73; } else if (opt_arch > 81) { GGML_LOG_WARN("ggml-hex: Hexagon arch v%d is over supported range, capping at v81\n", opt_arch); opt_arch = 81; } } } else { if (str_arch[0] == 'v' || str_arch[0] == 'V') { str_arch++; } opt_arch = strtoul(str_arch, NULL, 0); } size_t MiB = 1024 * 1024; // Update vmem default opt_vmem = opt_arch >= 75 ? HTP_OP_MAX_VMEM_DEFAULT : 3000 * MiB; auto RE_ICASE = std::regex_constants::icase; opt_opfilter = str_opfilter ? new std::regex(str_opfilter, RE_ICASE) : NULL; opt_verbose = str_verbose ? atoi(str_verbose) : 0; opt_opbatch = str_opbatch ? strtoul(str_opbatch, NULL, 0) : opt_opbatch; opt_opqueue = str_opqueue ? strtoul(str_opqueue, NULL, 0) : opt_opqueue; opt_optrace = str_optrace ? strtoul(str_optrace, NULL, 0) : (opt_opbatch * 256); opt_oppoll = str_oppoll ? strtoul(str_oppoll, NULL, 0) : opt_oppoll; opt_opfusion = str_opfusion ? atoi(str_opfusion) : opt_opfusion; opt_profile = str_profile ? atoi(str_profile) : 0; opt_etm = str_etm ? atoi(str_etm) : 0; opt_nhvx = str_nhvx ? strtoul(str_nhvx, NULL, 0) : opt_nhvx; opt_nhmx = str_nhmx ? atoi(str_nhmx) : opt_nhmx; opt_mm_select = str_mm_select ? atoi(str_mm_select) : opt_mm_select; opt_fa_select = str_fa_select ? atoi(str_fa_select) : opt_fa_select; opt_ar_select = str_ar_select ? atoi(str_ar_select) : opt_ar_select; opt_mbuf = str_mbuf ? strtoul(str_mbuf, NULL, 0) * MiB : opt_mbuf; opt_vmem = str_vmem ? strtoul(str_vmem, NULL, 0) * MiB : opt_vmem; opt_hostbuf = str_hostbuf ? atoi(str_hostbuf) != 0 : opt_hostbuf; // Parse device configuration const char * str_devices = getenv("GGML_HEXAGON_DEVICES"); if (!str_devices && str_ndev && str_ndev[0] != '\0') { GGML_LOG_WARN("DEPRECATED: GGML_HEXAGON_NDEV is deprecated. use GGML_HEXAGON_DEVICES instead\n"); str_devices = str_ndev; } if (str_devices && str_devices[0] != '\0') { bool is_single_number = true; for (int i = 0; str_devices[i] != '\0'; i++) { if (!isdigit((unsigned char)str_devices[i])) { is_single_number = false; break; } } if (is_single_number) { int n = atoi(str_devices); if (n < 1) n = 1; if (n > GGML_HEXAGON_MAX_SESSIONS) n = GGML_HEXAGON_MAX_SESSIONS; opt_ndev = n; for (size_t i = 0; i < opt_ndev; i++) { opt_device_configs[i].physical_idx = 0; opt_device_configs[i].virtual_idx = (int)i; opt_device_configs[i].name = "HTP" + std::to_string(i); } } else { std::string s_devices(str_devices); std::stringstream ss(s_devices); std::string item; opt_ndev = 0; while (std::getline(ss, item, ',')) { size_t start = item.find_first_not_of(" \t\r\n"); size_t end = item.find_last_not_of(" \t\r\n"); if (start == std::string::npos) { continue; } item = item.substr(start, end - start + 1); if (item.rfind("HTP", 0) == 0) { std::string rest = item.substr(3); size_t colon_pos = rest.find(':'); int phys = 0; int virt = 0; try { if (colon_pos == std::string::npos) { phys = std::stoi(rest); virt = 0; } else { phys = std::stoi(rest.substr(0, colon_pos)); virt = std::stoi(rest.substr(colon_pos + 1)); } } catch (...) { GGML_LOG_WARN("ggml-hex: failed to parse device index in '%s'\n", item.c_str()); continue; } if (opt_ndev < GGML_HEXAGON_MAX_SESSIONS) { opt_device_configs[opt_ndev].physical_idx = phys; opt_device_configs[opt_ndev].virtual_idx = virt; opt_device_configs[opt_ndev].name = colon_pos == std::string::npos ? "HTP" + std::to_string(phys) : "HTP" + std::to_string(phys) + ":" + std::to_string(virt); opt_ndev++; } else { GGML_LOG_WARN("ggml-hex: max sessions limit reached (%d), ignoring device %s\n", GGML_HEXAGON_MAX_SESSIONS, item.c_str()); } } else { GGML_LOG_WARN("ggml-hex: invalid device name format '%s', must start with HTP\n", item.c_str()); } } } } else { opt_ndev = 1; opt_device_configs[0].physical_idx = 0; opt_device_configs[0].virtual_idx = 0; opt_device_configs[0].name = "HTP0"; } #if defined(__ANDROID__) if (opt_arch < 75) { opt_ndev = 1; GGML_LOG_WARN("ggml-hex: forcing ndev to 1 for SoCs archs lower than v75.\n"); } #endif if (str_profile) { opt_pmu_evt = [&]() -> std::vector { auto v = str_to_vec(str_profile); switch (v.size()) { case 1: opt_profile = v[0]; return opt_pmu_evt; // mode with default pmu events case 8: opt_profile = 2; return v; // mode with custom pmu events default: opt_profile = 0; return {}; // garbage input }}(); if (opt_profile == 1) opt_pmu_evt = {}; GGML_LOG_INFO("ggml-hex: Profiling mode %u : pmu-evt [ %s ]\n", opt_profile, vec_to_str(opt_pmu_evt).c_str()); } reg->context = new ggml_hexagon_registry(reg); } static const struct ggml_backend_reg_i ggml_backend_hexagon_reg_i = { /* .get_name = */ ggml_backend_hexagon_reg_get_name, /* .get_device_count = */ ggml_backend_hexagon_reg_get_device_count, /* .get_device = */ ggml_backend_hexagon_reg_get_device, /* .get_proc_address = */ ggml_backend_hexagon_get_proc_address, }; ggml_backend_reg_t ggml_backend_hexagon_reg(void) { static bool initialized = false; static ggml_backend_reg reg = { /* .api_version = */ GGML_BACKEND_API_VERSION, /* .iface = */ ggml_backend_hexagon_reg_i, /* .context = */ NULL }; { static std::mutex mutex; std::lock_guard lock(mutex); if (!initialized) { auto nErr = htpdrv_init(); if (nErr != AEE_SUCCESS) { return NULL; } ggml_hexagon_init(®); } initialized = true; } return ® } GGML_BACKEND_DL_IMPL(ggml_backend_hexagon_reg)