Skip to content

Commit ac8fe1e

Browse files
authored
Update README and docs/overview.md (#33)
Applied style changes to README.md and docs/overview.md. Added a table with supported devices in docs/overview.md. Added new section Kernel module driver to docs/overview.md. Bumped the date in LICENSE.md. Added missing libudev-dev to build dependencies
1 parent 09225e2 commit ac8fe1e

File tree

3 files changed

+53
-39
lines changed

3 files changed

+53
-39
lines changed

LICENSE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (C) 2022 Intel Corporation
3+
Copyright (C) 2022-2024 Intel Corporation
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
66

README.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,11 @@ SPDX-License-Identifier: MIT
66
77
-->
88

9-
# Intel® NPU
9+
# Intel® NPU driver
1010

1111
## Introduction
1212

13-
This repository contains User Mode Driver for Intel® NPU device.
13+
This repository contains driver for Intel® NPU device.
1414

1515
Intel® NPU device is an AI inference accelerator integrated with Intel client CPUs,
1616
starting from Intel® Core™ Ultra generation of CPUs (formerly known as Meteor Lake).
@@ -22,13 +22,13 @@ To make sure that your system has an NPU available, please follow
2222
The full device name is Neural Processing Unit, but the Linux kernel driver uses
2323
the older name - Versatile Processing Unit (VPU).
2424

25-
## Driver releases
25+
## Releases
2626

2727
[The release page contains the binaries and supported component versions](https://github.com/intel/linux-npu-driver/releases).
2828

29-
## Build the driver and common issues
29+
## Build and troubleshooting
3030

31-
[The docs directory contains overiew.md that explains how to build the driver and common issues](docs/overview.md)
31+
[See docs/overview.md](docs/overview.md)
3232

3333
## License
3434

@@ -38,11 +38,8 @@ You may obtain a copy of the license at: https://opensource.org/licenses/MIT
3838

3939
## See also
4040

41-
* [OpenVINO™ documentation](https://docs.openvino.ai/2024/home.html)
42-
* [OpenVINO™ repository](https://github.com/openvinotoolkit/openvino.git)
43-
* [NPU plugin - compiler](https://github.com/openvinotoolkit/npu_plugin.git)
44-
* [Intel® OneApi Level Zero Specification API C/C++ header files](https://github.com/oneapi-src/level-zero/)
45-
* [Running NPU tasks using Intel® NPU Acceleration Library](https://intel.github.io/intel-npu-acceleration-library/)
41+
* [Intel® OneApi Level Zero](https://github.com/oneapi-src/level-zero/)
42+
* [Intel® NPU Acceleration Library](https://intel.github.io/intel-npu-acceleration-library/)
43+
* [OpenVINO™](https://github.com/openvinotoolkit/openvino.git)
4644
* [OpenVINO™ AI Plugins for GIMP](https://github.com/intel/openvino-ai-plugins-gimp)
4745
* [OpenVINO™ AI Plugins for Audacity*](https://github.com/intel/openvino-plugins-ai-audacity)
48-
* [OpenVINO™ Plugins for OBS Studio](https://github.com/intel/openvino-plugins-for-obs-studio)

docs/overview.md

Lines changed: 44 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -106,12 +106,55 @@ export ZE_INTEL_NPU_LOGMASK=$((1<<4|1<<3|1<<17))
106106

107107
</details>
108108

109+
## Supported devices
110+
111+
The Intel® NPU driver supports following Intel® processor families
112+
113+
|Platform|Kernel support|NPU driver release|
114+
|---|---|---|
115+
|[Meteor Lake](https://ark.intel.com/content/www/us/en/ark/products/codename/90353/products-formerly-meteor-lake.html)|v6.5.0-35-generic - Ubuntu22.04 Stock kernel|[v1.1.0](https://github.com/intel/linux-npu-driver/tree/v1.1.0)|
116+
|Arrow Lake|[v6.8.12](https://kernel.ubuntu.com/mainline/v6.8.12/)|[v1.5.0](https://github.com/intel/linux-npu-driver/tree/v1.5.0)|
117+
|Lunar Lake|[v6.8.12](https://kernel.ubuntu.com/mainline/v6.8.12/)|[v1.5.0](https://github.com/intel/linux-npu-driver/tree/v1.5.0)|
118+
119+
## Kernel module driver
120+
121+
The kernel module driver `intel_vpu` can be found in [drivers/accel
122+
tree](https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/tree/drivers/accel/ivpu?h=v6.8.1)
123+
in the kernel sources.
124+
125+
<details>
126+
<summary>Enable the intel_vpu module in the kernel config for compilation</summary>
127+
128+
In the Kernel Menu Configuration from `Device Driver` select `Compute Acceleration Framework`
129+
and set "modularize" for `Intel NPU (Neural Processing Unit)`.
130+
</details>
131+
<details>
132+
<summary>Finding the intel_vpu kernel module in the system</summary>
133+
134+
```
135+
# check if the intel_vpu exists is in the system
136+
modinfo intel_vpu
137+
138+
# check if the intel_vpu is loaded in the kernel
139+
lsmod | grep intel_vpu
140+
141+
# if the previous command nothing produced, load the intel_vpu
142+
sudo modprobe intel_vpu
143+
144+
# verify that the intel_vpu has been loaded successfully
145+
sudo dmesg | tail -n 20
146+
147+
# check if accel device is available
148+
ls /dev/accel/accel0
149+
```
150+
</details>
151+
109152
## Building a standalone driver
110153

111154
Install the required dependencies in Ubuntu:
112155
```
113156
sudo apt update
114-
sudo apt install -y build-essential git git-lfs cmake libudev-dev libboost-all-dev libssl-dev
157+
sudo apt install -y build-essential git git-lfs cmake libudev-dev libboost-all-dev libssl-dev libudev-dev
115158
```
116159

117160
Commands to build the driver:
@@ -228,32 +271,6 @@ cmake -B build -S . -G Ninja
228271
```
229272
</details>
230273
<details>
231-
<summary>Enable the intel_vpu module in the kernel config for compilation</summary>
232-
233-
In the Kernel Menu Configuration from `Device Driver` select `Compute Acceleration Framework`
234-
and set "modularize" for `Intel NPU (Neural Processing Unit)`.
235-
</details>
236-
<details>
237-
<summary>Finding the intel_vpu kernel module in the system</summary>
238-
239-
```
240-
# check if the intel_vpu exists is in the system
241-
modinfo intel_vpu
242-
243-
# check if the intel_vpu is loaded in the kernel
244-
lsmod | grep intel_vpu
245-
246-
# if the previous command nothing produced, load the intel_vpu
247-
sudo modprobe intel_vpu
248-
249-
# verify that the intel_vpu has been loaded successfully
250-
sudo dmesg | tail -n 20
251-
252-
# check if accel device is available
253-
ls /dev/accel/accel0
254-
```
255-
</details>
256-
<details>
257274
<summary>Enable driver log using an environment variable</summary>
258275

259276
Valid logging levels are `ERROR`, `WARNING`, `INFO` (and `VERBOSE` for driver

0 commit comments

Comments
 (0)