From 6ebe2e286d24e4e1fd68d48b03e700345e4d5056 Mon Sep 17 00:00:00 2001 From: Shital Shah Date: Mon, 8 Oct 2018 23:32:55 -0700 Subject: [PATCH] Added steering wheel doc from Technion https://github.com/Microsoft/AirSim/pull/1410 --- docs/images/steering_wheel_instructions_1.png | Bin 0 -> 33631 bytes docs/images/steering_wheel_instructions_2.png | Bin 0 -> 37412 bytes docs/steering_wheel_installation.md | 42 ++++++++++++++++++ docs/use_precompiled.md | 2 +- 4 files changed, 43 insertions(+), 1 deletion(-) create mode 100644 docs/images/steering_wheel_instructions_1.png create mode 100644 docs/images/steering_wheel_instructions_2.png create mode 100644 docs/steering_wheel_installation.md diff --git a/docs/images/steering_wheel_instructions_1.png b/docs/images/steering_wheel_instructions_1.png new file mode 100644 index 0000000000000000000000000000000000000000..8ebf560d1d526a6f2906e6a5a1eea8442d4e11e2 GIT binary patch literal 33631 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 v-y#qA>RC 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 devices and enable “Windows RawInput”. + +6. Go to Edit->Project Settings->Raw Input, and add new device configuration: + Vendor ID: 0x046d (In case of Logitech G920, otherwise you might need to check it). + Product ID: 0xc261 (In case of Logitech G920, otherwise you might need to check it). + Under “Axis Properties”, make sure that “GenericUSBController Axis 2”, “GenericUSBController Axis 4” and “GenericUSBController Axis 5” are all enabled with an offset of 1.0. + Explanation: axis 2 is responsible for steering movement, axis 4 is for brake and axis 5 is for gas. If you need to configure the clutch, it’s on axis 3. + + ![steering_wheel](images/steering_wheel_instructions_1.png) + +7. Go to Edit->Project Settings->Input, Under Bindings in “Axis Mappings”: + Remove existing mappings from the groups “MoveRight” and “MoveForward”. + Add new axis mapping to the group “MoveRight”, use GenericUSBController axis 2 with a scale of 1.0. + Add new axis mapping to the group “MoveForward”, use GenericUSBController axis 5 with a scale of 1.0. + Add a new group of axis mappings, name it “FootBrake” and add new axis mapping to this group, use GenericUSBController axis 4 with a scale of 1.0. + + ![steering_wheel](images/steering_wheel_instructions_2.png) + +8. Play and drive ! + +### Pay Attention + +Notice that in the first time we "play" after debug, we need to touch the wheel to “reset” the values. + +### Tip + +In the gaming software, you can configure buttons as keyboard shortcuts, we used it to configure a shortcut to record dataset or to play in full screen. diff --git a/docs/use_precompiled.md b/docs/use_precompiled.md index 72b17b59..d1e1cbc6 100644 --- a/docs/use_precompiled.md +++ b/docs/use_precompiled.md @@ -7,7 +7,7 @@ You can simply download precompiled binaries and run to get started immediately. **Linux**: Binaries for Ubuntu 16.04 LTS is coming soon. For now you will need to [build it on Linux](build_linux.md) yourself. ## Controlling Vehicles -Most of our users typically use [APIs](apis.md) to control the vehicles. However if you can also control vehicles manually. You can drive the car using keyboard, gamepad or steering wheel. To fly drone manually, you will need either XBox controller or a remote control (feel free to [contribute](contributing.md) keyboard support). Please see [remote control setup](remote_control.md) for more details. Alternatively you can use [APIs](apis.md) for programmatic control or use so-called [Computer Vision mode](image_apis.md) to move around in environment using the keyboard. +Most of our users typically use [APIs](apis.md) to control the vehicles. However if you can also control vehicles manually. You can drive the car using keyboard, gamepad or [steering wheel](steering_wheel_installation.md). To fly drone manually, you will need either XBox controller or a remote control (feel free to [contribute](contributing.md) keyboard support). Please see [remote control setup](remote_control.md) for more details. Alternatively you can use [APIs](apis.md) for programmatic control or use so-called [Computer Vision mode](image_apis.md) to move around in environment using the keyboard. ## Don't Have Good GPU? The AirSim binaries, like CityEnviron, requires a beefy GPU to run smoothly. You can run them in low resolution mode by editing the `run.bat` file on Windows like this: