2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
4 * This component and the accompanying materials are made available
5 * under the terms of "Eclipse Public License v1.0"
6 * which accompanies this distribution, and is available
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
9 * Initial Contributors:
10 * Nokia Corporation - initial contribution.
17 HOWTO for Wins Ethernet Driver
20 The implementation of Wins Ethernet driver makes use of packet capturing library:
21 WinPcap, Release 2.2. This software sets the network card of the PC, on which Epoc
22 Emulator is working, into so called promiscuous mode. The user must be confident that
23 the environment she/he works in doesn’t forbid such settings. The quickest way
24 to ensure about it is to contact network administrator.
28 The following problems may occur when attempting to use WINS version of Ethernet driver:
29 * Network application doesn’t send nor receive any packets: two potential reasons:
30 - bad settings in CommDB - refer to point 4
31 - Wpcap not installed - refer to point 2
33 * A panic is raised of category: 'D32ETHER' with one of the following reasons:
34 1 meaning: bad MAC address in ini file or entry for it missing or ini file missing
35 2 meaning: entry for network interface name missing in ini file or ini file missing
36 3 meaning: Wpcap couldn't be initialised - potentially not installed or name
37 of network interface in .ini file wrong
38 Panics occur if system is not configured properly, remedy can be found in notes below.
40 * Wpcap error may occur - refer to http://winpcap.polito.it/misc/changelog.htm
41 for advice how to fix the problem (this will require usually upgrading WinPcap
42 package on user'’ machine).
46 Wpcap must be installed on a machine that wishes to use driver. Installation is simple:
47 WinPcap.exe (located in: \epoc32\tools)
48 should be run and then instructions should be followed.
49 If user has already Wpcap installed on his workstation then should try to use
50 Ethernet driver with this version. In case when it fails he must uninstall existing
51 Wpcap and install the one from Epoc directory mentioned above.
55 When Wpcap is already installed, a program called Netcards.exe should be run.
56 It can be found in \epoc32\tools.
57 (Note: Netcards uses Wpcap so the latter must be installed first).
58 It will request user to select network card. Netcards writes a few entries
59 into \epoc32\data\ethernet.ini file which are read by Epoc Emulator at startup
60 (ensure that \epoc32\data directory exists). In particular MAC address value for use
61 by Emulator is determined by the entry named 'ETHER_MAC' (it is recommended that
62 network administrator was aware of the value of MAC address written there and authorise
63 it if necessary; according to local conditions any other value preferred
64 by administrator can be written manually instead of the value written by Netcards).
65 Ethernet driver for WINS was originally
66 designed for use in Techview environment which uses ethernet.ini file. Other environments
67 (like Quartz) may use different .ini file (e.g. \epoc32\data\quartz.ini). A user can
68 still run Ethernet module in these environments provided that .ini files appropriate
69 for these environments contain entries written by netcards.exe to ethernet.ini - user can
70 simply copy them - they are easy to recognise as they begin with ‘ETHER_‘ prefix .
74 CommDB settings should indicate use of the NIF: ethint.nif and the agent: nullagt.agt.
75 In current release of Epoc Networking software, data in the database are written by program
76 called ced.exe, which takes wanted settings from text file: ced.cfg.
77 Example settings to be put in this file are shown below. In the example it is assumed
78 that IP address and network mask will be acquired by DHCP protocol:
80 ############################################################
93 PacketDriverName=EtherPkt.drv
94 LastSocketActivityTimeout=-1
95 LastSessionClosedTimeout=-1
96 LastSocketClosedTimeout=-1
102 Name=Assabet on-board Ethernet
108 PDDName=Ethernet.Assabet
109 PacketDriverName=EtherPkt.drv
110 LastSocketActivityTimeout=-1
111 LastSessionClosedTimeout=-1
112 LastSocketClosedTimeout=-1
116 ############################################################
128 IpAddrFromServer=TRUE
130 IpDNSAddrFromServer=TRUE
131 IpNameServer1=0.0.0.0
132 IpNameServer2=0.0.0.0
137 ############################################################
145 IAPServiceType=LANService
147 IAPBearerType=LANBearer
149 IAPNetworkWeighting=0
156 Name=NT RAS with Null Modem
158 IAPServiceType=DialOutISP
160 IAPBearerType=ModemBearer
162 IAPNetworkWeighting=0
167 ############################################################
168 ## ConnectionPreferences
170 [ConnectionPreferences]
186 DialogPref=DONOTPROMPT