| 1 | [[PageOutline]] |
| 2 | |
| 3 | This information has been tested and created for use on the Gateworks Single Board Computers (SBCs)''', specifically the Ventana family that utilizes the Freescale i.MX6 processors. |
| 4 | |
| 5 | Gateworks SBCs can be viewed at the following link: [http://www.gateworks.com] |
| 6 | |
| 7 | [[Image(http://trac.gateworks.com/raw-attachment/wiki/OpenWrt/wireless/relayd/gw5100realsmall.png,200px)]] |
| 8 | |
| 9 | = OpenWrt Access Point Configuration = |
| 10 | A generic Wireless Access Point (commonly known as a '''WAP''' or '''Wireless AP''') is likely the most common configuration and is what OpenWrt defaults to when a new radio is detected. |
| 11 | |
| 12 | There are 2 ways to configure: |
| 13 | 1. Web-Interface - a GUI that may be easier for some users. See tutorial to connect to the board: [wiki:access Accessing the Web Interface] |
| 14 | 2. shell via the command-line |
| 15 | |
| 16 | |
| 17 | == Configuring an Access Point from the shell == |
| 18 | |
| 19 | You can see this by checking the file on the Gateworks board /etc/config/wireless. |
| 20 | {{{ |
| 21 | root@OpenWrt:/# cat /etc/config/wireless |
| 22 | config wifi-device radio0 |
| 23 | option type mac80211 |
| 24 | option channel 11 |
| 25 | option hwmode 11ng |
| 26 | option phy phy0 |
| 27 | option htmode HT20 |
| 28 | list ht_capab LDPC |
| 29 | list ht_capab SHORT-GI-20 |
| 30 | list ht_capab SHORT-GI-40 |
| 31 | list ht_capab TX-STBC |
| 32 | list ht_capab RX-STBC1 |
| 33 | list ht_capab DSSS_CCK-40 |
| 34 | |
| 35 | config wifi-iface |
| 36 | option device radio0 |
| 37 | option network lan |
| 38 | option mode ap |
| 39 | option ssid OpenWrtGateworks |
| 40 | option encryption none |
| 41 | }}} |
| 42 | |
| 43 | |
| 44 | |
| 45 | == Configuring an Access Point via GUI == |
| 46 | |
| 47 | 1. Connect the board to the network through the Ethernet 1 interface. |
| 48 | |
| 49 | 2. Click on the Network tab, then the Interfaces tab. By default there should be an interface called “lan.” |
| 50 | |
| 51 | [[Image(AP3.jpg, 800px)]] |
| 52 | |
| 53 | 3. Edit the interface by either clicking on the LAN tab or by clicking on the icon under the Actions section with alt text “Edit this interface.” |
| 54 | |
| 55 | [[Image(AP4.jpg, 800px)]] |
| 56 | |
| 57 | 4. Click on the General Setup tab under Common Configuration. (This should already be selected). |
| 58 | |
| 59 | 5. Change the IP address in the IPv4-Address field to an available address on the network. This is only necessary if the current address (192.168.1.1) is not part of the network or is already being used on the network. |
| 60 | |
| 61 | 6. Add the gateway and DNS for the network into the IPv4-Gateway and DNS-Server fields respectively. If the networks gateway is 192.168.1.1, it might look something like this: |
| 62 | |
| 63 | [[Image(AP5.jpg, 800px)]] |
| 64 | |
| 65 | 7. Click on Save at the bottom of the screen. (Do not click on Save & Apply yet. Otherwise step 11 must be completed to access the board again.) |
| 66 | |
| 67 | 8. Click on the Physical Settings tab next to the General Setup tab. |
| 68 | |
| 69 | 9. Make sure the boxes next “creates a bridge over specified interface(s)” and “Ethernet Adapter: ‘eth0’” are checked. If not, check them. |
| 70 | |
| 71 | 10. Check the box next to“Ethernet Adapter: eth1” |
| 72 | |
| 73 | [[Image(AP6.jpg, 800px)]] |
| 74 | |
| 75 | 11. Click on Save & Apply at the bottom of the screen. If the IP address was changed in step 9, the address in the address bar of the browser must be changed to the new IP address. In this case the IP address was changed to 192.168.1.10. |
| 76 | |
| 77 | 12. Enter the username and password to login and access the board again. |
| 78 | |
| 79 | [[Image(AP7.jpg, 800px)]] |
| 80 | |
| 81 | == Configuring the Wifi == |
| 82 | |
| 83 | 13. Connect a wireless card to any of the four PCI slots on the board. |
| 84 | |
| 85 | 14. Reboot the board and login again. |
| 86 | |
| 87 | 15. Click on the Network tab, then the Wifi tab. |
| 88 | |
| 89 | 16. The wireless card should show up under Wireless Overview. |
| 90 | |
| 91 | [[Image(AP8.jpg, 800px)]] |
| 92 | |
| 93 | 17. Edit the Wireless Controller by clicking on the icon with alt text “Edit this network.” |
| 94 | |
| 95 | 18. Click on the General Setup tab under Device Configuration. (This should already be selected). |
| 96 | |
| 97 | 19. Check the box next to “Enable device.” |
| 98 | |
| 99 | 20. Click on Save & Apply at the bottom of the screen. |
| 100 | |
| 101 | 21. Click on the General Setup tab under Interface Configuration. (This should already be selected). |
| 102 | |
| 103 | 22. Change ESSID to a desired name. |
| 104 | |
| 105 | 23. Make sure Mode is set to Access Point. |
| 106 | |
| 107 | 24. Change Network to “lan” |
| 108 | |
| 109 | [[Image(AP9.jpg, 800px)]] |
| 110 | |
| 111 | 25. Click on Save at the bottom of the screen. |
| 112 | |
| 113 | 27. Click on the Wireless Security tab next to the General Setup tab. |
| 114 | |
| 115 | 28. Set desired wireless security settings. In this case the Encryption is set to WPA-PSK and a key is chosen. |
| 116 | |
| 117 | [[Image(AP10.jpg, 800px)]] |
| 118 | |
| 119 | 29. Click on Save & Apply at the bottom of the screen. |
| 120 | |
| 121 | 30. The board should now be acting as an access point. |
| 122 | |
| 123 | |
| 124 | == Multiple Access Points per radios (Multiple SSID's) == |
| 125 | Another common configuration is to have multiple Access Points (multiple SSID's) on a physical radio. In this case, there are multiple 'wifi-iface' config sections linking to a specific 'wifi-device' config section. This is sometimes known as '''Virtual Access Points''' and each Access Point shares the same radio configuration (channel, band, modes) |
| 126 | |
| 127 | This is useful to allow different groups of people with different permissions (each group using a different SSID's on the same radio). Each Virtual Access Point can have its own network configuration, SSID, and security configurations. |
| 128 | |
| 129 | To configure this from the GUI, select Network -> Wifi and click the 'Add' Button in the top right. |
| 130 | This will add another interface with a new SSID connected to the same radio. |
| 131 | |
| 132 | To configure this from the shell you would use UCI commands or edit /etc/config/wireless to create multiple 'config wifi-iface' sections that points to the same 'wifi-device' specified via the 'device' option in the wifi-iface section. |
| 133 | |
| 134 | For example: |
| 135 | {{{ |
| 136 | root@OpenWrt:/# cat /etc/config/wireless |
| 137 | |
| 138 | config wifi-device 'radio0' |
| 139 | option type 'mac80211' |
| 140 | option channel '36' |
| 141 | option hwmode '11a' |
| 142 | option phy 'phy0' |
| 143 | option htmode 'HT20' |
| 144 | list ht_capab 'LDPC' |
| 145 | list ht_capab 'SHORT-GI-20' |
| 146 | list ht_capab 'SHORT-GI-40' |
| 147 | list ht_capab 'TX-STBC' |
| 148 | list ht_capab 'RX-STBC1' |
| 149 | list ht_capab 'DSSS_CCK-40' |
| 150 | |
| 151 | config wifi-iface |
| 152 | option device 'radio0' |
| 153 | option network 'ap1' |
| 154 | option mode 'ap' |
| 155 | option ssid 'OpenWrt-AP1' |
| 156 | option encryption 'none' |
| 157 | |
| 158 | config wifi-iface |
| 159 | option device 'radio0' |
| 160 | option network 'ap2' |
| 161 | option mode 'ap' |
| 162 | option ssid 'OpenWrt-AP2' |
| 163 | option encryption 'none' |
| 164 | }}} |
| 165 | |
| 166 | == Other useful links == |
| 167 | * [http://www.openwrt.org] |
| 168 | * [http://www.smallbusinesstech.net/more-complicated-instructions/openwrt/hosting-two-wifi-networks-on-one-openwrt-router] |