2 * Copyright 2014 Advanced Micro Devices, Inc.
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
22 * Authors: Alex Deucher
25 #include <linux/delay.h>
26 #include <linux/firmware.h>
27 #include <linux/module.h>
30 #include "amdgpu_ucode.h"
31 #include "amdgpu_trace.h"
35 #include "oss/oss_2_4_d.h"
36 #include "oss/oss_2_4_sh_mask.h"
38 #include "gmc/gmc_7_1_d.h"
39 #include "gmc/gmc_7_1_sh_mask.h"
41 #include "gca/gfx_8_0_d.h"
42 #include "gca/gfx_8_0_enum.h"
43 #include "gca/gfx_8_0_sh_mask.h"
45 #include "bif/bif_5_0_d.h"
46 #include "bif/bif_5_0_sh_mask.h"
48 #include "iceland_sdma_pkt_open.h"
50 #include "ivsrcid/ivsrcid_vislands30.h"
52 static void sdma_v2_4_set_ring_funcs(struct amdgpu_device *adev);
53 static void sdma_v2_4_set_buffer_funcs(struct amdgpu_device *adev);
54 static void sdma_v2_4_set_vm_pte_funcs(struct amdgpu_device *adev);
55 static void sdma_v2_4_set_irq_funcs(struct amdgpu_device *adev);
57 MODULE_FIRMWARE("amdgpu/topaz_sdma.bin");
58 MODULE_FIRMWARE("amdgpu/topaz_sdma1.bin");
60 static const u32 sdma_offsets[SDMA_MAX_INSTANCE] =
62 SDMA0_REGISTER_OFFSET,
66 static const u32 golden_settings_iceland_a11[] =
68 mmSDMA0_CHICKEN_BITS, 0xfc910007, 0x00810007,
69 mmSDMA0_CLK_CTRL, 0xff000fff, 0x00000000,
70 mmSDMA1_CHICKEN_BITS, 0xfc910007, 0x00810007,
71 mmSDMA1_CLK_CTRL, 0xff000fff, 0x00000000,
74 static const u32 iceland_mgcg_cgcg_init[] =
76 mmSDMA0_CLK_CTRL, 0xff000ff0, 0x00000100,
77 mmSDMA1_CLK_CTRL, 0xff000ff0, 0x00000100
82 * Starting with CIK, the GPU has new asynchronous
83 * DMA engines. These engines are used for compute
84 * and gfx. There are two DMA engines (SDMA0, SDMA1)
85 * and each one supports 1 ring buffer used for gfx
86 * and 2 queues used for compute.
88 * The programming model is very similar to the CP
89 * (ring buffer, IBs, etc.), but sDMA has it's own
90 * packet format that is different from the PM4 format
91 * used by the CP. sDMA supports copying data, writing
92 * embedded data, solid fills, and a number of other
93 * things. It also has support for tiling/detiling of
97 static void sdma_v2_4_init_golden_registers(struct amdgpu_device *adev)
99 switch (adev->asic_type) {
101 amdgpu_device_program_register_sequence(adev,
102 iceland_mgcg_cgcg_init,
103 ARRAY_SIZE(iceland_mgcg_cgcg_init));
104 amdgpu_device_program_register_sequence(adev,
105 golden_settings_iceland_a11,
106 ARRAY_SIZE(golden_settings_iceland_a11));
113 static void sdma_v2_4_free_microcode(struct amdgpu_device *adev)
116 for (i = 0; i < adev->sdma.num_instances; i++) {
117 release_firmware(adev->sdma.instance[i].fw);
118 adev->sdma.instance[i].fw = NULL;
123 * sdma_v2_4_init_microcode - load ucode images from disk
125 * @adev: amdgpu_device pointer
127 * Use the firmware interface to load the ucode images into
128 * the driver (not loaded into hw).
129 * Returns 0 on success, error on failure.
131 static int sdma_v2_4_init_microcode(struct amdgpu_device *adev)
133 const char *chip_name;
136 struct amdgpu_firmware_info *info = NULL;
137 const struct common_firmware_header *header = NULL;
138 const struct sdma_firmware_header_v1_0 *hdr;
142 switch (adev->asic_type) {
149 for (i = 0; i < adev->sdma.num_instances; i++) {
151 snprintf(fw_name, sizeof(fw_name), "amdgpu/%s_sdma.bin", chip_name);
153 snprintf(fw_name, sizeof(fw_name), "amdgpu/%s_sdma1.bin", chip_name);
154 err = request_firmware(&adev->sdma.instance[i].fw, fw_name, adev->dev);
157 err = amdgpu_ucode_validate(adev->sdma.instance[i].fw);
160 hdr = (const struct sdma_firmware_header_v1_0 *)adev->sdma.instance[i].fw->data;
161 adev->sdma.instance[i].fw_version = le32_to_cpu(hdr->header.ucode_version);
162 adev->sdma.instance[i].feature_version = le32_to_cpu(hdr->ucode_feature_version);
163 if (adev->sdma.instance[i].feature_version >= 20)
164 adev->sdma.instance[i].burst_nop = true;
166 if (adev->firmware.load_type == AMDGPU_FW_LOAD_SMU) {
167 info = &adev->firmware.ucode[AMDGPU_UCODE_ID_SDMA0 + i];
168 info->ucode_id = AMDGPU_UCODE_ID_SDMA0 + i;
169 info->fw = adev->sdma.instance[i].fw;
170 header = (const struct common_firmware_header *)info->fw->data;
171 adev->firmware.fw_size +=
172 ALIGN(le32_to_cpu(header->ucode_size_bytes), PAGE_SIZE);
178 pr_err("sdma_v2_4: Failed to load firmware \"%s\"\n", fw_name);
179 for (i = 0; i < adev->sdma.num_instances; i++) {
180 release_firmware(adev->sdma.instance[i].fw);
181 adev->sdma.instance[i].fw = NULL;
188 * sdma_v2_4_ring_get_rptr - get the current read pointer
190 * @ring: amdgpu ring pointer
192 * Get the current rptr from the hardware (VI+).
194 static uint64_t sdma_v2_4_ring_get_rptr(struct amdgpu_ring *ring)
196 /* XXX check if swapping is necessary on BE */
197 return ring->adev->wb.wb[ring->rptr_offs] >> 2;
201 * sdma_v2_4_ring_get_wptr - get the current write pointer
203 * @ring: amdgpu ring pointer
205 * Get the current wptr from the hardware (VI+).
207 static uint64_t sdma_v2_4_ring_get_wptr(struct amdgpu_ring *ring)
209 struct amdgpu_device *adev = ring->adev;
210 u32 wptr = RREG32(mmSDMA0_GFX_RB_WPTR + sdma_offsets[ring->me]) >> 2;
216 * sdma_v2_4_ring_set_wptr - commit the write pointer
218 * @ring: amdgpu ring pointer
220 * Write the wptr back to the hardware (VI+).
222 static void sdma_v2_4_ring_set_wptr(struct amdgpu_ring *ring)
224 struct amdgpu_device *adev = ring->adev;
226 WREG32(mmSDMA0_GFX_RB_WPTR + sdma_offsets[ring->me], lower_32_bits(ring->wptr) << 2);
229 static void sdma_v2_4_ring_insert_nop(struct amdgpu_ring *ring, uint32_t count)
231 struct amdgpu_sdma_instance *sdma = amdgpu_sdma_get_instance_from_ring(ring);
234 for (i = 0; i < count; i++)
235 if (sdma && sdma->burst_nop && (i == 0))
236 amdgpu_ring_write(ring, ring->funcs->nop |
237 SDMA_PKT_NOP_HEADER_COUNT(count - 1));
239 amdgpu_ring_write(ring, ring->funcs->nop);
243 * sdma_v2_4_ring_emit_ib - Schedule an IB on the DMA engine
245 * @ring: amdgpu ring pointer
246 * @ib: IB object to schedule
248 * Schedule an IB in the DMA ring (VI).
250 static void sdma_v2_4_ring_emit_ib(struct amdgpu_ring *ring,
251 struct amdgpu_job *job,
252 struct amdgpu_ib *ib,
255 unsigned vmid = AMDGPU_JOB_GET_VMID(job);
257 /* IB packet must end on a 8 DW boundary */
258 sdma_v2_4_ring_insert_nop(ring, (2 - lower_32_bits(ring->wptr)) & 7);
260 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_INDIRECT) |
261 SDMA_PKT_INDIRECT_HEADER_VMID(vmid & 0xf));
262 /* base must be 32 byte aligned */
263 amdgpu_ring_write(ring, lower_32_bits(ib->gpu_addr) & 0xffffffe0);
264 amdgpu_ring_write(ring, upper_32_bits(ib->gpu_addr));
265 amdgpu_ring_write(ring, ib->length_dw);
266 amdgpu_ring_write(ring, 0);
267 amdgpu_ring_write(ring, 0);
272 * sdma_v2_4_hdp_flush_ring_emit - emit an hdp flush on the DMA ring
274 * @ring: amdgpu ring pointer
276 * Emit an hdp flush packet on the requested DMA ring.
278 static void sdma_v2_4_ring_emit_hdp_flush(struct amdgpu_ring *ring)
280 u32 ref_and_mask = 0;
283 ref_and_mask = REG_SET_FIELD(ref_and_mask, GPU_HDP_FLUSH_DONE, SDMA0, 1);
285 ref_and_mask = REG_SET_FIELD(ref_and_mask, GPU_HDP_FLUSH_DONE, SDMA1, 1);
287 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_POLL_REGMEM) |
288 SDMA_PKT_POLL_REGMEM_HEADER_HDP_FLUSH(1) |
289 SDMA_PKT_POLL_REGMEM_HEADER_FUNC(3)); /* == */
290 amdgpu_ring_write(ring, mmGPU_HDP_FLUSH_DONE << 2);
291 amdgpu_ring_write(ring, mmGPU_HDP_FLUSH_REQ << 2);
292 amdgpu_ring_write(ring, ref_and_mask); /* reference */
293 amdgpu_ring_write(ring, ref_and_mask); /* mask */
294 amdgpu_ring_write(ring, SDMA_PKT_POLL_REGMEM_DW5_RETRY_COUNT(0xfff) |
295 SDMA_PKT_POLL_REGMEM_DW5_INTERVAL(10)); /* retry count, poll interval */
299 * sdma_v2_4_ring_emit_fence - emit a fence on the DMA ring
301 * @ring: amdgpu ring pointer
302 * @fence: amdgpu fence object
304 * Add a DMA fence packet to the ring to write
305 * the fence seq number and DMA trap packet to generate
306 * an interrupt if needed (VI).
308 static void sdma_v2_4_ring_emit_fence(struct amdgpu_ring *ring, u64 addr, u64 seq,
311 bool write64bit = flags & AMDGPU_FENCE_FLAG_64BIT;
312 /* write the fence */
313 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_FENCE));
314 amdgpu_ring_write(ring, lower_32_bits(addr));
315 amdgpu_ring_write(ring, upper_32_bits(addr));
316 amdgpu_ring_write(ring, lower_32_bits(seq));
318 /* optionally write high bits as well */
321 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_FENCE));
322 amdgpu_ring_write(ring, lower_32_bits(addr));
323 amdgpu_ring_write(ring, upper_32_bits(addr));
324 amdgpu_ring_write(ring, upper_32_bits(seq));
327 /* generate an interrupt */
328 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_TRAP));
329 amdgpu_ring_write(ring, SDMA_PKT_TRAP_INT_CONTEXT_INT_CONTEXT(0));
333 * sdma_v2_4_gfx_stop - stop the gfx async dma engines
335 * @adev: amdgpu_device pointer
337 * Stop the gfx async dma ring buffers (VI).
339 static void sdma_v2_4_gfx_stop(struct amdgpu_device *adev)
341 struct amdgpu_ring *sdma0 = &adev->sdma.instance[0].ring;
342 struct amdgpu_ring *sdma1 = &adev->sdma.instance[1].ring;
343 u32 rb_cntl, ib_cntl;
346 if ((adev->mman.buffer_funcs_ring == sdma0) ||
347 (adev->mman.buffer_funcs_ring == sdma1))
348 amdgpu_ttm_set_buffer_funcs_status(adev, false);
350 for (i = 0; i < adev->sdma.num_instances; i++) {
351 rb_cntl = RREG32(mmSDMA0_GFX_RB_CNTL + sdma_offsets[i]);
352 rb_cntl = REG_SET_FIELD(rb_cntl, SDMA0_GFX_RB_CNTL, RB_ENABLE, 0);
353 WREG32(mmSDMA0_GFX_RB_CNTL + sdma_offsets[i], rb_cntl);
354 ib_cntl = RREG32(mmSDMA0_GFX_IB_CNTL + sdma_offsets[i]);
355 ib_cntl = REG_SET_FIELD(ib_cntl, SDMA0_GFX_IB_CNTL, IB_ENABLE, 0);
356 WREG32(mmSDMA0_GFX_IB_CNTL + sdma_offsets[i], ib_cntl);
361 * sdma_v2_4_rlc_stop - stop the compute async dma engines
363 * @adev: amdgpu_device pointer
365 * Stop the compute async dma queues (VI).
367 static void sdma_v2_4_rlc_stop(struct amdgpu_device *adev)
373 * sdma_v2_4_enable - stop the async dma engines
375 * @adev: amdgpu_device pointer
376 * @enable: enable/disable the DMA MEs.
378 * Halt or unhalt the async dma engines (VI).
380 static void sdma_v2_4_enable(struct amdgpu_device *adev, bool enable)
386 sdma_v2_4_gfx_stop(adev);
387 sdma_v2_4_rlc_stop(adev);
390 for (i = 0; i < adev->sdma.num_instances; i++) {
391 f32_cntl = RREG32(mmSDMA0_F32_CNTL + sdma_offsets[i]);
393 f32_cntl = REG_SET_FIELD(f32_cntl, SDMA0_F32_CNTL, HALT, 0);
395 f32_cntl = REG_SET_FIELD(f32_cntl, SDMA0_F32_CNTL, HALT, 1);
396 WREG32(mmSDMA0_F32_CNTL + sdma_offsets[i], f32_cntl);
401 * sdma_v2_4_gfx_resume - setup and start the async dma engines
403 * @adev: amdgpu_device pointer
405 * Set up the gfx DMA ring buffers and enable them (VI).
406 * Returns 0 for success, error for failure.
408 static int sdma_v2_4_gfx_resume(struct amdgpu_device *adev)
410 struct amdgpu_ring *ring;
411 u32 rb_cntl, ib_cntl;
416 for (i = 0; i < adev->sdma.num_instances; i++) {
417 ring = &adev->sdma.instance[i].ring;
418 wb_offset = (ring->rptr_offs * 4);
420 mutex_lock(&adev->srbm_mutex);
421 for (j = 0; j < 16; j++) {
422 vi_srbm_select(adev, 0, 0, 0, j);
424 WREG32(mmSDMA0_GFX_VIRTUAL_ADDR + sdma_offsets[i], 0);
425 WREG32(mmSDMA0_GFX_APE1_CNTL + sdma_offsets[i], 0);
427 vi_srbm_select(adev, 0, 0, 0, 0);
428 mutex_unlock(&adev->srbm_mutex);
430 WREG32(mmSDMA0_TILING_CONFIG + sdma_offsets[i],
431 adev->gfx.config.gb_addr_config & 0x70);
433 WREG32(mmSDMA0_SEM_WAIT_FAIL_TIMER_CNTL + sdma_offsets[i], 0);
435 /* Set ring buffer size in dwords */
436 rb_bufsz = order_base_2(ring->ring_size / 4);
437 rb_cntl = RREG32(mmSDMA0_GFX_RB_CNTL + sdma_offsets[i]);
438 rb_cntl = REG_SET_FIELD(rb_cntl, SDMA0_GFX_RB_CNTL, RB_SIZE, rb_bufsz);
440 rb_cntl = REG_SET_FIELD(rb_cntl, SDMA0_GFX_RB_CNTL, RB_SWAP_ENABLE, 1);
441 rb_cntl = REG_SET_FIELD(rb_cntl, SDMA0_GFX_RB_CNTL,
442 RPTR_WRITEBACK_SWAP_ENABLE, 1);
444 WREG32(mmSDMA0_GFX_RB_CNTL + sdma_offsets[i], rb_cntl);
446 /* Initialize the ring buffer's read and write pointers */
447 WREG32(mmSDMA0_GFX_RB_RPTR + sdma_offsets[i], 0);
448 WREG32(mmSDMA0_GFX_RB_WPTR + sdma_offsets[i], 0);
449 WREG32(mmSDMA0_GFX_IB_RPTR + sdma_offsets[i], 0);
450 WREG32(mmSDMA0_GFX_IB_OFFSET + sdma_offsets[i], 0);
452 /* set the wb address whether it's enabled or not */
453 WREG32(mmSDMA0_GFX_RB_RPTR_ADDR_HI + sdma_offsets[i],
454 upper_32_bits(adev->wb.gpu_addr + wb_offset) & 0xFFFFFFFF);
455 WREG32(mmSDMA0_GFX_RB_RPTR_ADDR_LO + sdma_offsets[i],
456 lower_32_bits(adev->wb.gpu_addr + wb_offset) & 0xFFFFFFFC);
458 rb_cntl = REG_SET_FIELD(rb_cntl, SDMA0_GFX_RB_CNTL, RPTR_WRITEBACK_ENABLE, 1);
460 WREG32(mmSDMA0_GFX_RB_BASE + sdma_offsets[i], ring->gpu_addr >> 8);
461 WREG32(mmSDMA0_GFX_RB_BASE_HI + sdma_offsets[i], ring->gpu_addr >> 40);
464 WREG32(mmSDMA0_GFX_RB_WPTR + sdma_offsets[i], lower_32_bits(ring->wptr) << 2);
467 rb_cntl = REG_SET_FIELD(rb_cntl, SDMA0_GFX_RB_CNTL, RB_ENABLE, 1);
468 WREG32(mmSDMA0_GFX_RB_CNTL + sdma_offsets[i], rb_cntl);
470 ib_cntl = RREG32(mmSDMA0_GFX_IB_CNTL + sdma_offsets[i]);
471 ib_cntl = REG_SET_FIELD(ib_cntl, SDMA0_GFX_IB_CNTL, IB_ENABLE, 1);
473 ib_cntl = REG_SET_FIELD(ib_cntl, SDMA0_GFX_IB_CNTL, IB_SWAP_ENABLE, 1);
476 WREG32(mmSDMA0_GFX_IB_CNTL + sdma_offsets[i], ib_cntl);
478 ring->sched.ready = true;
481 sdma_v2_4_enable(adev, true);
482 for (i = 0; i < adev->sdma.num_instances; i++) {
483 ring = &adev->sdma.instance[i].ring;
484 r = amdgpu_ring_test_helper(ring);
488 if (adev->mman.buffer_funcs_ring == ring)
489 amdgpu_ttm_set_buffer_funcs_status(adev, true);
496 * sdma_v2_4_rlc_resume - setup and start the async dma engines
498 * @adev: amdgpu_device pointer
500 * Set up the compute DMA queues and enable them (VI).
501 * Returns 0 for success, error for failure.
503 static int sdma_v2_4_rlc_resume(struct amdgpu_device *adev)
511 * sdma_v2_4_start - setup and start the async dma engines
513 * @adev: amdgpu_device pointer
515 * Set up the DMA engines and enable them (VI).
516 * Returns 0 for success, error for failure.
518 static int sdma_v2_4_start(struct amdgpu_device *adev)
522 /* halt the engine before programing */
523 sdma_v2_4_enable(adev, false);
525 /* start the gfx rings and rlc compute queues */
526 r = sdma_v2_4_gfx_resume(adev);
529 r = sdma_v2_4_rlc_resume(adev);
537 * sdma_v2_4_ring_test_ring - simple async dma engine test
539 * @ring: amdgpu_ring structure holding ring information
541 * Test the DMA engine by writing using it to write an
542 * value to memory. (VI).
543 * Returns 0 for success, error for failure.
545 static int sdma_v2_4_ring_test_ring(struct amdgpu_ring *ring)
547 struct amdgpu_device *adev = ring->adev;
554 r = amdgpu_device_wb_get(adev, &index);
558 gpu_addr = adev->wb.gpu_addr + (index * 4);
560 adev->wb.wb[index] = cpu_to_le32(tmp);
562 r = amdgpu_ring_alloc(ring, 5);
566 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_WRITE) |
567 SDMA_PKT_HEADER_SUB_OP(SDMA_SUBOP_WRITE_LINEAR));
568 amdgpu_ring_write(ring, lower_32_bits(gpu_addr));
569 amdgpu_ring_write(ring, upper_32_bits(gpu_addr));
570 amdgpu_ring_write(ring, SDMA_PKT_WRITE_UNTILED_DW_3_COUNT(1));
571 amdgpu_ring_write(ring, 0xDEADBEEF);
572 amdgpu_ring_commit(ring);
574 for (i = 0; i < adev->usec_timeout; i++) {
575 tmp = le32_to_cpu(adev->wb.wb[index]);
576 if (tmp == 0xDEADBEEF)
581 if (i >= adev->usec_timeout)
585 amdgpu_device_wb_free(adev, index);
590 * sdma_v2_4_ring_test_ib - test an IB on the DMA engine
592 * @ring: amdgpu_ring structure holding ring information
594 * Test a simple IB in the DMA ring (VI).
595 * Returns 0 on success, error on failure.
597 static int sdma_v2_4_ring_test_ib(struct amdgpu_ring *ring, long timeout)
599 struct amdgpu_device *adev = ring->adev;
601 struct dma_fence *f = NULL;
607 r = amdgpu_device_wb_get(adev, &index);
611 gpu_addr = adev->wb.gpu_addr + (index * 4);
613 adev->wb.wb[index] = cpu_to_le32(tmp);
614 memset(&ib, 0, sizeof(ib));
615 r = amdgpu_ib_get(adev, NULL, 256,
616 AMDGPU_IB_POOL_DIRECT, &ib);
620 ib.ptr[0] = SDMA_PKT_HEADER_OP(SDMA_OP_WRITE) |
621 SDMA_PKT_HEADER_SUB_OP(SDMA_SUBOP_WRITE_LINEAR);
622 ib.ptr[1] = lower_32_bits(gpu_addr);
623 ib.ptr[2] = upper_32_bits(gpu_addr);
624 ib.ptr[3] = SDMA_PKT_WRITE_UNTILED_DW_3_COUNT(1);
625 ib.ptr[4] = 0xDEADBEEF;
626 ib.ptr[5] = SDMA_PKT_HEADER_OP(SDMA_OP_NOP);
627 ib.ptr[6] = SDMA_PKT_HEADER_OP(SDMA_OP_NOP);
628 ib.ptr[7] = SDMA_PKT_HEADER_OP(SDMA_OP_NOP);
631 r = amdgpu_ib_schedule(ring, 1, &ib, NULL, &f);
635 r = dma_fence_wait_timeout(f, false, timeout);
642 tmp = le32_to_cpu(adev->wb.wb[index]);
643 if (tmp == 0xDEADBEEF)
649 amdgpu_ib_free(adev, &ib, NULL);
652 amdgpu_device_wb_free(adev, index);
657 * sdma_v2_4_vm_copy_pte - update PTEs by copying them from the GART
659 * @ib: indirect buffer to fill with commands
660 * @pe: addr of the page entry
661 * @src: src addr to copy from
662 * @count: number of page entries to update
664 * Update PTEs by copying them from the GART using sDMA (CIK).
666 static void sdma_v2_4_vm_copy_pte(struct amdgpu_ib *ib,
667 uint64_t pe, uint64_t src,
670 unsigned bytes = count * 8;
672 ib->ptr[ib->length_dw++] = SDMA_PKT_HEADER_OP(SDMA_OP_COPY) |
673 SDMA_PKT_HEADER_SUB_OP(SDMA_SUBOP_COPY_LINEAR);
674 ib->ptr[ib->length_dw++] = bytes;
675 ib->ptr[ib->length_dw++] = 0; /* src/dst endian swap */
676 ib->ptr[ib->length_dw++] = lower_32_bits(src);
677 ib->ptr[ib->length_dw++] = upper_32_bits(src);
678 ib->ptr[ib->length_dw++] = lower_32_bits(pe);
679 ib->ptr[ib->length_dw++] = upper_32_bits(pe);
683 * sdma_v2_4_vm_write_pte - update PTEs by writing them manually
685 * @ib: indirect buffer to fill with commands
686 * @pe: addr of the page entry
687 * @value: dst addr to write into pe
688 * @count: number of page entries to update
689 * @incr: increase next addr by incr bytes
691 * Update PTEs by writing them manually using sDMA (CIK).
693 static void sdma_v2_4_vm_write_pte(struct amdgpu_ib *ib, uint64_t pe,
694 uint64_t value, unsigned count,
697 unsigned ndw = count * 2;
699 ib->ptr[ib->length_dw++] = SDMA_PKT_HEADER_OP(SDMA_OP_WRITE) |
700 SDMA_PKT_HEADER_SUB_OP(SDMA_SUBOP_WRITE_LINEAR);
701 ib->ptr[ib->length_dw++] = pe;
702 ib->ptr[ib->length_dw++] = upper_32_bits(pe);
703 ib->ptr[ib->length_dw++] = ndw;
704 for (; ndw > 0; ndw -= 2) {
705 ib->ptr[ib->length_dw++] = lower_32_bits(value);
706 ib->ptr[ib->length_dw++] = upper_32_bits(value);
712 * sdma_v2_4_vm_set_pte_pde - update the page tables using sDMA
714 * @ib: indirect buffer to fill with commands
715 * @pe: addr of the page entry
716 * @addr: dst addr to write into pe
717 * @count: number of page entries to update
718 * @incr: increase next addr by incr bytes
719 * @flags: access flags
721 * Update the page tables using sDMA (CIK).
723 static void sdma_v2_4_vm_set_pte_pde(struct amdgpu_ib *ib, uint64_t pe,
724 uint64_t addr, unsigned count,
725 uint32_t incr, uint64_t flags)
727 /* for physically contiguous pages (vram) */
728 ib->ptr[ib->length_dw++] = SDMA_PKT_HEADER_OP(SDMA_OP_GEN_PTEPDE);
729 ib->ptr[ib->length_dw++] = lower_32_bits(pe); /* dst addr */
730 ib->ptr[ib->length_dw++] = upper_32_bits(pe);
731 ib->ptr[ib->length_dw++] = lower_32_bits(flags); /* mask */
732 ib->ptr[ib->length_dw++] = upper_32_bits(flags);
733 ib->ptr[ib->length_dw++] = lower_32_bits(addr); /* value */
734 ib->ptr[ib->length_dw++] = upper_32_bits(addr);
735 ib->ptr[ib->length_dw++] = incr; /* increment size */
736 ib->ptr[ib->length_dw++] = 0;
737 ib->ptr[ib->length_dw++] = count; /* number of entries */
741 * sdma_v2_4_ring_pad_ib - pad the IB to the required number of dw
743 * @ib: indirect buffer to fill with padding
746 static void sdma_v2_4_ring_pad_ib(struct amdgpu_ring *ring, struct amdgpu_ib *ib)
748 struct amdgpu_sdma_instance *sdma = amdgpu_sdma_get_instance_from_ring(ring);
752 pad_count = (-ib->length_dw) & 7;
753 for (i = 0; i < pad_count; i++)
754 if (sdma && sdma->burst_nop && (i == 0))
755 ib->ptr[ib->length_dw++] =
756 SDMA_PKT_HEADER_OP(SDMA_OP_NOP) |
757 SDMA_PKT_NOP_HEADER_COUNT(pad_count - 1);
759 ib->ptr[ib->length_dw++] =
760 SDMA_PKT_HEADER_OP(SDMA_OP_NOP);
764 * sdma_v2_4_ring_emit_pipeline_sync - sync the pipeline
766 * @ring: amdgpu_ring pointer
768 * Make sure all previous operations are completed (CIK).
770 static void sdma_v2_4_ring_emit_pipeline_sync(struct amdgpu_ring *ring)
772 uint32_t seq = ring->fence_drv.sync_seq;
773 uint64_t addr = ring->fence_drv.gpu_addr;
776 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_POLL_REGMEM) |
777 SDMA_PKT_POLL_REGMEM_HEADER_HDP_FLUSH(0) |
778 SDMA_PKT_POLL_REGMEM_HEADER_FUNC(3) | /* equal */
779 SDMA_PKT_POLL_REGMEM_HEADER_MEM_POLL(1));
780 amdgpu_ring_write(ring, addr & 0xfffffffc);
781 amdgpu_ring_write(ring, upper_32_bits(addr) & 0xffffffff);
782 amdgpu_ring_write(ring, seq); /* reference */
783 amdgpu_ring_write(ring, 0xffffffff); /* mask */
784 amdgpu_ring_write(ring, SDMA_PKT_POLL_REGMEM_DW5_RETRY_COUNT(0xfff) |
785 SDMA_PKT_POLL_REGMEM_DW5_INTERVAL(4)); /* retry count, poll interval */
789 * sdma_v2_4_ring_emit_vm_flush - cik vm flush using sDMA
791 * @ring: amdgpu_ring pointer
792 * @vm: amdgpu_vm pointer
794 * Update the page table base and flush the VM TLB
797 static void sdma_v2_4_ring_emit_vm_flush(struct amdgpu_ring *ring,
798 unsigned vmid, uint64_t pd_addr)
800 amdgpu_gmc_emit_flush_gpu_tlb(ring, vmid, pd_addr);
803 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_POLL_REGMEM) |
804 SDMA_PKT_POLL_REGMEM_HEADER_HDP_FLUSH(0) |
805 SDMA_PKT_POLL_REGMEM_HEADER_FUNC(0)); /* always */
806 amdgpu_ring_write(ring, mmVM_INVALIDATE_REQUEST << 2);
807 amdgpu_ring_write(ring, 0);
808 amdgpu_ring_write(ring, 0); /* reference */
809 amdgpu_ring_write(ring, 0); /* mask */
810 amdgpu_ring_write(ring, SDMA_PKT_POLL_REGMEM_DW5_RETRY_COUNT(0xfff) |
811 SDMA_PKT_POLL_REGMEM_DW5_INTERVAL(10)); /* retry count, poll interval */
814 static void sdma_v2_4_ring_emit_wreg(struct amdgpu_ring *ring,
815 uint32_t reg, uint32_t val)
817 amdgpu_ring_write(ring, SDMA_PKT_HEADER_OP(SDMA_OP_SRBM_WRITE) |
818 SDMA_PKT_SRBM_WRITE_HEADER_BYTE_EN(0xf));
819 amdgpu_ring_write(ring, reg);
820 amdgpu_ring_write(ring, val);
823 static int sdma_v2_4_early_init(void *handle)
825 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
827 adev->sdma.num_instances = SDMA_MAX_INSTANCE;
829 sdma_v2_4_set_ring_funcs(adev);
830 sdma_v2_4_set_buffer_funcs(adev);
831 sdma_v2_4_set_vm_pte_funcs(adev);
832 sdma_v2_4_set_irq_funcs(adev);
837 static int sdma_v2_4_sw_init(void *handle)
839 struct amdgpu_ring *ring;
841 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
843 /* SDMA trap event */
844 r = amdgpu_irq_add_id(adev, AMDGPU_IRQ_CLIENTID_LEGACY, VISLANDS30_IV_SRCID_SDMA_TRAP,
845 &adev->sdma.trap_irq);
849 /* SDMA Privileged inst */
850 r = amdgpu_irq_add_id(adev, AMDGPU_IRQ_CLIENTID_LEGACY, 241,
851 &adev->sdma.illegal_inst_irq);
855 /* SDMA Privileged inst */
856 r = amdgpu_irq_add_id(adev, AMDGPU_IRQ_CLIENTID_LEGACY, VISLANDS30_IV_SRCID_SDMA_SRBM_WRITE,
857 &adev->sdma.illegal_inst_irq);
861 r = sdma_v2_4_init_microcode(adev);
863 DRM_ERROR("Failed to load sdma firmware!\n");
867 for (i = 0; i < adev->sdma.num_instances; i++) {
868 ring = &adev->sdma.instance[i].ring;
869 ring->ring_obj = NULL;
870 ring->use_doorbell = false;
871 sprintf(ring->name, "sdma%d", i);
872 r = amdgpu_ring_init(adev, ring, 1024,
873 &adev->sdma.trap_irq,
875 AMDGPU_SDMA_IRQ_INSTANCE0 :
876 AMDGPU_SDMA_IRQ_INSTANCE1,
877 AMDGPU_RING_PRIO_DEFAULT);
885 static int sdma_v2_4_sw_fini(void *handle)
887 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
890 for (i = 0; i < adev->sdma.num_instances; i++)
891 amdgpu_ring_fini(&adev->sdma.instance[i].ring);
893 sdma_v2_4_free_microcode(adev);
897 static int sdma_v2_4_hw_init(void *handle)
900 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
902 sdma_v2_4_init_golden_registers(adev);
904 r = sdma_v2_4_start(adev);
911 static int sdma_v2_4_hw_fini(void *handle)
913 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
915 sdma_v2_4_enable(adev, false);
920 static int sdma_v2_4_suspend(void *handle)
922 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
924 return sdma_v2_4_hw_fini(adev);
927 static int sdma_v2_4_resume(void *handle)
929 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
931 return sdma_v2_4_hw_init(adev);
934 static bool sdma_v2_4_is_idle(void *handle)
936 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
937 u32 tmp = RREG32(mmSRBM_STATUS2);
939 if (tmp & (SRBM_STATUS2__SDMA_BUSY_MASK |
940 SRBM_STATUS2__SDMA1_BUSY_MASK))
946 static int sdma_v2_4_wait_for_idle(void *handle)
950 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
952 for (i = 0; i < adev->usec_timeout; i++) {
953 tmp = RREG32(mmSRBM_STATUS2) & (SRBM_STATUS2__SDMA_BUSY_MASK |
954 SRBM_STATUS2__SDMA1_BUSY_MASK);
963 static int sdma_v2_4_soft_reset(void *handle)
965 u32 srbm_soft_reset = 0;
966 struct amdgpu_device *adev = (struct amdgpu_device *)handle;
967 u32 tmp = RREG32(mmSRBM_STATUS2);
969 if (tmp & SRBM_STATUS2__SDMA_BUSY_MASK) {
971 tmp = RREG32(mmSDMA0_F32_CNTL + SDMA0_REGISTER_OFFSET);
972 tmp = REG_SET_FIELD(tmp, SDMA0_F32_CNTL, HALT, 0);
973 WREG32(mmSDMA0_F32_CNTL + SDMA0_REGISTER_OFFSET, tmp);
974 srbm_soft_reset |= SRBM_SOFT_RESET__SOFT_RESET_SDMA_MASK;
976 if (tmp & SRBM_STATUS2__SDMA1_BUSY_MASK) {
978 tmp = RREG32(mmSDMA0_F32_CNTL + SDMA1_REGISTER_OFFSET);
979 tmp = REG_SET_FIELD(tmp, SDMA0_F32_CNTL, HALT, 0);
980 WREG32(mmSDMA0_F32_CNTL + SDMA1_REGISTER_OFFSET, tmp);
981 srbm_soft_reset |= SRBM_SOFT_RESET__SOFT_RESET_SDMA1_MASK;
984 if (srbm_soft_reset) {
985 tmp = RREG32(mmSRBM_SOFT_RESET);
986 tmp |= srbm_soft_reset;
987 dev_info(adev->dev, "SRBM_SOFT_RESET=0x%08X\n", tmp);
988 WREG32(mmSRBM_SOFT_RESET, tmp);
989 tmp = RREG32(mmSRBM_SOFT_RESET);
993 tmp &= ~srbm_soft_reset;
994 WREG32(mmSRBM_SOFT_RESET, tmp);
995 tmp = RREG32(mmSRBM_SOFT_RESET);
997 /* Wait a little for things to settle down */
1004 static int sdma_v2_4_set_trap_irq_state(struct amdgpu_device *adev,
1005 struct amdgpu_irq_src *src,
1007 enum amdgpu_interrupt_state state)
1012 case AMDGPU_SDMA_IRQ_INSTANCE0:
1014 case AMDGPU_IRQ_STATE_DISABLE:
1015 sdma_cntl = RREG32(mmSDMA0_CNTL + SDMA0_REGISTER_OFFSET);
1016 sdma_cntl = REG_SET_FIELD(sdma_cntl, SDMA0_CNTL, TRAP_ENABLE, 0);
1017 WREG32(mmSDMA0_CNTL + SDMA0_REGISTER_OFFSET, sdma_cntl);
1019 case AMDGPU_IRQ_STATE_ENABLE:
1020 sdma_cntl = RREG32(mmSDMA0_CNTL + SDMA0_REGISTER_OFFSET);
1021 sdma_cntl = REG_SET_FIELD(sdma_cntl, SDMA0_CNTL, TRAP_ENABLE, 1);
1022 WREG32(mmSDMA0_CNTL + SDMA0_REGISTER_OFFSET, sdma_cntl);
1028 case AMDGPU_SDMA_IRQ_INSTANCE1:
1030 case AMDGPU_IRQ_STATE_DISABLE:
1031 sdma_cntl = RREG32(mmSDMA0_CNTL + SDMA1_REGISTER_OFFSET);
1032 sdma_cntl = REG_SET_FIELD(sdma_cntl, SDMA0_CNTL, TRAP_ENABLE, 0);
1033 WREG32(mmSDMA0_CNTL + SDMA1_REGISTER_OFFSET, sdma_cntl);
1035 case AMDGPU_IRQ_STATE_ENABLE:
1036 sdma_cntl = RREG32(mmSDMA0_CNTL + SDMA1_REGISTER_OFFSET);
1037 sdma_cntl = REG_SET_FIELD(sdma_cntl, SDMA0_CNTL, TRAP_ENABLE, 1);
1038 WREG32(mmSDMA0_CNTL + SDMA1_REGISTER_OFFSET, sdma_cntl);
1050 static int sdma_v2_4_process_trap_irq(struct amdgpu_device *adev,
1051 struct amdgpu_irq_src *source,
1052 struct amdgpu_iv_entry *entry)
1054 u8 instance_id, queue_id;
1056 instance_id = (entry->ring_id & 0x3) >> 0;
1057 queue_id = (entry->ring_id & 0xc) >> 2;
1058 DRM_DEBUG("IH: SDMA trap\n");
1059 switch (instance_id) {
1063 amdgpu_fence_process(&adev->sdma.instance[0].ring);
1076 amdgpu_fence_process(&adev->sdma.instance[1].ring);
1090 static int sdma_v2_4_process_illegal_inst_irq(struct amdgpu_device *adev,
1091 struct amdgpu_irq_src *source,
1092 struct amdgpu_iv_entry *entry)
1094 u8 instance_id, queue_id;
1096 DRM_ERROR("Illegal instruction in SDMA command stream\n");
1097 instance_id = (entry->ring_id & 0x3) >> 0;
1098 queue_id = (entry->ring_id & 0xc) >> 2;
1100 if (instance_id <= 1 && queue_id == 0)
1101 drm_sched_fault(&adev->sdma.instance[instance_id].ring.sched);
1105 static int sdma_v2_4_set_clockgating_state(void *handle,
1106 enum amd_clockgating_state state)
1108 /* XXX handled via the smc on VI */
1112 static int sdma_v2_4_set_powergating_state(void *handle,
1113 enum amd_powergating_state state)
1118 static const struct amd_ip_funcs sdma_v2_4_ip_funcs = {
1119 .name = "sdma_v2_4",
1120 .early_init = sdma_v2_4_early_init,
1122 .sw_init = sdma_v2_4_sw_init,
1123 .sw_fini = sdma_v2_4_sw_fini,
1124 .hw_init = sdma_v2_4_hw_init,
1125 .hw_fini = sdma_v2_4_hw_fini,
1126 .suspend = sdma_v2_4_suspend,
1127 .resume = sdma_v2_4_resume,
1128 .is_idle = sdma_v2_4_is_idle,
1129 .wait_for_idle = sdma_v2_4_wait_for_idle,
1130 .soft_reset = sdma_v2_4_soft_reset,
1131 .set_clockgating_state = sdma_v2_4_set_clockgating_state,
1132 .set_powergating_state = sdma_v2_4_set_powergating_state,
1135 static const struct amdgpu_ring_funcs sdma_v2_4_ring_funcs = {
1136 .type = AMDGPU_RING_TYPE_SDMA,
1138 .nop = SDMA_PKT_NOP_HEADER_OP(SDMA_OP_NOP),
1139 .support_64bit_ptrs = false,
1140 .get_rptr = sdma_v2_4_ring_get_rptr,
1141 .get_wptr = sdma_v2_4_ring_get_wptr,
1142 .set_wptr = sdma_v2_4_ring_set_wptr,
1144 6 + /* sdma_v2_4_ring_emit_hdp_flush */
1145 3 + /* hdp invalidate */
1146 6 + /* sdma_v2_4_ring_emit_pipeline_sync */
1147 VI_FLUSH_GPU_TLB_NUM_WREG * 3 + 6 + /* sdma_v2_4_ring_emit_vm_flush */
1148 10 + 10 + 10, /* sdma_v2_4_ring_emit_fence x3 for user fence, vm fence */
1149 .emit_ib_size = 7 + 6, /* sdma_v2_4_ring_emit_ib */
1150 .emit_ib = sdma_v2_4_ring_emit_ib,
1151 .emit_fence = sdma_v2_4_ring_emit_fence,
1152 .emit_pipeline_sync = sdma_v2_4_ring_emit_pipeline_sync,
1153 .emit_vm_flush = sdma_v2_4_ring_emit_vm_flush,
1154 .emit_hdp_flush = sdma_v2_4_ring_emit_hdp_flush,
1155 .test_ring = sdma_v2_4_ring_test_ring,
1156 .test_ib = sdma_v2_4_ring_test_ib,
1157 .insert_nop = sdma_v2_4_ring_insert_nop,
1158 .pad_ib = sdma_v2_4_ring_pad_ib,
1159 .emit_wreg = sdma_v2_4_ring_emit_wreg,
1162 static void sdma_v2_4_set_ring_funcs(struct amdgpu_device *adev)
1166 for (i = 0; i < adev->sdma.num_instances; i++) {
1167 adev->sdma.instance[i].ring.funcs = &sdma_v2_4_ring_funcs;
1168 adev->sdma.instance[i].ring.me = i;
1172 static const struct amdgpu_irq_src_funcs sdma_v2_4_trap_irq_funcs = {
1173 .set = sdma_v2_4_set_trap_irq_state,
1174 .process = sdma_v2_4_process_trap_irq,
1177 static const struct amdgpu_irq_src_funcs sdma_v2_4_illegal_inst_irq_funcs = {
1178 .process = sdma_v2_4_process_illegal_inst_irq,
1181 static void sdma_v2_4_set_irq_funcs(struct amdgpu_device *adev)
1183 adev->sdma.trap_irq.num_types = AMDGPU_SDMA_IRQ_LAST;
1184 adev->sdma.trap_irq.funcs = &sdma_v2_4_trap_irq_funcs;
1185 adev->sdma.illegal_inst_irq.funcs = &sdma_v2_4_illegal_inst_irq_funcs;
1189 * sdma_v2_4_emit_copy_buffer - copy buffer using the sDMA engine
1191 * @ring: amdgpu_ring structure holding ring information
1192 * @src_offset: src GPU address
1193 * @dst_offset: dst GPU address
1194 * @byte_count: number of bytes to xfer
1196 * Copy GPU buffers using the DMA engine (VI).
1197 * Used by the amdgpu ttm implementation to move pages if
1198 * registered as the asic copy callback.
1200 static void sdma_v2_4_emit_copy_buffer(struct amdgpu_ib *ib,
1201 uint64_t src_offset,
1202 uint64_t dst_offset,
1203 uint32_t byte_count,
1206 ib->ptr[ib->length_dw++] = SDMA_PKT_HEADER_OP(SDMA_OP_COPY) |
1207 SDMA_PKT_HEADER_SUB_OP(SDMA_SUBOP_COPY_LINEAR);
1208 ib->ptr[ib->length_dw++] = byte_count;
1209 ib->ptr[ib->length_dw++] = 0; /* src/dst endian swap */
1210 ib->ptr[ib->length_dw++] = lower_32_bits(src_offset);
1211 ib->ptr[ib->length_dw++] = upper_32_bits(src_offset);
1212 ib->ptr[ib->length_dw++] = lower_32_bits(dst_offset);
1213 ib->ptr[ib->length_dw++] = upper_32_bits(dst_offset);
1217 * sdma_v2_4_emit_fill_buffer - fill buffer using the sDMA engine
1219 * @ring: amdgpu_ring structure holding ring information
1220 * @src_data: value to write to buffer
1221 * @dst_offset: dst GPU address
1222 * @byte_count: number of bytes to xfer
1224 * Fill GPU buffers using the DMA engine (VI).
1226 static void sdma_v2_4_emit_fill_buffer(struct amdgpu_ib *ib,
1228 uint64_t dst_offset,
1229 uint32_t byte_count)
1231 ib->ptr[ib->length_dw++] = SDMA_PKT_HEADER_OP(SDMA_OP_CONST_FILL);
1232 ib->ptr[ib->length_dw++] = lower_32_bits(dst_offset);
1233 ib->ptr[ib->length_dw++] = upper_32_bits(dst_offset);
1234 ib->ptr[ib->length_dw++] = src_data;
1235 ib->ptr[ib->length_dw++] = byte_count;
1238 static const struct amdgpu_buffer_funcs sdma_v2_4_buffer_funcs = {
1239 .copy_max_bytes = 0x1fffff,
1241 .emit_copy_buffer = sdma_v2_4_emit_copy_buffer,
1243 .fill_max_bytes = 0x1fffff,
1245 .emit_fill_buffer = sdma_v2_4_emit_fill_buffer,
1248 static void sdma_v2_4_set_buffer_funcs(struct amdgpu_device *adev)
1250 adev->mman.buffer_funcs = &sdma_v2_4_buffer_funcs;
1251 adev->mman.buffer_funcs_ring = &adev->sdma.instance[0].ring;
1254 static const struct amdgpu_vm_pte_funcs sdma_v2_4_vm_pte_funcs = {
1255 .copy_pte_num_dw = 7,
1256 .copy_pte = sdma_v2_4_vm_copy_pte,
1258 .write_pte = sdma_v2_4_vm_write_pte,
1259 .set_pte_pde = sdma_v2_4_vm_set_pte_pde,
1262 static void sdma_v2_4_set_vm_pte_funcs(struct amdgpu_device *adev)
1266 adev->vm_manager.vm_pte_funcs = &sdma_v2_4_vm_pte_funcs;
1267 for (i = 0; i < adev->sdma.num_instances; i++) {
1268 adev->vm_manager.vm_pte_scheds[i] =
1269 &adev->sdma.instance[i].ring.sched;
1271 adev->vm_manager.vm_pte_num_scheds = adev->sdma.num_instances;
1274 const struct amdgpu_ip_block_version sdma_v2_4_ip_block =
1276 .type = AMD_IP_BLOCK_TYPE_SDMA,
1280 .funcs = &sdma_v2_4_ip_funcs,