openwrt编译文档

Contents

1 The Router 3

1.1 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1.1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1.2 Initial configuration . . . . . . . . . . . . . . . . . . . . . 3

1.1.3 Failsafe mode . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 Configuring OpenWrt . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.1 Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.2 Wireless . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.1.1 Building an image . . . . . . . . . . . . . . . . . . . . . . 21

2.1.2 Creating packages . . . . . . . . . . . . . . . . . . . . . . 24

2.1.3 Creating binary packages . . . . . . . . . . . . . . . . . . 29

2.1.4 Creating kernel modules packages . . . . . . . . . . . . . . 30

2.1.5 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.1.6 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . 31

2.1.7 Using build environments . . . . . . . . . . . . . . . . . . 32

2.2 Extra tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.2.1 Image Builder . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.2.2 SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.4.1 Which Operating System does this device run? . . . . . . 36

2.4.2 Finding and using the manufacturer SDK . . . . . . . . . 38

2.4.3 Adding your target in OpenWrt . . . . . . . . . . . . . . 45

2.5 Debugging and debricking . . . . . . . . . . . . . . . . . . . . . . 47

2.5.1 Adding a serial port . . . . . . . . . . . . . . . . . . . . . 48

2.5.2 JTAG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

2.6 Reporting bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

2.6.1 Using the Trac ticket system . . . . . . . . . . . . . . . . 49

2.7 Submitting patches . . . . . . . . . . . . . . . . . . . . . . . . . . 50

2.7.1 How to contribute . . . . . . . . . . . . . . . . . . . . . . 50

1.1.2 Initial configuration

1.1.3 Failsafe mode

1.2 Configuring OpenWrt

1.2.1 Network

The network configuration is stored in /etc/config/network and is divided

into interface configurations. Each interface configuration either refers directly

to an ethernet/wifi interface (eth0, wl0, ..) or to a bridge containing multiple

interfaces. It looks like this:

config interface "lan"

option ifname "eth0"

or more interfaces, set ifname to a list of interfaces and add:

IDs to it, e.g. eth0.15. These can be nested as well. See the switch section for

this.

config interface

option ifname "eth0.15"

option proto "none"

This sets up a simple static configuration for eth0. proto specifies the protocol

used for the interface. The default image usually provides ’none’ ’static’,

’dhcp’ and ’pppoe’. Others can be added by installing additional packages.

When using the ’static’ method like in the example, the options ipaddr and

option dns "192.168.1.254 192.168.1.253" (optional)

DHCP currently only accepts ipaddr (IP address to request from the server)

and hostname (client hostname identify as) - both are optional.

config interface "lan"

option ifname "eth0"

option proto "dhcp"

option ipaddr "192.168.1.1" (optional)

option hostname "openwrt" (optional)

PPP based protocols (pppoe, pptp, ...) accept these options:

• username

• demand

• server: (pptp)

A sample PPPoE config would look like this:

config interface "lan"

option ifname "eth0"

option proto "pppoe"

option username "username"

option password "openwrt"

The name for the route section is optional, the interface, target and gateway

options are mandatory. Leaving out the netmask option will turn the route into

a host route.

Setting up the switch (broadcom only)

The switch configuration is set by adding a ’switch’ config section. Example:

config switch "eth0"

• ’*’: Set the default VLAN (PVID) of the Port to the current VLAN

• ’u’: Force the port to be untagged