11---
2- title : Clearpath Computer Setup
2+ title : Robot Network Configuration
33sidebar_position : 2
44---
55import ComputerNetworkingSetupInstall from " ../../components/networking/_computer_networking_setup_install.mdx"
@@ -13,56 +13,108 @@ import StandardClearpathBridgeSetup from "../../components/networking/_standard_
1313
1414### Connecting to an Existing Wi-Fi Network
1515
16- Use the ` clearpath-computer-setup ` tool to connect your robot to your existing wireless network.
17-
18- 1 . Run ` sudo clearpath-computer-setup `
19- 1 . Navigate to ** Netplan Setup**
20- <center >
21- <figure >
22- <img
23- src = { require (" ./img/clearpath_setup-netplan.png" default }
24- width = " 888"
25- />
26- </figure >
27- </center >
28- 1 . Navigate to ** WiFi Setup**
29- <center >
30- <figure >
31- <img
32- src = { require (" ./img/clearpath_setup-wifi.png" default }
33- width = " 888"
34- />
35- </figure >
36- </center >
37- 1 . Select the wireless interface you wish to configure. Most computers will only have one wireless
38- interface, but some may have more than one.
39- <center >
40- <figure >
41- <img
42- src = { require (" ./img/clearpath_setup-interface.png" default }
43- width = " 888"
44- />
45- </figure >
46- </center >
47- 1 . Enter the SSID and password for your wireless network.
48- <center >
49- <figure >
50- <img
51- src = { require (" ./img/clearpath_setup-ssid.png" default }
52- width = " 888"
53- />
54- </figure >
55- </center >
56- 1 . Select ** Save Settings** and press ` ENTER ` .
57-
58- ### Custom Networking
59-
60- The ` clearpath-computer-setup ` tool can also be used to set up custom network interfaces.
61-
62- 1 . Navigate to the ** Netplan Setup** menu and use the bridge, Ethernet, or Wi-Fi setup menus to add configurations.
63- 2 . Once you are done configuring, return to the ** Netplan Setup** menu and select ** Write Configuration YAML** . You will be prompted for a file name. The file should be
64- placed under ` /etc/netplan/ ` to take effect, and the naming convention is a two digit number followed by a unique name.
65- For example, ` /etc/netplan/50-home-wifi.yaml ` .
16+ Use ` netplan ` to connect your robot to an existing wireless network.
17+
18+ First, determine the name of your wireless interface by running ` iwconfig ` you should see
19+ an entry similar to this:
20+
21+ ```
22+ wlp59s0 IEEE 802.11 ESSID:off/any
23+ Mode:Managed Access Point: Not-Associated Tx-Power=off
24+ Retry short limit:7 RTS thr:off Fragment thr:off
25+ Power Management:on
26+ ```
27+
28+ The interface name is in the left column, starting with ` w ` .
29+
30+ Once you have identified your interface, edit or create a file
31+ called ` /etc/netplan/60-wifi.yaml ` containing the following:
32+
33+ ``` yaml
34+ network :
35+ wifis :
36+ MY_WIFI_INTERFACE :
37+ optional : true
38+ access-points :
39+ MY_WIFI_SSID :
40+ password : MY_WIFI_PASSWORD
41+ dhcp4 : true
42+ ` ` `
43+
44+ with the following substitutions:
45+ 1. Replace ` MY_WIFI_INTERFACE` with the name of the interface you identified in the first step,
46+ e.g. `wlp59s0`
47+ 2. Replace `MY_WIFI_SSID` with the SSID of your network.
48+ 3. Replace `MY_WIFI_PASSWORD` with your network's password.
49+
50+ For example :
51+
52+ ` ` ` yaml
53+ network:
54+ wifis:
55+ wlp59s0:
56+ optional: true
57+ access-points:
58+ BabCom:
59+ password: peekaboo
60+ dhcp4: true
61+ ` ` `
62+
63+ This configuration will connect your robot via DHCP to your WPA2/3 wireless network. If you
64+ need to use a static IP address, modify the file to contain the following :
65+
66+ ` ` ` yaml
67+ network:
68+ wifis:
69+ MY_WIFI_INTERFACE:
70+ optional: true
71+ access-points:
72+ MY_WIFI_SSID:
73+ password: MY_WIFI_PASSWORD
74+ dhcp4: false
75+ dhcp4-overrides:
76+ send-hostname: true
77+ addresses:
78+ - MY_STATIC_IP/MY_SUBNET
79+ nameservers:
80+ addresses:
81+ - MY_NAMESERVER
82+ ` ` `
83+
84+ with the same substitutions noted earlier, plus
85+ 1. Replace `MY_STATIC_IP` with the desired static IP address.
86+ 2. Replace `MY_SUBNET` with the length of your network's subnet mask (typically `24` or `16`)
87+ 3. Replace `MY_NAMESERVER` with the IP address of your DNS server You may add multiple DNS servers
88+ with each one on its own line.
89+
90+ For example :
91+
92+ ` ` ` yaml
93+ network:
94+ wifis:
95+ wlp59s0:
96+ optional: true
97+ access-points:
98+ BabCom:
99+ password: peekaboo
100+ dhcp4: false
101+ dhcp4-overrides:
102+ send-hostname: true
103+ addresses:
104+ - 10.25.0.134/16
105+ nameservers:
106+ addresses:
107+ - 10.25.0.10
108+ - 8.8.8.8
109+ - 8.8.4.4
110+ ` ` `
111+
112+ Once you have edited the netplan configuration file, run the following two commands :
113+ 1. `sudo netplan --debug generate` -- this will verify that the netplan configuration files can
114+ be read properly. Correct any errors before proceeding.
115+ 2. `sudo netplan try` -- this will try running the new configuration, but will automatically
116+ roll back if it doesn't work correctly.
117+ 3. `sudo netplan apply` -- this will apply the new configuration to your network interfaces.
66118
67119:::note
68120
0 commit comments