Skip to content

Commit 6651b0a

Browse files
authored
Update networking.md
1 parent df15131 commit 6651b0a

File tree

1 file changed

+49
-2
lines changed

1 file changed

+49
-2
lines changed

troubleshooting/networking.md

Lines changed: 49 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,55 @@
11
# Pi is working, but I've got no networking
22

33

4-
- Is it the ethernet that isn't working?
5-
- Is it the wireless that isn't working?
4+
- [Is it the ethernet that isn't working?](#ethernet-problems)
5+
- [Is it the wireless that isn't working?](#wireless-problems)
66

77

8+
# Ethernet Problems
9+
10+
First thing to ensure, that the ethernet cable is plugged in to the Pi and to your router or switch.
11+
12+
### I'm not using a router or switch, but connecting straight to another computer
13+
14+
This isn't a standard configuration, and needs a bit more setting up, which is out of the scope of this troubleshooter and we don't currently have any documentation for it. Try Googling for connecting my Raspberry Pi directly to another computer.
15+
16+
### Check for an IP address
17+
18+
If you are connected up, but nothing seems to work, lets see if you have been assigned as IP address by your network. Type in ```ifconfig``` on the console. This will display the status of all networking devices. For ethernet, we need to look at the ```eth0``` entry, something like this, the actual numbers have been replaced by xx/yy/zz etc.
19+
20+
```
21+
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500
22+
inet xx.xx.xx.xx netmask 255.255.255.0 broadcast 10.3.14.255 <<<<<<< IPv4 address
23+
inet6 yyyy::yyyy:yyyy:yyyy:yyyy prefixlen 64 scopeid 0x20<link> <<<<<<< IPv6 address
24+
inet6 zzzz:zzzz:zzzz:zz:zzzz:zzzz:zzzz:zzz prefixlen 64 scopeid 0x0<global>
25+
ether qq:qq:qq:qq:qq:qq txqueuelen 1000 (Ethernet) <<<<<<< MAC address
26+
...
27+
```
28+
29+
So if you have an IP address, there will be numbers in the inet or inet6 lines or both. If not, then your router has not assigned you an IP address.
30+
31+
#### Hold on, I don't even have an entry for eth0...
32+
33+
This would be unusual, it implies that the Ethernet HW on the Raspberry Pi isn't working, or has been specifically disabled. If you are using a new Raspbian install, and haven't made any changes, this is probably a broken ethernet chip.
34+
35+
#### eth0 is present, but I don't have the inet or inet6 lines
36+
37+
OK, so the ethernet port appears to be working, but your router has not allocated your Raspberry pi an ethernet address. You need to check out your router isntructions to find out why that might be. It might be doing something called MAC address filtering, or similar which means it only allocates addresses to devices it knows about. You can use the `ifconfig` command to find the MAC address of your Raspberry Pi, it's the hexadecimal number in the form `qq:qq:qq:qq:qq:qq` on the line starting with `ether`.
38+
39+
### I have an IP address but no internet connection
40+
41+
So, the connection to your internal network is working OK, but you don't appear to have an internet connection. This could be a number of things.
42+
43+
TODO
44+
45+
### Slow connection
46+
47+
If you are using a Pi3B+ this has a gigbit ethernet adapter, and you might be expecting to get gigabit speeds. However, the Pi cannot communicate with the ethernet chip at that sort of speed due to inrerface limitation, so you will et less than that. It would normally be expected to get up to 250-300MBits/s.
48+
49+
#### But I only get about 85MBits/s!
50+
51+
This almost certainly a flow control problem. You need to turn on flow control on your router to help with the slower speed of the Pi ethernet. It might be called pause frames or similar. Most redidential routers have flow control turned on automatically. Commercial routers will probably need it to be turned on.
52+
53+
## Wireless problems
54+
855

0 commit comments

Comments
 (0)