mlx5

Makefile

@@ -461,7 +461,7 @@ RUSTDOC_OUT_FILE := $(RUSTDOC_OUT)/___Theseus_Crates___/index.html
 ## The entire project is built as normal using the `cargo doc` command (`rustdoc` under the hood).
 docs: doc
 doc: check_rustc
-	@cargo doc --workspace --no-deps $(addprefix --exclude , $(APP_CRATE_NAMES))
+	@RUSTDOCFLAGS="$$RUSTDOCFLAGS -A private_intra_doc_links" cargo doc --workspace --no-deps $(addprefix --exclude , $(APP_CRATE_NAMES))
 	@rustdoc --output target/doc --crate-name "___Theseus_Crates___" $(ROOT_DIR)/kernel/_doc_root.rs
 	@rm -rf $(RUSTDOC_OUT)
 	@mkdir -p $(RUSTDOC_OUT)

book/src/running/virtual_machine/pci_passthrough.md

@@ -52,6 +52,13 @@ e.g. `echo 15b3 1019 > /sys/bus/pci/drivers/vfio-pci/new_id`
 
 Now, QEMU can be launched with direct access to the device.
 
+### Return device to the Host OS
+To reset the device, you can either reboot the system or return the device to the host OS using the following commands (replacing `$slot_info` with the value previously retrieved):  
+```sh
+echo 1 > /sys/bus/pci/devices/$slot_info/remove    
+echo 1 > /sys/bus/pci/rescan  
+```
+
 ### Note: access for unprivileged users
 To give access to an unprivileged user to this VFIO device, find the IOMMU group the device belongs to:
 ```sh

kernel/device_manager/Cargo.toml

@@ -59,6 +59,8 @@ path = "../ixgbe"
 [dependencies.io]
 path = "../io"
 
+[dependencies.mlx5]
+path = "../mlx5"
 
 [lib]
 crate-type = ["rlib"]

kernel/device_manager/src/lib.rs

@@ -20,6 +20,7 @@ extern crate fatfs;
 extern crate io;
 extern crate bare_io;
 #[macro_use] extern crate derive_more;
+extern crate mlx5;
 
 use mpmc::Queue;
 use event_types::Event;
@@ -121,6 +122,10 @@ pub fn init(key_producer: Queue<Event>, mouse_producer: Queue<Event>) -> Result<
                 ixgbe_devs.push(ixgbe_nic);
                 continue;
             }
+            if dev.vendor_id == mlx5::MLX_VEND && dev.device_id == mlx5::CONNECTX5_DEV {
+                info!("mlx5 PCI device found at: {:?}", dev.location);
+                mlx5::ConnectX5Nic::init(dev)?;
+            }
 
             // here: check for and initialize other ethernet cards
         }

kernel/mlx5/Cargo.toml

@@ -0,0 +1,34 @@
+[package]
+authors = ["Ramla Ijaz <[email protected]>"]
+name = "mlx5"
+description = "Driver for the Mellanox ConnectX-5 NIC"
+version = "0.1.0"
+build = "../../build.rs"
+
+[dependencies]
+spin = "0.9.0"
+owning_ref = { git = "https://github.com/theseus-os/owning-ref-rs" }
+
+[dependencies.log]
+version = "0.4.8"
+
+[dependencies.irq_safety]
+git = "https://github.com/theseus-os/irq_safety"
+
+[dependencies.memory]
+path = "../memory"
+
+[dependencies.pci]
+path = "../pci"
+
+[dependencies.nic_initialization]
+path = "../nic_initialization"
+
+[dependencies.mlx_ethernet]
+path = "../mlx_ethernet"
+
+[dependencies.kernel_config]
+path = "../kernel_config"
+
+[lib]
+crate-type = ["rlib"]