NETGEAR KWGR614 - 54 Mbps Wireless Router Manual de usuario

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:

•Flash: 4MB

•SDRAM: 16MB

Memory usage of the latest router firmware:

•Flash: 2MB used = 1,804KB (router firmware V1.0.1-10.17WW) + 192KB

(Bootloader + BoardInfo + POT + Configuration)

•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/re865x/rtl865x

DHCP

server/client udhcpd/udhcpc of

Busybox V1.00-pre2 0.9.10 user/busybox/networking/udhcp

DNS Proxy Dnrd 2.17.2 user/dnrd-dnshijack

Dynamic DNS ez-ipupdate 3.0.11b7 user/ez-ipupdate-3.0.11b7

Web Server BOA 0.94 user/boa

Telstra's Big

Pond Bpalogin V2.0 user/bpalogin

Email Smtpclient 1.0.0 user/smtpclient

Schedule Crond of Busybox V1.00-

pre2 1.0.0 user/busybox/miscutils/crond.c

PPP/PPPoE Pppd 2.3.8 user/pppd

PPTP Client pptp-client 1.3.1 user/pptp-client

Wireless driver Copyright Realtek 1.12 linux-

2.4.x/drivers/net/wireless/rtl8185

L2TP l2tpd 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.

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, 1 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.

The pin-out of J303 on the KWGR614 board is as follows:

•Pin 1: VDDH (3.3V)

•Pin 2: TxD

•Pin 3: RxD

•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 correctly 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:

oKWGR614_README.txt (the OpenSource User Guide)

oKWGR614_V1.0.1_10.17WW_src.tar.bz2

otoolchain_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 -> V1.0.1_10.17WW (xxx denotes the

version number.)

We recommend that you read the following documents in this directory before you

proceed.

•/vendors/Documentation/KWGR614_README.txt

•/SOURCE

•/README

•/Documentation/Adding-User-Apps-HOWTO

•/Documentation/Addid-Platforms-HOWTO

4. Install the Tool chain in the root directory by typing:

# cd/

mkdir uclibc

# cd uclibc

# tar jxvf toolchain_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 --->

[ * ] 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.

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

Note: You can remove the country suffix from the version string by redefining

EXTENSION.

user/dni/nvram_realtek.c

New NVRAM Parameters

1. Define the structure of the parameter.

user/boa/src/rtl865x/board.h

2. Add the new parameter to the main parameter structure to include it in the

configuration set.

user/boa/src/rtl865x/board.h

#define OS_VERSION “V1.01.01 Custom”

#if 1

#ifdef EXTENSION

#undef EXTENSION

#endif

#define EXTENSION “”

#endif

typedef struct romeCfgParam_s

{

. . .

exampleParam_t exampleParam;

} romeCfgParam_t;

#define MAX_QUESTION_LENGTH 64

typedef struct exampleParam_s

{

char question[MAX_QUESTION_LENGTH];

int answer;

} exampleParam_t;

3. Create get/set functions for the parameter.

user/dniutil/nvram_realtek.c

4. Add the get/set handlers to the NVRAM handler table.

user/dniutil/nvram_realtek.c

char *

nvram_get_example_question (char *name)

{

DPRINTF("nvram_get(\"%s\")\n", name);

sprintf(str, "%s", pRomeCfgParam->exampleParam.question);

return (str);

}

int

nvram_set_example_question(char *name, char *value)

{

DPRINTF("nvram_set(\"%s\", \"%s\")\n", name, value);

strncpy(pRomeCfgParam->exampleParam.question, value, \

sizeof(pRomeCfgParam->exampleParam.question));

return 1;

}

char *

nvram_get_example_answer (char *name)

{

DPRINTF("nvram_get(\"%s\")\n", name);

sprintf(str, "%d", pRomeCfgParam->exampleParam.answer);

return (str);

}

int

nvram_set_example_question(char *name, char *value)

{

DPRINTF("nvram_set(\"%s\", \"%s\")\n", name, value);

pRomeCfgParam->exampleParam.answer = atoi(value);

return 1;

}

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},

{ NULL, NULL, NULL },

};

5. Declare an instance of the parameter for runtime memory use.

user/boa/src/dni/board.c

6. Define default values for the parameter.

user/boa/src/dni/board.c

7. Define the initialization function.

user/boa/src/dni/board.c

// nvram example

exampleParam_t exampleParamDefault[1] =

{

"What is the meaning of life, the universe, and

everything?",

}

};

exampleParam_t ramExampleParam; //nvram example

uint32 example_init(void)

{

/* read cfg from cfgmgr */

if (cfgmgr_read(CFGMGR_TABID_EXAMPLE, \

(void*)&(pRomeCfgParam->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 to system initialization.

user/boa/src/dni/board.c

9. Add an ID to the configuration management table and to the control table.

user/boa/src/rtl865x/rtl_board.h

user/boa/src/dni/board.c

10. Create a save function for the parameter.

user/boa/src/dni/board.c

static _board_cfgmgr_ctrl_t _board_cfgmgr_ctrlTbl[CFGMGR_TABID_MAX+1]

{

. . .

{CFGMGR_TABID_EXAMPLE, exampleParamDefault,

(sizeof(exampleParamDefault))},

{CFGMGR_TABID_MAX, NULL, 0}

};

enum _board_cfgmgr_tabId_e {

. . .

CFGMGR_TABID_EXAMPLE,

CFGMGR_TABID_MAX

};

uint32 sysInit(void)

{

. . .

/* init nvram example */

example_init();

. . .

} /* end sysInit */

Otros manuales para KWGR614 - 54 Mbps Wireless Router

Otros manuales de Enrutador inalámbrico de NETGEAR

NETGEAR

NETGEAR Zing Manual de usuario

NETGEAR

NETGEAR WNHD3004 - High Performance Wireless-N HD Home Theatre... Manual de usuario

NETGEAR

NETGEAR WNDR3700 - RangeMax Dual Band Wireless-N Gigabit Router... Manual de usuario

NETGEAR

NETGEAR (LG2200D Manual de usuario

NETGEAR

NETGEAR Nighthawk X4S Manual de usuario

NETGEAR

NETGEAR DGN2200M - Wireless-N 300 Router Manual de usuario

NETGEAR

NETGEAR R7800 Manual de usuario

NETGEAR

NETGEAR RangeMax NEXT WNR854T Guía del usuario

NETGEAR

NETGEAR DGN2200-100NAS Manual de usuario

NETGEAR

NETGEAR WGT634U Manual de usuario

NETGEAR

NETGEAR WNDR3700v4 Manual de usuario

NETGEAR

NETGEAR Nighthawk C6900 Manual de usuario

NETGEAR

NETGEAR MBR1210 Manual de usuario

NETGEAR

NETGEAR WGM124 Manual de usuario

NETGEAR

NETGEAR Orbi AX3000 Instrucciones de instalación

NETGEAR

NETGEAR WNDR3400v3 Manual de usuario

NETGEAR

NETGEAR C3700 Manual de usuario

NETGEAR

NETGEAR N300 Manual de usuario

NETGEAR

NETGEAR RBK50-100PES ORBI Manual de usuario

NETGEAR

NETGEAR WPN824v1 - RangeMax Wireless Router Manual de operación

NETGEAR

NETGEAR N450 Manual de usuario

NETGEAR

NETGEAR MR1100ATT Manual de usuario

NETGEAR

NETGEAR R6250 Manual de usuario

NETGEAR

NETGEAR R6220 Manual de usuario

Manuales populares de Enrutador inalámbrico de otras marcas

Milesight

Milesight UG67 Manual de usuario

Airlogic

Airlogic AirSync Class 1 Manual del propietario

Samsung

Samsung WCH730B Manual de usuario

TELEFONICA

TELEFONICA USB Adapter Manual de usuario

Askey

Askey RAC2V1K Manual de usuario

Alloy

Alloy WLF2454AP-S Manual de usuario

TP-Link

TP-Link TL-WR542G Manual de usuario

Hama

Hama 53120 Manual de usuario

Intellinet

Intellinet 524582 Manual de usuario

Asus

Asus RT-N10P Manual de usuario

D-Link

D-Link DIR-506L Manual de usuario

Sapido

Sapido GR297n Manual de usuario

Asus

Asus DSL-N55U Manual de usuario

AMTC

AMTC WR7502 Manual de usuario

Compaq

Compaq CP-2W - iPAQ Connection Point Manual de usuario

SMC Networks

SMC Networks WBR14-N2 FICHE Manual de usuario

Draytek

Draytek Vigor2120 Series Manual de usuario

Sitecom

Sitecom WLR-4000 Manual de usuario