Netgear KWGR614 User's Manual
Contents
1. Dynamic DNS ez ipupdate 3 0 11b7 user ez ipupdate 3 0 11b7 Web Server BOA 0 94 user boa UPNP Copyright 2005 DNI 1 0 0 user upnp Telstra s Big Bpalogin V2 0 user bpalogin Pond Email Smtpclient 1 0 0 user smtpclient Schedule Crond of Busybox V1 00 1 0 0 user busybox miscutils crond c pre2 PPP PPPoE Pppd 2 3 8 user pppd PPTP Client pptp client kal user pptp client Ntpclient Copyright 2005 DNI 1 0 0 user ntpclient Miscellaneous Copyright 2005 DNI 1 0 0 user dniutil user init Wireless driver Copyright Realtek Piles linux 2 4 x drivers net wireless rtl8 185 L2TP 12tpd 0 69 user l2tpd Iptables iptables 1 2 7a user iptables Making a Console Debug Interface for the KWGR614 Router This section provides instructions on how to make a console interface to a NETGEAR KWGR614 wireless router for the developer s firmware development and debugging The following example schematic illustrates using a MAX3232 the RS 232 Line Driver Receiver from Texas Instruments TI to make a console board You can download a datasheet for the MAX3232 from the Texas Instruments website at http focus ti com lit ds symlink max3232 pdf DB 9 lt DCE RxD URAD le R1IOUT RIIN 18 Male connector aoe j RZOUT R2IN gt RxD 1 gt TxD UTxD Hn nor Gi gt DCE TxD gt 26 5 1 toe2. Setting the Version String Set your custom version string in the file user dni nvram_realtek c by defining OS_VERSION Be certain to remove any duplicate definition user dni nvram_realtek c define OS VERSION V1 01 01 Custom Note You can remove the country suffix from the version string by redefining EXTENSION user dni nvram_realtek c if 1 ifdef EXTENSION undef EXTENSION fendif define EXTENSION W endif New NVRAM Parameters 1 Define the structure of the parameter user boa src rt1865x board h define MAX_QUESTION_LENGTH 64 typedef struct exampleParam_s char question MAX_QUESTION_LENGTH int answer exampleParam_t 2 Add the new parameter to the main parameter structure to include it in the configuration set user boa src rtl1865x board h typedef struct romeCfgParam_s exampleParam_t exampleParam romeCfgParam_t 3 Create get set functions for the parameter user dniutil nvram_realtek c ist nvram_get_example_question char name DPRINTF nvram_get s n name sprintf str Ss pRomeCfgParam gt exampleParam question return str t_example_question char name char value DPRINTF nvram_set s Ss n name value strncpy pRomeCfgParam gt exampleParam question value sizeof pRomeCfgParam gt exampleParam question return 1 Chat nvram_get_example_answ
3. lt link rel stylesheet href help css gt lt head gt lt body bgcolor 0099cc gt lt hl gt Example Help lt h1 gt lt p gt This is an example web page showing how to get a parameter from nvram lt body gt lt html gt Add a link to the Admin page menu by editing the contents file and including a reference to the new web page user boa src www_WW contents1l html lt table gt lt td valign top gt lt img src img redbullet gif alt width 7 height 7 gt lt td gt SEOS Kal Ince Yereimno lS ALN target formframe gt Example lt a gt lt td gt Lf ERS Device Recovery Procedure If the uploaded firmware crashes the router use the procedure in this section for device recovery 1 Power off the unit 2 Press and hold the RESET button on the rear panel 3 Power on to reboot the unit 4 Monitor the Test LED and keep holding the RESET button until the Test LED changes from blinking to steady ON which means the boot loader has entered the TFTP recovery mode 5 Connect the PC configured with static IP address 192 168 1 x to the LAN port of the unit 6 Transmit the working firmware image file to the unit the firmware can be downloaded from Netgear support website o For a Windows PC type the DOS command tftp i 192 168 1 1 PUT KWGR614_XXX bix o Fora Linux PC type the command tftp m binary 192 168 1 1 c put KWGR614_XXX bix where 192 168 1 1 is the
4. to system initialization user boa src dni board c uint32 sysInit void init nvram example example_init E fs Give yea 9 Add an ID to the configuration management table and to the control table user boa src rtl1865x rtl_board h enum _board_cfgmgr_tabId_e CFGMGR_TABID_EXAMPLI CFGMGR_TABID_MAX user boa src dni board c static _board_cfgmgr_ctrl_t _board_cfgmgr_ctriTbl CFGMGR_TABID_MAX 1 CFGMGR_TABID_EXAMPLE exampleParamDefault sizeof exampleParamDefault CFGMGR_TABID_MAX NULL 0 10 Create a save function for the parameter user boa src dni board c example_cfg_save void cfgmgr_write CFGMGR_TABID_EXAMPLE void amp pRomeCfgParam gt exampleParam sizeof exampleParam_t crhomgmmcasia y return 1 11 Add the parameter to the NVRAM commit function user boa src dni board c int nvram_commit void cfgmgr_write CFGMGR_TABID_EXAMPLE void amp pRomeCfgParam gt exampleParam sizeof exampleParam_t nec imieie eevee 6 return 1 12 Clean and rebuild userspace after any changes to board h At the shell prompt type work gt cd user make clean cd make Web Page Integration The boa web server is used Custom web pages are integrated at user boa src www_WW 1 Create the main page in the above directory Use lt nvram_get variable name gt to in
5. N E T G E A R Application Note OpenSource User Guide for OpenSource Wireless G Router KWGR614 Summary This document provides further product information for open source developers who are interested in using this platform to develop their customization applications WARNING Opening the router housing or putting in any customer software on the router will void the warranty on your router Specifications This section describes the hardware memory specifications and the module and software specifications for the OpenSource Wireless G Router KWGR614 Hardware Memory Specifications Total memory e Flash 4MB e SDRAM 16MB Memory usage of the latest router firmware e Flash 2MB used 1 804KB router firmware V1 0 1 10 17WW 192KB Bootloader BoardInfo POT Configuration e SDRAM about 8 5MB without including the dynamic memory allocation Module and Software Specifications The following table lists the functional modules of the KWGR614 router and the source and versions of the different modules You can find more information on these functional modules directly from the source of the packages Module Package Version Location directory NAT NAPT RomeDriver Realtek 3 6 3 linux 2 4 x drivers net re865 x rtl865x RIPv1 RIPv2 Copyright 2005 DNI 1 0 0 user ripd DHCP udhcpd udhcpc of 0 9 10 user busybox networking udhcp server client Busybox V1 00 pre2 DNS Proxy Dnrd PA RP user dnrd dnshijack
6. er char name DPRINTF nvram_get s n name sprintf str Sd pRomeCfgParam gt exampleParam answer Pevine Mere INE nvram_set_example_question char name char value DPRINTF nvram_set Ss Ss n name value pRomeCfgParam gt exampleParam answer atoi value return 1 4 Add the get set handlers to the NVRAM handler table user dniutil nvram_realtek c struct ej_nvram_handler nvram_handlers example_question nvram_get_example_question nvram_set_example_question example_answer nvram_get_example_answer nvram_set_example_answer NUL NULL NULG he 5 Declare an instance of the parameter for runtime memory use user boa src dni board c exampleParam_t ramExampleParam nvram example 6 Define default values for the parameter user boa src dni board c nvram example exampleParam_t exampleParamDefault 1 What is the meaning of life the universe and everything 42 7 Define the initialization function user boa src dni board c uint32 example_init void vead cfg from cfgmgr if cfgmgr_read CFGMGR_TABID_EXAMPLE void amp pRomeCfgParam gt exampleParam sizeof struct exampleParam_t 0 printf example_init call cfgmgr_read fail n take proper actions return NOT_OK printf example_init n return OK end example_init 8 Add the function
7. hain_mips_20050831 tar bz2 mv toolchain_mips pv 0831 toolchain_mips Note Root user permissions may be required to create the uclibc directory and install the tool chain into the root directory of the file system 5 Compile a Change the working directory to KWGR614_xxx b Type make menuconfig and customize your kernel config options as follows Target Platform Selection gt Customize Kernel Settings NEW Exit Exit Save configuration yes Exit Save configuration yes Note If you are building runtime image for the first time be sure to save the configuration when leaving make menuconfig even if no change is made to the default settings c Type make dep d Optional If you need to customize busybox go to KWGR614_xxx user busybox and type make menuconfig to select the user level application you need Then go back to KWGR614_xxx and type make dep again This updates all dependencies 6 Type make This builds the kernel user apps and create image file run bix under KWGR614_xxx images directory After compiling and linking the existing source code already provided you can now upload the KWGR614_xxx images run bix file directly to the router after connecting the router to your PC and using the Router firmware Upgrade page on the Router Web GUI Developing Custom Applications on the OpenSource Router This section describes how to develop custom applications on this router
8. rrectly to the corresponding pins of J303 on the router board Source Code and Executable This section describes the steps and procedures that are required to download the source code install the toolchain compile and link the existing source code and develop the user applications for the KWGR614 Router Note The procedures in this guide were performed on Suse Linux 10 1 1 Download KWGR614_V1 0 1_10 17WW_gpl_package zip from the NETGEAR Open Source web site at http kbserver netgear com kb_web_files open_src asp Note V1 0 1_10 17 is the firmware version number WW denotes Worldwide You can download other versions of this document for example North America NA 2 Unzip KWGR614_V1 0 1_10 17WW_gpl_package zip or the version you downloaded The zip file contains the following files o KWGR614_README txt the OpenSource User Guide o KWGR614_V1 0 1_10 17WW_src tar bz2 o toolchain_mips_20050831 tar bz2 3 Unpack the source code in tar xvf KWGR614_V1 0 1_10 17WW_src tar bz2 This creates a sub directory KWGR614_xxx xxx gt V1 0 1_10 17WW xxx denotes the version number We recommend that you read the following documents in this directory before you proceed e vendors Documentation KWGR614_README txt e SOURCE e README e Documentation Adding User Apps HOWTO e Documentation Addid Platforms HOWTO 4 Install the Tool chain in the root directory by typing cd mkdir uclibc cd uclibc tar jxvf toolc
9. sert the value of an NVRAM variable user boa src www_WW example html html gt head gt lt lt lt meta http equiv content type content text html charset ISO 8859 WS lt lt lt ETA http equiv Pragma CONTENT no cache gt ETA HTTP EQUIV Cache Control CONTENT no cache gt title gt Router Customization Example lt title gt lt link rel stylesheet href forml css type text css gt lt script language javascript type text javascript gt lt hide script from old browsers function loadhelp fname if top helpframe null top helpframe location href help help fname html i f gt lt script gt lt head gt lt body bgcolor ffffff leftmargin 0 topmargin 0 marginwidth 0 marginheight 0 onload loadhelp _example gt Q lt nvram_get example_question gt lt br gt A lt nvram_get example_answer gt lt body gt lt html gt 2 Create the help file in the help directory Name the file the same as the main page with a help_ prefix user boa src www_WW help help_example html html gt head gt ETA name description content KWGR614 gt lt lt lt lt META http equiv Content Type content text html charset iso 8859 il lt lt lt ETA http equiv Pragma content no cache gt ETA HTTP equiv Cache Control content no cache gt title gt Help lt title gt
10. unit s LAN IP address and KWGR614_XXX bix is the firmware image file to transmit 7 Monitor the Test LED When it starts blinking the recovery procedure is complete 8 Power cycle to reboot KWGR614 Note Repeat the above steps if the procedure is interrupted or fails Conclusion This guide provides information including the hardware memory spec the software modules the console interface for code debugging and development guide for building the source code the example program and the device recovery procedure For further info please contact Netgear customer support WARNING Opening the router housing or putting in any customer software on the router will void the warranty on your router January 16 2007 Copyright 2007 NETGEAR
11. x12 TaN Tour H x xP elas 01u 1 2 J Ses 1303 ayee VTE Tin 3 1 on the oii l a GNE 5 router board 5 1 dle yeg H BY 6S ano HS Sb To the MAX3232CPWR SS OU Console Terminal KWGR614 Console Interface Note The DB9 male connector is wired as a DCE think of this as a peripheral serial port and can be connected directly to the serial port on a host PC This gives you access to the built in serial console on the router using the protocol of 38400bps 8 data bits none parity stop bit without flow control To make a console debug interface for the KWGR614 router Connect the console board to the pin header J303 on the router board wos _ Yeas Tipe of Ja GE Jam mamn uaa E C oe Ai Pin 1 h 4 amp a lot gp g 5 pe ROEE saf East Hog Qrun 5 aii 8 eq EEEN a Scns A g g Orma Ai b a 351 rm O The pin out of J303 on the KWGR614 board is as follows 6420 Jp am u L W5 mrm ons e Pin 1 VDDH 3 3V e Pin 2 TxD e Pin 3 RxD e Pin 4 GND Ground There are third party vendors who provide compatible console boards such as the AD233AK AD233BK RS232 adapter kits at http www compsys1 com workbench On_top_of_the_Bench Max233_Adapter max233 adapter html Make sure the third party adapter board is connected co
Download Pdf Manuals
Related Search