amazon/ena/ena_com.h

1 /* SPDX-License-Identifier: GPL-2.0 OR Linux-OpenIB */
3  * Copyright 2015-2020 Amazon.com, Inc. or its affiliates. All rights reserved.
11 #include <linux/dma-mapping.h>
41 #define ADMIN_SQ_SIZE(depth)	((depth) * sizeof(struct ena_admin_aq_entry))  argument
42 #define ADMIN_CQ_SIZE(depth)	((depth) * sizeof(struct ena_admin_acq_entry))  argument
43 #define ADMIN_AENQ_SIZE(depth)	((depth) * sizeof(struct ena_admin_aenq_entry))  argument
368 /* ena_com_mmio_reg_read_request_init - Init the mmio reg read mechanism
369  * @ena_dev: ENA communication layer struct
375  * @return - 0 on success, negative value on failure.
379 /* ena_com_set_mmio_read_mode - Enable/disable the indirect mmio reg read mechanism
380  * @ena_dev: ENA communication layer struct
386 /* ena_com_mmio_reg_read_request_write_dev_addr - Write the mmio reg read return
388  * @ena_dev: ENA communication layer struct
392 /* ena_com_mmio_reg_read_request_destroy - Destroy the mmio reg read mechanism
393  * @ena_dev: ENA communication layer struct
397 /* ena_com_admin_init - Init the admin and the async queues
398  * @ena_dev: ENA communication layer struct
404  * @return - 0 on success, negative value on failure.
409 /* ena_com_admin_destroy - Destroy the admin and the async events queues.
410  * @ena_dev: ENA communication layer struct
418 /* ena_com_dev_reset - Perform device FLR to the device.
419  * @ena_dev: ENA communication layer struct
422  * @return - 0 on success, negative value on failure.
427 /* ena_com_create_io_queue - Create io queue.
428  * @ena_dev: ENA communication layer struct
429  * @ctx - create context structure
433  * @return - 0 on success, negative value on failure.
438 /* ena_com_destroy_io_queue - Destroy IO queue with the queue id - qid.
439  * @ena_dev: ENA communication layer struct
440  * @qid - the caller virtual queue id.
444 /* ena_com_get_io_handlers - Return the io queue handlers
445  * @ena_dev: ENA communication layer struct
446  * @qid - the caller virtual queue id.
447  * @io_sq - IO submission queue handler
448  * @io_cq - IO completion queue handler.
450  * @return - 0 on success, negative value on failure.
456 /* ena_com_admin_aenq_enable - ENAble asynchronous event notifications
457  * @ena_dev: ENA communication layer struct
463 /* ena_com_set_admin_running_state - Set the state of the admin queue
464  * @ena_dev: ENA communication layer struct
470 /* ena_com_get_admin_running_state - Get the admin queue state
471  * @ena_dev: ENA communication layer struct
475  * @return - current polling mode (enable/disable)
479 /* ena_com_set_admin_polling_mode - Set the admin completion queue polling mode
480  * @ena_dev: ENA communication layer struct
487 /* ena_com_set_admin_auto_polling_mode - Enable autoswitch to polling mode
488  * @ena_dev: ENA communication layer struct
498 /* ena_com_admin_q_comp_intr_handler - admin queue interrupt handler
499  * @ena_dev: ENA communication layer struct
504  * @note: Should be called after MSI-X interrupt.
508 /* ena_com_aenq_intr_handler - AENQ interrupt handler
509  * @ena_dev: ENA communication layer struct
516 /* ena_com_abort_admin_commands - Abort all the outstanding admin commands.
517  * @ena_dev: ENA communication layer struct
525 /* ena_com_wait_for_abort_completion - Wait for admin commands abort.
526  * @ena_dev: ENA communication layer struct
532 /* ena_com_validate_version - Validate the device parameters
533  * @ena_dev: ENA communication layer struct
540  * @return - 0 on success negative value otherwise.
544 /* ena_com_get_link_params - Retrieve physical link parameters.
545  * @ena_dev: ENA communication layer struct
549  * like speed, auto-negotiation and full duplex support.
551  * @return - 0 on Success negative value otherwise.
556 /* ena_com_get_dma_width - Retrieve physical dma address width the device
558  * @ena_dev: ENA communication layer struct
566 /* ena_com_set_aenq_config - Set aenq groups configurations
567  * @ena_dev: ENA communication layer struct
576 /* ena_com_get_dev_attr_feat - Get device features
577  * @ena_dev: ENA communication layer struct
585 /* ena_com_get_dev_basic_stats - Get device basic statistics
586  * @ena_dev: ENA communication layer struct
594 /* ena_com_get_eni_stats - Get extended network interface statistics
595  * @ena_dev: ENA communication layer struct
603 /* ena_com_set_dev_mtu - Configure the device mtu.
604  * @ena_dev: ENA communication layer struct
611 /* ena_com_get_offload_settings - Retrieve the device offloads capabilities
612  * @ena_dev: ENA communication layer struct
620 /* ena_com_rss_init - Init RSS
621  * @ena_dev: ENA communication layer struct
632 /* ena_com_rss_destroy - Destroy rss
633  * @ena_dev: ENA communication layer struct
639 /* ena_com_get_current_hash_function - Get RSS hash function
640  * @ena_dev: ENA communication layer struct
647 /* ena_com_fill_hash_function - Fill RSS hash function
648  * @ena_dev: ENA communication layer struct
665 /* ena_com_set_hash_function - Flush the hash function and it dependencies to
667  * @ena_dev: ENA communication layer struct
678 /* ena_com_get_hash_function - Retrieve the hash function from the device.
679  * @ena_dev: ENA communication layer struct
692 /* ena_com_get_hash_key - Retrieve the hash key
693  * @ena_dev: ENA communication layer struct
704 /* ena_com_fill_hash_ctrl - Fill RSS hash control
705  * @ena_dev: ENA communication layer struct.
720 /* ena_com_set_hash_ctrl - Flush the hash control resources to the device.
721  * @ena_dev: ENA communication layer struct
731 /* ena_com_get_hash_ctrl - Retrieve the hash control from the device.
732  * @ena_dev: ENA communication layer struct
747 /* ena_com_set_default_hash_ctrl - Set the hash control to a default
749  * @ena_dev: ENA communication layer struct
759 /* ena_com_indirect_table_fill_entry - Fill a single entry in the RSS
761  * @ena_dev: ENA communication layer struct.
762  * @entry_idx - indirection table entry.
763  * @entry_value - redirection value
774 /* ena_com_indirect_table_set - Flush the indirection table to the device.
775  * @ena_dev: ENA communication layer struct
784 /* ena_com_indirect_table_get - Retrieve the indirection table from the device.
785  * @ena_dev: ENA communication layer struct
797 /* ena_com_allocate_host_info - Allocate host info resources.
798  * @ena_dev: ENA communication layer struct
804 /* ena_com_allocate_debug_area - Allocate debug area.
805  * @ena_dev: ENA communication layer struct
806  * @debug_area_size - debug area size.
813 /* ena_com_delete_debug_area - Free the debug area resources.
814  * @ena_dev: ENA communication layer struct
820 /* ena_com_delete_host_info - Free the host info resources.
821  * @ena_dev: ENA communication layer struct
827 /* ena_com_set_host_attributes - Update the device with the host
829  * @ena_dev: ENA communication layer struct
835 /* ena_com_create_io_cq - Create io completion queue.
836  * @ena_dev: ENA communication layer struct
837  * @io_cq - io completion queue handler
841  * @return - 0 on success, negative value on failure.
846 /* ena_com_destroy_io_cq - Destroy io completion queue.
847  * @ena_dev: ENA communication layer struct
848  * @io_cq - io completion queue handler
852  * @return - 0 on success, negative value on failure.
857 /* ena_com_execute_admin_command - Execute admin command
868  * @return - 0 on success, negative value on failure.
876 /* ena_com_init_interrupt_moderation - Init interrupt moderation
877  * @ena_dev: ENA communication layer struct
879  * @return - 0 on success, negative value on failure.
883 /* ena_com_interrupt_moderation_supported - Return if interrupt moderation
886  * @return - supported or not.
890 /* ena_com_update_nonadaptive_moderation_interval_tx - Update the
891  * non-adaptive interval in Tx direction.
892  * @ena_dev: ENA communication layer struct
895  * @return - 0 on success, negative value on failure.
900 /* ena_com_update_nonadaptive_moderation_interval_rx - Update the
901  * non-adaptive interval in Rx direction.
902  * @ena_dev: ENA communication layer struct
905  * @return - 0 on success, negative value on failure.
910 /* ena_com_get_nonadaptive_moderation_interval_tx - Retrieve the
911  * non-adaptive interval in Tx direction.
912  * @ena_dev: ENA communication layer struct
914  * @return - interval in usec
918 /* ena_com_get_nonadaptive_moderation_interval_rx - Retrieve the
919  * non-adaptive interval in Rx direction.
920  * @ena_dev: ENA communication layer struct
922  * @return - interval in usec
926 /* ena_com_config_dev_mode - Configure the placement policy of the device.
927  * @ena_dev: ENA communication layer struct
936 /* ena_com_io_sq_to_ena_dev - Extract ena_com_dev using contained field io_sq.
939  * @return - ena_com_dev struct extracted from io_sq
943 	return container_of(io_sq, struct ena_com_dev, io_sq_queues[io_sq->qid]);  in ena_com_io_sq_to_ena_dev()
946 /* ena_com_io_cq_to_ena_dev - Extract ena_com_dev using contained field io_cq.
949  * @return - ena_com_dev struct extracted from io_sq
953 	return container_of(io_cq, struct ena_com_dev, io_cq_queues[io_cq->qid]);  in ena_com_io_cq_to_ena_dev()
958 	return ena_dev->adaptive_coalescing;  in ena_com_get_adaptive_moderation_enabled()
963 	ena_dev->adaptive_coalescing = true;  in ena_com_enable_adaptive_moderation()
968 	ena_dev->adaptive_coalescing = false;  in ena_com_disable_adaptive_moderation()
971 /* ena_com_get_cap - query whether device supports a capability.
972  * @ena_dev: ENA communication layer struct
975  * @return - true if capability is supported or false otherwise
980 	return !!(ena_dev->capabilities & BIT(cap_id));  in ena_com_get_cap()
983 /* ena_com_update_intr_reg - Prepare interrupt register
996 	intr_reg->intr_control = 0;  in ena_com_update_intr_reg()
997 	intr_reg->intr_control |= rx_delay_interval &  in ena_com_update_intr_reg()
1000 	intr_reg->intr_control |=  in ena_com_update_intr_reg()
1005 		intr_reg->intr_control |= ENA_ETH_IO_INTR_REG_INTR_UNMASK_MASK;  in ena_com_update_intr_reg()
1013 	size = bounce_buf_ctrl->buffer_size;  in ena_com_get_next_bounce_buffer()
1014 	buffers_num = bounce_buf_ctrl->buffers_num;  in ena_com_get_next_bounce_buffer()
1016 	buf = bounce_buf_ctrl->base_buffer +  in ena_com_get_next_bounce_buffer()
1017 		(bounce_buf_ctrl->next_to_use++ & (buffers_num - 1)) * size;  in ena_com_get_next_bounce_buffer()
1019 	prefetchw(bounce_buf_ctrl->base_buffer +  in ena_com_get_next_bounce_buffer()
1020 		(bounce_buf_ctrl->next_to_use & (buffers_num - 1)) * size);  in ena_com_get_next_bounce_buffer()