Skip to content

Commit e89a5d1

Browse files
Thalleymmahadevan108
authored andcommitted
doc: Update Virtualbox steps for autopts-linux
The exisitng documentation was out of date and possibly not working. Added a section on how to use NAT and port forwarding. Signed-off-by: Emil Gydesen <[email protected]>
1 parent 397b5cb commit e89a5d1

File tree

5 files changed

+35
-4
lines changed

5 files changed

+35
-4
lines changed

doc/connectivity/bluetooth/autopts/autopts-linux.rst

Lines changed: 35 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ VirtualBox. On VirtualBox could be some issues, if your host has fewer than 6 CP
5555
Create Windows virtual machine instance. Make sure it has at least 2 cores and
5656
installed guest extensions.
5757

58-
Setup tested with VirtualBox 6.1.18 and VMWare Workstation 16.1.1 Pro.
58+
Setup tested with VirtualBox 7.1.4 and VMWare Workstation 16.1.1 Pro.
5959

6060
Update Windows
6161
==============
@@ -64,9 +64,37 @@ Update Windows in:
6464

6565
Start -> Settings -> Update & Security -> Windows Update
6666

67+
Setup NAT
68+
=========
69+
70+
It is possible to use NAT and portforwarding to setup communication between a Linux host and a
71+
Windows guest. This is easiest setup for VirtualBox, and does not require any static IPs to be
72+
configured, and will not get blocked by the Windows Firewall.
73+
74+
VirtualBox
75+
----------
76+
77+
Open virtual machine network settings. On adapter 1 you will have created by default NAT.
78+
Open the Port Forwarding menu an add the ports you want.
79+
80+
81+
.. image:: virtualbox_nat_1.png
82+
:width: 500
83+
:align: center
84+
85+
For example setting up the following will allow you to use
86+
``localhost:65000`` and ``localhost:65002`` (or ``127.0.0.0:65000`` and ``127.0.0.0:65002``)
87+
to connect to an AutoPTS Server in Windows running on ports 65000 and 65002.
88+
89+
.. image:: virtualbox_nat_2.png
90+
:width: 500
91+
:align: center
92+
6793
Setup static IP
6894
===============
6995

96+
If you cannot or do not want to use NAT it is possible to configure a static IP.
97+
7098
WMWare Works
7199
------------
72100

@@ -94,22 +122,24 @@ If you type 'ifconfig' in terminal, you should be able to find your host IP:
94122
VirtualBox
95123
----------
96124

125+
VirtualBox on Linux, macOS and Solaris Oracle VM VirtualBox will only allow IP addresses in
126+
``192.168.56.0/21`` range to be assigned to host-only adapters, so if using a static address with
127+
VirtualBox this is the only address range you can use.
128+
97129
Go to:
98130

99-
File -> Host Network Manager
131+
File -> Tools -> Network Manager
100132

101133
and create network:
102134

103135
.. image:: virtualbox_static_ip_1.png
104-
:height: 400
105136
:width: 500
106137
:align: center
107138

108139
Open virtual machine network settings. On adapter 1 you will have created by default NAT.
109140
Add adapter 2:
110141

111142
.. image:: virtualbox_static_ip_2.png
112-
:height: 400
113143
:width: 500
114144
:align: center
115145

@@ -126,6 +156,7 @@ and set:
126156
:width: 400
127157
:align: center
128158

159+
129160
Install Python 3
130161
================
131162

52.5 KB
Loading
12.1 KB
Loading
-4.91 KB
Loading
731 Bytes
Loading

0 commit comments

Comments
 (0)