Ralink RT2880, User Manual

Page 1: ...any rights to use sell design or manufacture from this information or the software documented herein No reproduction publication or disclosure of this information in whole or in part shall be allowed unless the prior written consent of Ralink Technology Corporation is obtained NOTE THIS DOCUMENT CONTAINS SENSITIVE INFORMATION AND HAS RESTRICTED DISTRIBUTION N u k o p e n PDF XChange w w w easycomp...

Page 2: ...e liable for any special indirect or consequential damages associated with or arising from use of the Proprietary Information in any way including any loss of use data or profits Ralink retains all right title or interest in any Proprietary Information or any Intellectual Property embodied therein The Proprietary Information shall not in whole or in part be reversed decompiled or disassembled nor ...

Page 3: ...3 5 1 Install toolchain 23 5 2 Install LZMA Utility 23 5 3 Install mksquashfs utility 23 6 Boot loader 24 6 1 Uboot Configuration 24 6 2 Build the uboot Image 25 6 3 Burn the uboot image 25 7 User Library 27 7 1 Library Configuration 27 7 2 Library Porting 27 7 3 Build user library 28 8 User Application 29 8 1 Ralink Proprietary Applications 29 N u k o p e n PDF XChange w w w easycomputing c o m N...

Page 4: ...8 1 9 I2CCMD 33 8 1 10 Script 33 8 2 goahead 33 8 3 nvram library 33 8 4 wsc_upnp 34 8 5 iptables 34 8 6 ntpclient 34 8 7 mtd utils 34 8 8 ppp 2 4 2 34 8 9 bridge utils 34 8 10 wireless_tools 35 8 11 inadyn 35 8 12 zebra 0 95a_ripd 35 8 13 wpa_supplicant 0 5 7 35 N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 5: ... 25 usb_modeswitch 0 9 5 37 8 26 Port new user application 38 9 Linux Kernel 40 9 1 Linux configuration 40 9 2 Change Flash DRAM Size 42 9 3 Change Switch Controller in RT2880 Platform 42 9 4 Update User Kernel default settings 43 9 5 Compile Linux image 44 9 6 Port new Linux kernel module 44 9 7 Execute commands at boot up time 46 9 8 Add new files in RootFs 46 N u k o p e n PDF XChange w w w eas...

Page 6: ... 54 11 3 2 Example 2 54 11 4 Enable Ethernet Converter Feature 55 11 5 Change RF chip from RT2820 to RT2850 on the RT2880 platform 57 11 6 How to change the Ethernet MAC address 57 11 7 How to configure GPIO ports 58 11 8 Use GPIO to turn on LED 59 11 9 Use LED firmware to turn on LED 63 11 10 How to start the telnet server 66 11 10 1 busybox setting 66 11 10 2 Linux setting 66 11 11 11n bit rate ...

Page 7: ... How to enable software QoS 78 11 20 Software QoS information 81 11 20 1 Software QoS Preface 81 11 20 2 Software QoS Concept 81 11 20 3 Software QoS Usage 82 11 21 How to enable USB Ethernet example for ASIX AX88XXX 85 11 22 How to build a single image for the RT2880 8M flash platform 87 11 23 How to start a printer server example for HP officejet 4355 88 11 24 How to force the RT3052 link speed ...

Page 8: ...pport Formal 2007 03 20 1 3 SDK Feature parity with 1 2 SDK plus Application NTP DDNS WebUI enhance Vista RG Native IPv6 LLTD Firewall Driver I2C SPI GPIO driver Wi Fi features Intergraded QA WPS mBSSID WDS STA mode 802 1x Concurrent AP support RT2880 MP Support Beta 2007 04 30 Formal 2007 05 25 2 0 SDK Feature parity with 1 3 SDK plus File system support ramdisk and squashfs WebUI save restore co...

Page 9: ... Feature parity with 2 2 SDK plus iNIC v1 1 6 1 RT2561 driver v1 1 2 0 Spansion Flash Support RT2860 AP driver v1 7 RT2860 STA driver v1 5 RT2561 WebUI Multi Language WebUI support IC 100Phy Realtek 100Phy Formal 2008 01 16 2 4 SDK Feature parity with 2 3 SDK plus iNIC v1 1 7 1 RT2860 AP driver v1 8 1 0 RT2860 STA driver v1 6 0 0 Static Dynamic Routing Content Filtering Mii iNIC Formal 2008 04 07 ...

Page 10: ... platforms RT3052 platforms Formal 2008 10 06 3 3 SDK Feature parity with 3 2 SDK plus RT2860 AP driver v2 2 0 0 RT2860 STA driver v2 1 0 0 RT2880 platforms RT3050 platforms RT3052 platforms Formal 2009 04 27 3 4 SDK Feature parity with 3 3 SDK plus RT2860 AP driver v2 4 0 0 RT2860 STA driver v2 3 0 0 RT2880 platforms RT3050 platforms RT3052 platforms RT3350 platforms RT3883 platforms RT3662 platf...

Page 11: ...RALINK AP SDK 3 3 0 0 User s Manual Page 11 of 93 RT3352 platforms N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 12: ...infred Lu 3 0 Updated for RT3052 Chapter Re organization Steven Liu 3 1 Update default parameter for LED firmware Update GPIO definition for RT3052 platform Update FAQ Steven Liu 3 2 Reorganize user manual Update FAQ How to enable NFS Client How to add new language to webUI How to Power down rt305x Ethernet ports How to enable USB storage in RT305x platform How to enable USB automount in RT305x pl...

Page 13: ...ion chips The RT2820 for 2 4G band operation and the RT2850 for dual band 2 4G or 5G operations In addition to traditional AP router applications the chipset can be implemented as a WLAN intelligent NIC drastically reducing the load on the host SOC such as DSL Cable or Multimedia Applications processors Users can treat the WLAN iNIC as a simple Ethernet device for easy porting and guaranteed 802 1...

Page 14: ...256 Reserved 0030 0B00 0030 0BFF 256 SPI 0030 0C00 0030 0CFF 256 UART Lite 0030 0D00 0030 0DFF 256 Reserved 0030 0F00 0030 0FFF 256 Reserved 0030 1000 0030 FFFF 1020K Reserved 0040 0000 0040 FFFF 64K Frame Engine 0041 0000 0041 FFFF 64K Embedded 16KB ROM wrap around in the 64KB space 0042 0000 0042 FFFF 64K PCM Controller 0043 0000 0043 FFFF 64K Reserved 0044 0000 0047 FFFF 256K PCI Host Device Co...

Page 15: ...2R MAC BBP RF a high performance 384MHz MIPS24KEc CPU core 5 port integrated 10 100 Ethernet switch PHY an USB OTG and a Gigabit Ethernet MAC There are very few external components required for 2 4GHz 11n wireless products with the RT3052 It employs Ralink s 2nd generation 11n technologies for longer range and better throughput The embedded high performance CPU can process advanced applications ef...

Page 16: ...lash SRAM 1000 0400 1000 04FF 256 PCM 1000 0500 1000 05FF 256 UART 1000 0600 1000 06FF 256 PIO 1000 0700 1000 07FF 256 Generic DMA 1000 0800 1000 08FF 256 NAND Flash Controller 1000 0900 1000 09FF 256 I2C 1000 0A00 1000 0AFF 256 I2S 1000 0B00 1000 0BFF 256 SPI 1000 0C00 1000 0CFF 256 UARTLITE 1000 0D00 100F FFFF Reserved 1010 0000 1010 FFFF 64K Frame Engine 1011 0000 1011 7FFF 32K Ethernet Switch ...

Page 17: ...pped for boot from NAND application When BOOT_FROM 2 b11 8KB internal boot ROM is mapped for iNIC application 3 3 RT3883 The RT3883 SOC combines Ralink s 802 11n draft compliant 3T3R MAC BBP RF a high performance 500MHz MIPS74Kec CPU core a Gigabit Ethernet MAC and a USB Host Device With the RT3883 there are very few external components required for 2 4 5GHz 11n wireless products The RT3883 employ...

Page 18: ...RALINK AP SDK 3 3 0 0 User s Manual Page 18 of 93 Figure 3 The RT3883 Demo Board N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 19: ... 1000 0D00 1000 0DFF Reserved 1000 2000 1000 27FF 2 K PCM up to 16 channel 1000 2800 1000 2FFF 2 K Generic DMA up to 64 channel 1000 3000 1000 37FF 2 K CODEC 1 1000 3800 1000 3FFF 2 K CODEC 2 1000 4000 100F FFFF Reserved 1010 0000 1010 FFFF 64 K Frame Engine 1011 0000 1011 7FFF 32 K Reserved 1011 8000 1011 BFFF 16 K ROM 1011 C000 1011 FFFF 16 K Reserved 1012 0000 1012 7FFF 16 K USB Device 1012 800...

Page 20: ... BBP PA RF a high performance 400MHz MIPS24KEc CPU core a Gigabit Ethernet MAC 5 pors integrated 10 100 Ethernet Swtich PHY and an USB Host Device With the RT3352 there are very few external components required for 2 4GHz 11n wireless products The RT3352 employs Ralink 2nd generation 11n technologies for longer range and better throughput The embedded high performance CPU can process advanced appl...

Page 21: ...0 0DFF 256 MIPS CNT 1000 2000 1000 27FF 2 K PCM up to 16 channel 1000 2800 1000 2FFF 2 K Generic DMA up to 64 channel 1000 3000 1000 37FF 2 K Reserved 1000 3800 1000 3FFF 2 K Reserved 1000 4000 100F FFFF Reserved 1010 0000 1010 FFFF 64 K Frame Engine 1011 0000 1011 7FFF 32 K Ethernet Swtich 1011 8000 1011 BFFF 16 K ROM 1011 C000 1011 FFFF 16 K Reserved 1012 0000 1012 7FFF 16 K USB Device 1012 8000...

Page 22: ...e subsequent directories o toolchain mips toolchain o source Linux kernel source o tools useful script The source directory contains the subsequent directories o config auto configuration files o images Linux image o lib uClibc 0 9 28 o linux 2 4 x Linux kernel source for RT2880 o linux 2 6 21 x Linux kernel source for RT3052 o romfs root file system uncompressed o tools useful script to generate ...

Page 23: ...zma is necessary to make the compressed kernel image The Ralink RT2880 SDK uses lzma to compress the kernel image cd RT288x_SDK toolchain lzma 4 32 0beta3 configure make make install install lzma to usr local bin Use gzip or lzma to compress the kernel image Make changes to RT288x_SDK source vendors Ralink Platform Makefile COMP gzip Use gzip to compress the Linux kernel image COMP lzma Use lzma t...

Page 24: ...bin LZMA_ALONE IS NECESSARY TO MAKE YOUR OWN RAMDISK IMAGE IF YOU TURN ON COMPRESS RAMDISK BY LZMA FOR RT3052 make menuconfig Kernel Library Defaults Selection Machine selection Compress ramdisk by lzma instead of gzip 6 BOOT LOADER 6 1 Uboot Configuration tar jxvf Uboot_ version _ BETA FINAL _ date tar bz2 cd Uboot make menuconfig 1 Set the DRAM Size DRAM Component Row Column 64Mb 12 8 128Mb 12 9...

Page 25: ... mode when the board turns on Clients on the LAN get the dynamic IP address from the remote DHCP server connected to the WAN port Set the LAN WAN partition to prevent the Client s DHCP request being sent to the WAN side 6 2 Build the uboot Image make NOR Flash uboot bin is located in Uboot cp uboot bin tftpboot SPI Flash uboot img is located in Uboot cp uboot img tftpboot NAND Flash uboot img is l...

Page 26: ...to SDRAM via TFTP You chose 9 9 System Load Boot Loader then write to Flash via TFTP Warning Erase Boot Loader in Flash then burn new one Are you sure Y N Please Input new ones or Ctrl C to discard Input device IP 10 10 10 123 Input server IP 10 10 10 99 Input Uboot filename uboot bin N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 27: ...ngs Figure 4 uClib configuration Menu 7 2 Library Porting The subsequent instructions show how to add a new library to the RT288x_SDK Example Port libtest to RT288x_SDK 1 cp r libtest to RT288x_SDK source lib 2 modify RT288x_SDK source lib libtest Makefile you can reference to libnvram Makefile 3 modify RT288x_SDK source lib Makefile ifeq CONFIG_LIB_LIBTEST_FORCE y DIRS libtest endif N u k o p e n...

Page 28: ...EST_FORCE make menuconfig You can see the Build libtest on the menu Figure 5 User Library Configure Menu 5 Compile your new library make dep make lib_only 7 3 Build user library cd RT288x_SDK source make lib_only make romfs The shared libraries are shown in RT288x_SDK source romfs lib N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 29: ...ly from the LAN port to the PC Execute QA on the PC wait 30 seconds 8 1 2 REG Description register the read write test program Usage reg r w s offset value Note To use system register reg s 0 To use wireless register reg s 1 To use other base address offset reg s offset The rt_rdm module must be put in first Example reg s 0 reg r 18 read A0300018 reg w 18 12345678 write 0x12345678 to A0300018 8 1 ...

Page 30: ...e It is important to know what normal function pins are shared with the GPIO pins Only one normal function and GPIO can operate at the same time GPIOMODE GPIO purpose select Configure the pins to use as GPIO PIODIR programmed I O direction Configure the direction of all GPIO pins to use as GPIO an output is set as 1 and an input pin is set as 0 PIODATA programmed I O data Write data for output GPI...

Page 31: ...egister via the mdc mdio interface IOCTL interface typedef struct ralink_mii_ioctl_data __u32 phy_id __u32 reg_num __u32 val_in __u32 val_out o phy_id Address of PHY device o reg_num Register addresses within PHY device o val_ine GET the phy register data that is read from phy SET the current register data after MDIO setting o Val_out the phy register data that wants to be set o User applications ...

Page 32: ...e GoAhead web server to start the WPS PBC procedure by sending it SIGUSR1 If SIGUSR2 is received user pressed GPIO pin 0 button for several seconds nvram_daemon will restore the system configuration to the default values Usage a get nvram_get 2860 inic field b set nvram_set 2860 inic field c init ralink_init command platform file Commands rt2860_nvram_show display rt2860 values in nvram inic_nvram...

Page 33: ...spicmd read the address spicmd writes the size address value size is 1 2 4 bytes 8 1 9 I2CCMD Description I2C Toolkit for EEPROM Read Write via I2C Interface Usage i2ccmd read write parameters Note i2ccmd read the address i2ccmd write the size address value size is 1 2 4 bytes 8 1 10Script Description WebUI configuration script Usage Refer to the script help message 8 2 goahead Source code RT288x_...

Page 34: ...mited scope It is much smaller than xntpd and is more applicable to embedded computers 8 7 mtd utils Source code RT288x_SDK source user mtd utils Description for jffs2 file system support erase format etc example mkfs jffs2 erase eraseall 8 8 ppp 2 4 2 Source code RT288x_SDK source user ppp 2 4 2 Description a package which uses the Point to Point Protocol PPP to supply Internet connections over s...

Page 35: ...e IP address stored by the DNS server is the real current address of the machine that is running INADYN 8 12 zebra 0 95a_ripd Source code RT288x_SDK source user zebra 0 95a_ripd Description GNU Zebra is free software that manages various IPv4 and IPv6 routing protocols Currently GNU Zebra supports BGP4 BGP4 OSPFv2 OSPFv3 RIPv1 RIPv2 and RIPng 8 13 wpa_supplicant 0 5 7 Source code RT288x_SDK source...

Page 36: ...protocol for Linux and other Unix systems 8 18 rp l2tp 0 4 Source code RT288x_SDK source user rp l2tp 0 4 Description This is a user space implementation of L2TP RFC 2661 for Linux 8 19 ctorrent dnh3 2 Source code RT288x_SDK source user ctorrent dnh3 2 Description CTorrent is a BitTorrent Client program written in C C for FreeBSD and Linux CTorrent is fast and small 8 20 dhcp6 Source code RT288x_S...

Page 37: ...vices It is an open source software package available under the GNU license It consists of a single library file with a simple API set that an application writer can use to secure their application 8 24 rp pppoe 3 8 Source code RT288x_SDK source user rp pppoe 3 8 Description pppoe is a user space redirector which permits the use of PPPoE Point to Point Over Ethernet with Linux PPPoE is used by man...

Page 38: ...ello o CFLAGS all EXEC EXEC OBJS CC LDFLAGS o OBJS romfs ROMFSINST bin EXEC clean rm f EXEC elf gdb o c Add hello c to RT288x_SDK source user hello main printf hello world n d Edit RT288x_SDK source config config in mainmenu_option next_comment comment XXX Add on Applications bool hello_world CONFIG_USER_HELLO_WORLD endmenu e Edit RT288x_SDK source user Makefile N u k o p e n PDF XChange w w w eas...

Page 39: ... is correct cd RT288x_SDK source romfs bin file hello hello ELF 32 bit LSB executable MIPS MIPS II version 1 SYSV dynamically linked uses shared libs stripped i Testing BusyBox v1 4 2 2007 05 04 11 15 35 CST Built in shell ash Enter help for a list of built in commands hello hello world N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 40: ... complete AP solution including AP STA mode 8M 32M 8M Flash and 32M DRAM for complete AP NAS solution including USB applications Note 1 Choose the target platform type RT2880 or RT3052 or RT3883 2 Modify the User Kernel Configuration or Load Save User Kernel Default setting 3 Load the target platform setting from a file 4 Save the target platform setting to a file Use Kernel Library Defaults Selec...

Page 41: ...ings Go to RT288x_SDK source vendors Ralink RT2880 RT3052 RT3883 config to see all the default setting files a Busybox default configuration files 2M_16M_config busybox 2 4 x 2M_16M_config busybox 2 6 21 x 4M_16M_config busybox 2 4 x 4M_16M_config busybox 2 6 21 x 8M_16M_config busybox 2 4 x 8M_16M_config busybox 2 6 21 x b User application default configure file 2M_16M_config vendor 2 4 x 2M_16M_...

Page 42: ...ze setting using make menuconfig if you increase or decrease the size of DRAM make menuconfig Kernel Library Defaults Selection Customize Kernel Settings NEW Machine selection Linux 2 4 RT2880 ASIC RT2880 Chip Type 32M DRAM Size 4M Flash Size Linux 2 6 System type Ralink RT3052 board Soc Hardware Type RT3052 ASIC DRAM Size 32M Root File System Type RootFS_in_RAM 9 3 Change Switch Controller in RT2...

Page 43: ...r rt2880_app scripts Figure 6 IC 10 100 Switch Operation Diagram 9 4 Update User Kernel default settings Modify the default setting if necessary Select the Kernel Library Defaults Selection item to enter the kernel application configuration menu After entering the menu select the Update Default Vendor Settings item to update the User Kernel default settings Note the new default setting will be sav...

Page 44: ...nel rootfs c zImage gz lzma compressed Linux kernel Note What kinds of make can be used a make Linux image if you modify kernel source files b make modules romfs Linux image if you modify the kernel module source files c make user_only romfs Linux image if you modify application source files d You can execute make to generate a new image make make lib_only user_only modules romfs Linux image 9 6 P...

Page 45: ...s net hello main c include linux init h include linux module h static int hello_init void printk hello world n return 0 static void hello_exit void printk goodbye n module_init hello_init module_exit hello_exit MODULE_LICENSE GPL 2 Modify RT288x_SDK source linux 2 4 x drivers net Makefile subdir CONFIG_RT2880_HELLO hello 3 Modify Config in tristate Ralink hello module CONFIG_RT2880_HELLO 4 Turn on...

Page 46: ...ete RT288x_SDK source romfs directory You cannot copy the file to RT288x_SDK source romfs manually because it will disappear after executing make clean Example add xxx bin to rootfs a copy xxx bin to RT288x_SDK source vendors Ralink RT2880 RT3052 RT3883 b edit RT288x_SDK source vendors Ralink RT2880 RT3052 RT3883 Makefile romfs ROMFSINST etc_ro xxx bin The script will copy xxx bin to RT288x_SDK so...

Page 47: ...g 0x30000 mtd 2 RF 0x40000 Kernel 0x50000 mtd 3 Padding menuconfig mtd 4 Root FS 0x400000 In RootFS in Flash mode the image builder will add a padding bit to the end of kernel image if the kernel image size is smaller than the size of mtd3 The size of mtd3 must be adjusted to save flash memory Step1 Check the original kernel image size ex 446603 N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 48: ...T288x_SDK source romfs Compressed RootFs Size 1069056 home steven RT288x_SDK source images ramdisk Padded Kernel Image Compressed Rootfs Size 1855424 home steven RT288x_SDK source images zImage lzma Step2 Change mtdblock size 576110 0x8CA6E 0x90000 multiple of 0x10000 because the flash sector size 64KB mtd 0 Uboot 0x0 mtd 1 Config 0x30000 mtd 2 RF 0x40000 mtd 3 Kernel 0x50000 N u k o p e n PDF XCh...

Page 49: ...d 4 Root FS 0x400000 host make menuconfig Hit Kernel Library Defaults Selection to enter configuration menu Leave configuration menu and save new kernel configuration N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 50: ... the WLAN0 configuration is for built in RT2860 parameters the WLAN1 configuration is for iNIC parameters and the WLAN2 configuration is for RT2561 parameters Use the free space to save your own parameters if you don t need to support iNIC or RT2561 on your product 10 2 Firmware Upgrade N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 51: ... to 0x400000 2 Select option 9 on the Uboot menu to update your uboot from 0x0 to 0x30000 10 2 2By WebUI You can use WebUI to upgrade the Linux image Figure 8 WebUI Firmware Upgrade CGI uses the mtd_write command to burn a Linux image N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 52: ...urn Linux image to mtdblock3 Kernel File system in Flash Burn first x bytes to mtdblock3 and others to mtdblock4 ps X byes MTTD kernel partition size in make menuconfig N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 53: ... Flow Control None Table 6 Web Setting Item Default Value User Name admin Password admin 11 2 System requirements for the host platform RT2880 SDK uses Fedora 6 Host to build the image Change your Linux distribution if you cannot successfully build the image Table 7 Requirements of Host Platform Item Value Linux Distribution Fedora 6 Kernel version 2 6 18 1 2798 fc6 RAM 512MB HD 40G N u k o p e n ...

Page 54: ..._vlan and add the following line WHOAMI steven 2 Push wps load_default button or execute the following commands ralink_init clear 2860 reboot 3 Use nvram_get to retrieve WHOAMI parameter in script file RT288x_SDK source user rt2880_app scripts or nvram_bufset nvram_bufget nvram_commit in your CGI RT288x_SDK source user goahead src to use your feature 11 3 2Example 2 Save the RADIO ON OFF button in...

Page 55: ...On radio doSystem ifconfig ra0 up websRedirect wp wireless basic asp return 3 Modify the RT288x_SDK source user rt2880_app scripts internet sh script not to bring ra0 up if RadioOn value stored in flash is not 1 Change ifconfig ra0 0 0 0 0 to radio nvram_get 2860 RadioOn if radio 1 ifconfig ra0 0 0 0 0 up else ifconfig ra0 0 0 0 0 down fi 11 4 Enable Ethernet Converter Feature N u k o p e n PDF XC...

Page 56: ...iagram If the RT2880 platform can be operated as an AP or Ethernet converter by WebUI Configuration make sure STA support and AP support as a Linux module is on in the rt2860v2 driver Turn on the rt2860v2 STA support if the RT2880 platform is an Ethernet converter only Select the operation mode on the Operation Mode Configuration web page N u k o p e n PDF XChange w w w easycomputing c o m N u k o...

Page 57: ...gram will immediately burn the binary file to flash Figure 11 QA Burn your own EEPROM binary file 11 6 How to change the Ethernet MAC address The Ralink Ethernet driver uses GMAC0_ADDR to save its LAN WAN mac address If GMAC0_ADDR is empty it will generate a random mac address instead define GMAC0_ADDR RT_EEPROM_BASE 0x28 define GMAC1_ADDR RT_EEPROM_BASE 0x2E rt2860v2_sta N u k o p e n PDF XChange...

Page 58: ... and bit 0 is for input For example value 0x5 is for configuring GPIO pin 0 and 2 as output pins and the other pins as input pins RALINK_GPIO_SET_DIR_IN Configure one or several GPIO pins as input pins using bitmaps For example value 0x5 is for configuring GPIO pin 0 and 2 as input pins and other pins are ignored RALINK_GPIO_SET_DIR_OUT Configure one or several GPIO pins as output pins using bitma...

Page 59: ...om GPIO data RALINK_GPIO_WRITE_BYTE Write a corresponding byte to the GPIO data For example byte 2 and value 0x33 mean to write value 0x33 to the third byte of the GPIO data RALINK_GPIO_READ_INT Same as RALINK_GPIO_READ RALINK_GPIO_WRITE_INT Same as RALINK_GPIO_WRITE RALINK_GPIO_SET_INT Same as RALINK_GPIO_SET RALINK_GPIO_CLEAR_INT Same as RALINK_GPIO_CLEAR RALINK_GPIO_ENABLE_INTP Enable GPIO inpu...

Page 60: ...ser s Manual Page 60 of 93 Table 8 GPIO Usage of RT2880 Table 9 GPIO Usage of RT3052 Table 10 GPIO Usage of RT3883 RT3662 N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 61: ...ved for internal use The Ralink SDK GPIO driver gives an interface to set the frequency of the LEDs connected to the GPIOs Define RALINK_GPIO_LED_LOW_ACT to 1 at SDK linux 2 4 x drivers char ralink_gpio h if the LEDs are inactive Otherwise define it as 0 make menuconfig Kernel Library Defaults Selection Customize Kernel Settings NEW Character devices Ralink RT2880 GPIO Support Ralink GPIO LED Supp...

Page 62: ...ze Vendor User Settings Ralink RT288x Application RT2880 GPIO Test Usage gpio l gpio on off blinks rests times gpio GPIO number of the board on number of ticks that the LED will be bright off number of ticks that the LED will be dark blinks number of on offs that the LED will blink rests number of on offs that the LED will rest times number of blinks before the LED stops Note 1 tick is equal to 10...

Page 63: ... tick bright 1 tick dark blinking for 10 on offs resting for 5 on offs and never stops Success gpio l gpio 3000 1 1 1 1 i e 3000 ticks bright 1 tick dark blinking for one on offs and one time To turn the LED on and keep it on gpio l gpio 4000 0 1 0 4000 To turn the LED off and keep it off gpio l gpio 0 4000 0 1 4000 11 9 Use LED firmware to turn on LED 1 enable LED firmware make menuconfig Kernel ...

Page 64: ...ll out flash content to control the LED behavior because the LED firmware will read the configuration from flash Table 11 RT2880 LED Parameters in Flash N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 65: ...5 of 93 The current Ralink default flash hex values are subsequently shown RT2880 Flash Base Address 0x40000 4003B 1 controlled by firmware N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 66: ...server Check RT288x_SDK source user busybox config 11 10 1 busybox setting CONFIG_FEATURE_DEVPTS y General Configuration CONFIG_FEATURE_SUID y General Configuration CONFIG_LOGIN y Login Password Management Utilities CONFIG_TELNETD y Networking utilities CONFIG_FEATURE_TELNETD_STANDALONE y Check RT288x_SDK source linux 2 4 x config 11 10 2 Linux setting CONFIG_UNIX98_PTYS y Character devices CONFIG...

Page 67: ...RALINK AP SDK 3 3 0 0 User s Manual Page 67 of 93 N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 68: ...r 2 Bandwidth Data subcarriers on different bandwidths 20MHz and 40MHz a NSD Number of data subcarriers NSD 40Mhz 108 NSD 20Mhz 52 NSD 40Mhz NSD 20MHz 108 52 2 0769230769230769230769230769231 b Example MCS 15 GI 800ns BW 20MHz DataRate 130Mbps MCS 15 GI 800ns BW 40MHz DataRate 130 Nsd 40Mhz Nsd 20Mhz 130 108 52 270Mbps c Please refer to IEEE P802 11n D2 04 June 2007 on page 314 for subsequent tabl...

Page 69: ...aft 2 04 page 316 and Table 211 MCS parameters for optional 40 MHz NSS 2 NES 1 EQM 665 Data rate Mb s MCS Index Modulation R NBPSCS iSS NSD NSP NCBPS NDBPS 800 ns GI 400 ns GI 8 BPSK 1 2 1 108 6 216 108 27 0 30 0 9 QPSK 1 2 2 108 6 432 216 54 0 60 0 10 QPSK 3 4 2 108 6 432 324 81 0 90 0 11 16 QAM 1 2 4 108 6 864 432 108 0 120 0 12 16 QAM 3 4 4 108 6 864 648 162 0 180 0 13 64 QAM 2 3 6 108 6 1296 8...

Page 70: ...flash programmer Example Make a 4M single image for the rt2880 platform the Uboot partition is 192K user configuration partition is 64K and RF partition is 64K RT288x_SDK tools single_img vi Makefile 4M Change uboot kernel size if necessary UBOOT_SIZE 0x50000 KERNEL_SIZE 0x3B0000 N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 71: ...ge Single Image Information PACKED_DIR PACKED_IMAGE steven_uImage img cp tftpboot uboot bin cp tftpboot steven_uImage make f Makefile 4M Flash layout Uboot UsrCfg RF Linux Kernel Image 0x50000 0x3B0000 Original Uboot Image Size 149372 uboot bin Original Kernel Image Size 2779348 steven_uImage N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 72: ...he rt305x Ethernet ports Port 0 1 2 3 4 Map W L L L L MII control register Bit Name Description Read Write Default 15 mr_main_reset 1 Reset 0 Normal reset all digital logic except phy_reg R W SC 1 h0 14 loopback_mii Mii loop back R W 1 h0 13 force_speed 1 100Mbps 0 10Mbps when mr_autoneg_enable 1 b0 R W 1 h1 12 mr_autoneg_enable 1 Enabled 0 Normal R W 1 h1 11 powerDown phy into power down power do...

Page 73: ...e extern u32 mii_mgr_read unsigned int unsigned int unsigned int extern u32 mii_mgr_write unsigned int unsigned int unsigned int mii_mgr_write 0 0 0x3900 set port 0 register0 bit11 mii_mgr_write 1 0 0x3900 set port 1 register0 bit11 mii_mgr_write 2 0 0x3900 set port 2 register0 bit11 mii_mgr_write 3 0 0x3900 set port 3 register0 bit11 mii_mgr_write 4 0 0x3900 set port 4 register0 bit11 You also ne...

Page 74: ...2 6 NFS file system support Provide NFSv3 client support Provide client support for the NFSv3 ACL protocol extension Provide NFSv4 client support EXPERIMENTAL Allow direct I O on NFS files Kernel Library Defaults Selection Customize Kernel Settings NEW Customize Busybox Settings Linux System Utilities mount Support mount helpers Support mounting NFS file systems Example mount o nolock 192 168 18 2...

Page 75: ...ote the translation should be UTF 8 encoded 2 Add an entry to RT288x_SDK source config config in dep_bool language pack Korean CONFIG_USER_GOAHEAD_LANG_KR CONFIG_USER_GOAHEAD_HTTPD 3 Add an entry toRT288x_SDK source user goahead Makefile ifneq CONFIG_USER_GOAHEAD_LANG_KR y rm rf ROMFSDIR ROOT_DIRECTORY lang kr endif 4 RT288x_SDK source user goahead src utils c Add to getLangBuilt function else if ...

Page 76: ...ings Network Applications select Korean language pack 11 16 How to enable watchdog in RT305x make menuconfig Kernel Library Defaults Selection Customize Kernel Settings Device Drivers Character devices Watchdog Cards M Ralink APSoC Hardware Watchdog Ralink WatchDog Reset Output Customize Vendor User Settings Miscellaneous Applications watchdog Finally Enable watchdog in WebUI 11 17 How to enable U...

Page 77: ...pace support DOS FAT NT Filesystems VFAT Windows 95 fs support 437 Default codepage for FAT NEW iso8859 1 Default iocharset for FAT NEW Partition Types Advanced partition selection PC BIOS MSDOS partition tables support NEW Native Language Support iso8859 1 Default NLS Option Codepage 437 United States Canada Traditional Chinese charset Big5 NLS ISO 8859 1 Latin 1 Western European Languages NLS UT...

Page 78: ...nable USB automount on the RT305x platform make menuconfig Kernel Library Defaults Selection Customize Busybox Settings Linux System Utilities mdev Support etc mdev conf Support subdirs symlinks NEW Support command execution at device addition removal Customize Vendor User Settings Miscellaneous Applications ntfs 3g 11 19 How to enable software QoS To support the Ralink SW QoS many menuconfig opti...

Page 79: ...etely fit the requirement of Ralink SW QoS some changes are made in Linux Netfilter architecture For this changes a Ralink proprietary Netfilter option Netfilter Ralink SWQoS support is introduced This Ralink proprietary Netfilter option must be enabled to support Ralink SW QoS or the classification of IP address may not work properly If the Ralink SW QoS is not required of course it is recommende...

Page 80: ...rt DSCP match support helper match support length match support mac address match support state match support layer7 match support Ethernet port for incoming packets match support And Networking Networking support NET y Networking options Network packet filtering framework Netfilter NETFILTER y IP Netfilter Configuration IP tables support required for filtering masq NAT Packet mangling IMQ target ...

Page 81: ... many different types of classification rate limitation and DSCP remarking Ralink SoC SW QoS is based on the Linux Qdiscs TC and iptables Ralink SoC SW QoS supports download and upload stream on a WAN interface 11 20 2 Software QoS Concept The Ralink SoC SW QoS architecture is shown in the subsequent figure The Classifier module classifies incoming packets into the Shaper module The Shaper module ...

Page 82: ...Internet or download from Internet on the web UI to enable the Ralink SW QoS 2 Enter the upload and download bandwidth details to make a good fit with the user s network environment e g ADSL 512k 64k Cable Modem 10M 10M 3 Select a QoS model DRR Deficit Round Robin SPQ Strict Priority Queue DRR SPQ packets Shaper Classifier Remark packets N u k o p e n PDF XChange w w w easycomputing c o m N u k o ...

Page 83: ... classified into these four QoS groups according to the user s QoS rules settings The four QoS groups are subsequently shown The default group is the group named Default the third group that means the packet would be classified into this group if it doesn t match with any rules In each QoS group there are two attributes Rate and Ceil as shown in the subsequent figure N u k o p e n PDF XChange w w ...

Page 84: ...rity means the left available bandwidth will serve the group first but settings for guaranteed rate and ceil in every group are still met strictly For example people often hope VoIP traffic is classified as the highest priority group for short latency and good quality and P2P traffic to be classified as the lowest priority and background traffic Rules settings The QoS rules are made to do classifi...

Page 85: ...rs currently a SRC DSP IP address with netmask b Packet length c DSCP field d ICMP TCP UDP port range e Layer 7 content inspection 3 Rule Remarker This argument specifies what DSCP value would be added to the packet as a remark which matches the rule 11 21 How to enable USB Ethernet example for ASIX AX88XXX N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycom...

Page 86: ...and address 2 usb 1 1 Product USB2 0 usb 1 1 Manufacturer ASIX Elec Corp usb 1 1 SerialNumber 01 usb 1 1 configuration 1 chosen from 1 choice eth0 register asix at usb lm0 1 ASIX AX8817x USB 2 0 Ethernet 00 0e 2e 41 72 9e brctl addif br0 eth0 device eth0 entered promiscuous mode brctl show br0 bridge name bridge id STP enabled interfaces br0 8000 000c43414367 no ra0 eth2 1 eth0 ifconfig eth0 up AD...

Page 87: ... cd Uboot make menuconfig 128Mb DRAM Component 32bits DRAM Bus 8M Flash Size cd RT288x_SDK source make menuconfig Kernel Library Defaults Selection Customize Kernel Settings Machine selection 8M Flash Size cd RT288x_SDK tools single_img RT2880 vi Makefile 8M UBOOT_IMAGE rt2880_100phy_128Mbx16_8Mflash uboot KERNEL_IMAGE rt2880_100phy_128Mbx16_8Mflash linux PACKED_IMAGE rt2880_100phy_128Mbx16_8Mflas...

Page 88: ...0nd small printer daemon Step2 Plug in USB Printer usb 1 1 new full speed USB device using dwc_otg and address 2 usb 1 1 Product Officejet 4300 series usb 1 1 Manufacturer HP usb 1 1 SerialNumber CN864GZ1S004GR usb 1 1 configuration 1 chosen from 1 choice drivers usb class usblp c usblp0 USB Bidirectional printer dev 2 if 1 alt 0 proto 2 vid 0x03F0 pid 0x5411 Step3 run the printer daemon p910nd f ...

Page 89: ...RALINK AP SDK 3 3 0 0 User s Manual Page 89 of 93 N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 90: ...r 1 Force Mode Both RT305x and remote peer disable auto negotiation algorithm 10MB Full Set bit13 0 bit12 0 bit8 1 reg_addr 0 10MB Half Set bit13 0 bit12 0 bit8 0 reg_addr 0 100MB Full Set bit13 1 bit12 0 bit8 1 reg_addr 0 100MB Half Set bit13 1 bit12 0 bit8 0 reg_addr 0 N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 91: ...otiation algorithm 10MB Full Set bit6 1 reg_addr 4 10MB Half Set bit5 1 reg_addr 4 100MB Full Set bit8 1 reg_addr 4 100MB Half Set bit7 1 reg_addr 4 User Mode mii_mgr s p port_no r reg_addr v Value Kernel Space N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o m ...

Page 92: ...cation make menuconfig Kernel Library Defaults Selection Customize Vendor User Settings NEW Network Applications igmp proxy RFC4605 Step2 Enable IGMP Proxy in WebUI Step3 Install windows server 2003 resource kit tools in your PCs You can get the test application from the following link or Ralink SDK HTTP WWW MICROSOFT COM DOWNLOADS DETAILS ASPX FAMILYID 9D467A69 57FF 4A E7 96EE B18C4790CFFD DISPLA...

Page 93: ...rface to receive or send if you have multiple network interfaces Now you can see the multicast packets will be generated by Mcast Server Mcast Client1 C mcast GRPS 239 1 1 1 RECV Step5 Starting network sniffer on Client1 and Client2 The right behavior is only Client1 can receive multicast packets N u k o p e n PDF XChange w w w easycomputing c o m N u k o p e n PDF XChange w w w easycomputing c o ...