Skip to content

Commit

Permalink
Readme
Browse files Browse the repository at this point in the history
Signed-off-by: Vadym Hrynchyshyn <vadimgrn@gmail.com>
  • Loading branch information
vadimgrn committed May 18, 2024
1 parent e4196e3 commit 2cfdf96
Show file tree
Hide file tree
Showing 5 changed files with 9 additions and 19 deletions.
16 changes: 5 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@
- Works with Linux USB/IP server at least for kernels 4.19 - 6.5
- **Is not ready for production use**, can cause BSOD
- The driver is not signed, [Windows Test Signing Mode](https://docs.microsoft.com/en-us/windows-hardware/drivers/install/the-testsigning-boot-configuration-option) must be enabled
- **Do not set `testsigning off` while USBip is installed**, please read [this](https://github.com/vadimgrn/usbip-win2/tree/master?tab=readme-ov-file#disable-windows-test-signing-mode-without-removing-usbip)
- You can **donate to purchase an EV certificate** which is required for signing the driver, please read [this](https://github.com/vadimgrn/usbip-win2/issues/48#issuecomment-1888655412) thread
- **Do not set `testsigning off` when USBip is installed**, [see](https://github.com/vadimgrn/usbip-win2/tree/master?tab=readme-ov-file#disable-windows-test-signing-mode-without-removing-usbip)
- You can donate to purchase an EV certificate which is required for signing the driver, please [read](https://github.com/vadimgrn/usbip-win2/issues/48#issuecomment-1888655412)
- [Devices](https://github.com/vadimgrn/usbip-win2/wiki#ude-driver-list-of-devices-known-to-work) that work (list is incomplete)

## Requirements
Expand Down Expand Up @@ -58,14 +58,8 @@

## Setup USB/IP server on Ubuntu Linux
- Install required packages
- Linux
```
sudo apt install linux-tools-generic linux-cloud-tools-generic
```
- Raspberry Pi
```
sudo apt install usbip hwdata usbutils
```
- Linux `sudo apt install linux-tools-generic linux-cloud-tools-generic`
- Raspberry Pi `sudo apt install usbip hwdata usbutils`
- Load modules and run the daemon
```
sudo modprobe -a usbip-core usbip-host
Expand Down Expand Up @@ -141,7 +135,7 @@ FOR /f %P IN ('findstr /M /L %HWID% C:\WINDOWS\INF\oem*.inf') DO pnputil.exe /de
rd /S /Q "%APPDIR%"
```
### Disable Windows Test Signing Mode without removing USB/IP
- Can be useful if you want to temporary disable test signing without removing USBip
- Can be useful if you want to temporary disable test signing
- After that, USBip will not work until the test signing will be reenabled
- **usbip2_filter driver must be disabled, otherwise all USB controllers/devices will not work**
```
Expand Down
6 changes: 1 addition & 5 deletions drivers/ude/wsk_receive.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -626,11 +626,7 @@ PAGED void recv_loop(_Inout_ device_ctx &dev, _Inout_ wsk_context &ctx)
{
PAGED_CODE();

for (NTSTATUS status{}; !(status || dev.unplugged); ) {

if (auto err = recv_usbip_header(ctx)) {
break;
}
for (NTSTATUS status{}; !(status || dev.unplugged || recv_usbip_header(ctx)); ) {

NT_ASSERT(!ctx.request); // must be completed and zeroed on every loop
ctx.request = ret_command(ctx);
Expand Down
2 changes: 1 addition & 1 deletion userspace/wusbip/frame.cpp
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
///////////////////////////////////////////////////////////////////////////
// C++ code generated with wxFormBuilder (version 4.1.0-0f01c2ed)
// C++ code generated with wxFormBuilder (version 4.1.0-95312493)
// http://www.wxformbuilder.org/
//
// PLEASE DO *NOT* EDIT THIS FILE!
Expand Down
2 changes: 1 addition & 1 deletion userspace/wusbip/frame.h
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
///////////////////////////////////////////////////////////////////////////
// C++ code generated with wxFormBuilder (version 4.1.0-0f01c2ed)
// C++ code generated with wxFormBuilder (version 4.1.0-95312493)
// http://www.wxformbuilder.org/
//
// PLEASE DO *NOT* EDIT THIS FILE!
Expand Down
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
wusbip.fbp is a project file for wxFormBuilder that is used to create the GUI.
See: https://github.com/wxFormBuilder/wxFormBuilder
See: https://github.com/wxFormBuilder/wxFormBuilder

0 comments on commit 2cfdf96

Please # to comment.