Digi Digi One EM Guide d'installation

Digi Connect® FamilyDigi Connect SP, Digi Connect Wi-SP, Digi Connect ME, Digi Connect Wi-ME, Digi Connect EM, Digi Connect Wi-EM, Digi Connect WAN, D

Basic Command Information10 Chapter 1 Introduction Entering Special Characters in String ValuesSeveral commands have options that are string values,

set permissions100 Chapter 2 Command Descriptions status={none|read|rw}Specifies permissions for the “status” command.noneThe command cannot be exec

set permissionsChapter 2 Command Descriptions 101Examples Set group permissionsset permissions type=group name=gurus newpass=rw-self s-user=readSet

set pmodem102 Chapter 2 Command Descriptions set pmodemDevices supportedThis command is not supported in Digi Connect WAN devices.Purpose Used to:•

set pmodemChapter 2 Command Descriptions 103telnetUsed to enable or disable Telnet processing on the incoming and outgoing modem-emulation connectio

set pppoutbound104 Chapter 2 Command Descriptions set pppoutboundDevices supportedThis command is supported in Digi Connect WAN and Digi Connect RG

set pppoutboundChapter 2 Command Descriptions 105Options port=rangeThe physical interface to which the PPP outbound configuration applies. Required.

set pppoutbound106 Chapter 2 Command Descriptions address_mask=ip_address_maskThe IP mask to apply to the address specified on the “remote address”

set pppoutboundChapter 2 Command Descriptions 107lcp_keepalive={on|off}Specifies whether the device server sends Link Control Protocol (LCP) echo re

set pppoutbound108 Chapter 2 Command Descriptions chap_id=chap_idA character string that identifies the outbound PPP user using CHAP authentication.

set pppoutboundChapter 2 Command Descriptions 109dial_script=chat_scriptA dialing script, used any time a number is dialed for the interface. For ex

Access the Command LineChapter 1 Introduction 11Access the Command LineTo configure devices using commands, you must first access the command line f

set profile110 Chapter 2 Command Descriptions set profileDevices supportedThis command is supported in all Digi Connect Family devices. However, som

set profileChapter 2 Command Descriptions 111Required permissionsTo use this command, permissions must be set to one of the following:• For a user t

set profile112 Chapter 2 Command Descriptions tunnelingAssociates the Serial Bridge port profile with the port. udp_socketsAssociates the UDP Socket

set rciserialChapter 2 Command Descriptions 113set rciserialDevices supportedThis command is supported in all Digi Connect Family devices. Purpose U

set rtstoggle114 Chapter 2 Command Descriptions set rtstoggleDevices supportedThis command is not supported in Digi Connect WAN devices. Purpose Use

set rtstoggleChapter 2 Command Descriptions 115predelay=delay Specifies the time in milliseconds to wait after the RTS signal is turned on before se

set serial116 Chapter 2 Command Descriptions set serialDevices supportedThis command is supported in all Digi Connect Family devices. Purpose Used t

set serialChapter 2 Command Descriptions 117csize={5|6|7|8}The character size, which can be 5, 6, 7, or 8 bits. The default is 8.flowcontrol={hardwa

set service118 Chapter 2 Command Descriptions set serviceDevices supportedThis command is supported in all Digi Connect Family devices. Purpose Used

set serviceChapter 2 Command Descriptions 119nodelay={on|off}Used to allow unacknowledged or smaller than maximum segment sized data to be sent. Not

Configure an IP Address12 Chapter 1 Introduction

set snmp120 Chapter 2 Command Descriptions set snmpDevices supportedThis command is supported in all Digi Connect Family devices. Purpose Configures

set snmpChapter 2 Command Descriptions 121authfailtrap={on|off}Enables or disables the sending of authentication failure traps.onEnables the sending

set system122 Chapter 2 Command Descriptions set systemDevices supportedThis command is supported in all Digi Connect Family devices. Purpose Config

set tcpserialChapter 2 Command Descriptions 123set tcpserialDevices supportedThis command is supported in all Digi Connect Family devices. Purpose U

set tcpserial124 Chapter 2 Command Descriptions Options port=rangeUsed to specify the serial port. Optional on a single-port device.hangupdcd={on|of

set tcpserialChapter 2 Command Descriptions 125endpattern=stringIndicates that data from the serial port should be sent out to the network after the

set term126 Chapter 2 Command Descriptions set termDevices supportedThis command is supported in Digi Connect WAN and Digi Connect RG devices only.

set udpserialChapter 2 Command Descriptions 127set udpserialDevices supportedThis command is not supported in Digi Connect WAN devices. Purpose Use

set udpserial128 Chapter 2 Command Descriptions Options Options for setting general UDP serial forwarding characteristicsport=rangeUsed to specify

set udpserialChapter 2 Command Descriptions 129sidstring=stringThe string sent at the beginning of each UDP packet if the “sid” option is set to on.

Verifying Device Support for CommandsChapter 2 Command Descriptions 13This chapter provides a description of each command in the Digi Connect Comman

set udpserial130 Chapter 2 Command Descriptions Examples Set general UDP serial forwarding based on bytes receivedIn this example, the amount of byt

set userChapter 2 Command Descriptions 131set userDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Used to:• Ad

set user132 Chapter 2 Command Descriptions Syntax Add a userset user add id=number newname=stringRemove a userset user remove {id=range|name=string}

set userChapter 2 Command Descriptions 133gid=numberSpecifies the identifier for the group being associated with a user. If omitted, the “gname” opt

set user134 Chapter 2 Command Descriptions defaultaccess={none|commandline|menu|group}Specifies the default access method and interface that a user

set userChapter 2 Command Descriptions 135Examples Add a new userset user add newname=jsmith id=4Remove user 7set user remove id=7Associate user “jo

set wlan136 Chapter 2 Command Descriptions set wlanDevices supportedThis command is supported in Digi Connect Wi-ME, Digi Connect Wi-EM, and Digi Co

set wlanChapter 2 Command Descriptions 137Authentication methods and associated data fieldsThe following table shows the authentication methods avai

set wlan138 Chapter 2 Command Descriptions Inner and outer protocolsThe following table shows relationships between outer protocols and inner protoc

set wlanChapter 2 Command Descriptions 139Syntax Configure wireless settingsset wlan [protmode={bss|ibss_create|ibss_join|any}] [channel={0|1-14}] [

backup14 Chapter 2 Command Descriptions backupDevices supported This command is supported in all Digi Connect Family devices.Purpose Use the backup

set wlan140 Chapter 2 Command Descriptions ssid=stringUsed to specify the identifier of the wireless network that the device should be joined to. Th

set wlanChapter 2 Command Descriptions 141encryption={[open],[wep],[tkip],[ccmp],[any]}The types of encryption that are allowed to encrypt data tran

set wlan142 Chapter 2 Command Descriptions inner_eap={[gtc],[md5],[mschapv2],[otp],[chap],[mschap],[ttls_mschapv2],[pap,[any]]}The types of protocol

set wlanChapter 2 Command Descriptions 143psk=stringUsed when the “security” option is set to “wpa_psk.” This option specifies a string that is conv

show144 Chapter 2 Command Descriptions showDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Displays the curren

showChapter 2 Command Descriptions 145port=rangeIdentifies a particular serial port. Optional on a single-port device.range=rangeA configuration tab

show146 Chapter 2 Command Descriptions Display current alarm settingsshow alarmDisplay settings for a particular usershow user range=3See also The “

statusChapter 2 Command Descriptions 147statusDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Displays the cur

telnet148 Chapter 2 Command Descriptions telnetDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Used to make an

whoChapter 2 Command Descriptions 149whoDevices supportedThis command is supported in all Digi Connect Family devices. Purpose Displays active conne

bootChapter 2 Command Descriptions 15bootDevices supportedThis command is supported in all Digi Connect Family devices.Purpose The boot command is u

who150 Chapter 2 Command Descriptions

What Is Modem Emulation?Chapter 3 Modem Emulation Commands 151This chapter describes the commands that can be issued when Digi devices are configure

Common User Scenarios for Modem Emulation152 Chapter 3 Modem Emulation Commands Common User Scenarios for Modem EmulationThe Digi device in modem em

Common User Scenarios for Modem EmulationChapter 3 Modem Emulation Commands 153In Diagram B, two Digi devices will replace modems on both sides of t

Connection Scenarios for Modem Emulation154 Chapter 3 Modem Emulation Commands Connection Scenarios for Modem EmulationModem emulation can involve t

About the Commands in this ChapterChapter 3 Modem Emulation Commands 155About the Commands in this ChapterThis chapter describes the Digi-specific m

Modem Emulation AT Command Set156 Chapter 3 Modem Emulation Commands Modem Emulation AT Command SetThe following commands can be issued to perform a

Modem Emulation AT Command SetChapter 3 Modem Emulation Commands 157ATOReturn to on-line data mode. If the modem is in the on-line command mode, the

Modem Emulation AT Command Set158 Chapter 3 Modem Emulation Commands AT&VDisplays current values and settings.• AT&V0- AT&V5: Displays S

S-Register DefinitionsChapter 3 Modem Emulation Commands 159S-Register DefinitionsFollowing is a description of the S-registers that can be set.Regi

boot16 Chapter 2 Command Descriptions Examples Restore configuration defaultsThis example reloads the firmware stored in flash ROM and resets the co

S-Register Definitions160 Chapter 3 Modem Emulation Commands S21General Options Status. Indicates the status of command options.• Default: 52 (34h)

Result CodesChapter 3 Modem Emulation Commands 161Result CodesFollowing is a description of the return codes returned by modem emulation commands.Sh

Result Codes162 Chapter 3 Modem Emulation Commands

Index 163Aabbreviating commands 9abort output signal 43access control 44newpass command 35set user 131status information 19add line feed characters 34

164 Indexdisplay buffers commanddescription21setting permissions for 88display commanddescription 19setting permissions for 89display current settings

Index 165NATSee Network Address Translationnavigation and editing keys9Network Address Translation (NAT)configuring 81status information 19network con

166 Indexservice table118services, enabling and disabling 118sessionsclosing17exiting 23killing 33reconnecting to 38status of 147Telnet 148set accessc

Index 167displaying current settings123, 145reverting settings 41setting permissions for 98set term commanddescription 126displaying current settings

168 Indexstatus information for19wireless Ethernet (wlan) table 25XXon/Xoff 117

closeChapter 2 Command Descriptions 17closeDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Closes active conne

connect18 Chapter 2 Command Descriptions connectDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Used to make a

displayChapter 2 Command Descriptions 19displayDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Use the display

 Digi International Inc. 2003, 2004, 2005. All Rights Reserved.Digi, Digi International, the Digi logo, the Digi Connectware logo, the Making Device

display20 Chapter 2 Command Descriptions nat Displays Network Address Table (NAT) status information.pppstatsDisplays Point-to-Point Protocol (PPP)

display buffersChapter 2 Command Descriptions 21display buffersDevices supportedThis command is supported in all Digi Connect devices except the Dig

display buffers22 Chapter 2 Command Descriptions Examples Display port buffering information on the screen display buffers port=2 screen lines=32 ta

exitChapter 2 Command Descriptions 23exitDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Use the exit command

help24 Chapter 2 Command Descriptions helpDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Displays help about

infoChapter 2 Command Descriptions 25infoDevices supportedThis command is supported in all Digi Connect Family devices.Purpose This command prints o

info26 Chapter 2 Command Descriptions Results Following are descriptions of the statistics displayed for each “info” command option.The statistics d

infoChapter 2 Command Descriptions 27Ethernet statisticsICMP statisticsStatistic DescriptionInBytes Number of bytes received.OutBytes Number of byte

info28 Chapter 2 Command Descriptions IP statisticsStatistic DescriptionInReceives Number of datagrams received.OutRequests Number of datagrams give

infoChapter 2 Command Descriptions 29Serial statisticsStatistic Descriptionrbytes Total data in: the number of bytes received.tbytes Total data out:

Contents 3Chapter 1 IntroductionQuick Reference for Configuring Features...6Basic Command Information ...

info30 Chapter 2 Command Descriptions TCP statisticsUDP statisticsStatistic DescriptionInSegments Number of segments received.OutSegments Number of

infoChapter 2 Command Descriptions 31Wireless (WLAN) statisticsThe WLAN statistics may aid in troubleshooting network communication problems with yo

info32 Chapter 2 Command Descriptions Examples Display ICMP statistics#> info icmpICMP statistics:InMessages : 14 OutMessa

killChapter 2 Command Descriptions 33killDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Use the kill command

mode34 Chapter 2 Command Descriptions modeDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Changes or displays

newpassChapter 2 Command Descriptions 35newpassDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Use the newpass

ping36 Chapter 2 Command Descriptions pingDevices supportedThis command is supported in all Digi Connect devices. Purpose Tests whether a host or ot

quitChapter 2 Command Descriptions 37quitDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Use the quit command

reconnect38 Chapter 2 Command Descriptions reconnectDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Reestablis

revertChapter 2 Command Descriptions 39revertDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Sets a particular

4 Contents set permissions...86set pmodem...

revert40 Chapter 2 Command Descriptions devicesecurityReverts the Connectware Device Protocol device security settings configured by the “set device

revertChapter 2 Command Descriptions 41systemReverts the system settings configured by the “set system” command.tcpserial [port=range]Reverts the TC

rlogin42 Chapter 2 Command Descriptions rloginDevices supportedThis command is supported in all Digi Connect devices. Purpose Performs a login to a

sendChapter 2 Command Descriptions 43sendDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Sends a Telnet contro

set accesscontrol44 Chapter 2 Command Descriptions set accesscontrolDevices supportedThis command is supported in Digi Connect WAN and Digi Connect

set accesscontrolChapter 2 Command Descriptions 45subnip[1-32]=ipaddressUsed to specify up to 32 subnet IP addresses. Any IP address in these subnet

set alarm46 Chapter 2 Command Descriptions set alarmDevices supportedDigi Connect EM, Digi Connect Wi-EM, Digi Connect ME, Digi Connect Wi-ME, Digi

set alarmChapter 2 Command Descriptions 47Options Options for setting alarms with general optionsfrom=stringThe text to be included in the “from” fi

set alarm48 Chapter 2 Command Descriptions priority={normal|high}The priority of the triggered email.normalThe email is sent with normal priority.hi

set alarmChapter 2 Command Descriptions 49Options for setting alarms in GPIO modeIn GPIO mode, alarms are triggered when there are transitions betwe

Chapter 1 Introduction 5This chapter provides the following:• A quick reference showing the commands used to configure features or perform configura

set alarm50 Chapter 2 Command Descriptions Options for setting alarms in match modeIn match mode, an alarm will be triggered when a pattern is found

set autoconnectChapter 2 Command Descriptions 51set autoconnectDevices supportedThis command is supported in all Digi Connect Family devices.Purpose

set autoconnect52 Chapter 2 Command Descriptions Options port=rangeUsed to specify the serial port. Optional on a single-port device.state={on|off}E

set autoconnectChapter 2 Command Descriptions 53description=stringA name for descriptive purposes only.ipaddress=ipaddressThe IP address of the netw

set autoconnect54 Chapter 2 Command Descriptions Examples Set autoconnect on with triggerThis example shows setting autoconnect to connect to the TC

set bufferChapter 2 Command Descriptions 55set bufferDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Configure

set buffer56 Chapter 2 Command Descriptions stateThe buffering state, which can be any of the following:onThe data will be buffered.offThe data will

set devicesecurityChapter 2 Command Descriptions 57set devicesecurityDevices supportedThis command is supported in all Digi Connect Family devices.

set devicesecurity58 Chapter 2 Command Descriptions discoverycodingscheme={nonenone|aesmd5|nonemd5}Used to specify the method of encryption used dur

set devicesecurityChapter 2 Command Descriptions 59keyencryptingkey=hexstringThis key is a shared secret between the device server and Connectware M

Quick Reference for Configuring Features6 Chapter 1 Introduction Quick Reference for Configuring FeaturesThe following table shows common features t

set ethernet60 Chapter 2 Command Descriptions set ethernetDevices supportedThis command is supported in Digi Connect SP, Digi Connect EM, and Connec

set ethernetChapter 2 Command Descriptions 61speedConfigures the Ethernet speed the Digi device will use on the Ethernet network. Specify an appropr

set forwarding62 Chapter 2 Command Descriptions set forwardingDevices supportedThis command is supported in Digi Connect WAN devices only. Purpose E

set gpioChapter 2 Command Descriptions 63set gpioDevices supportedThis command is supported Digi Connect EM, Digi Connect Wi-EM, Digi Connect ME, Di

set gpio64 Chapter 2 Command Descriptions Default serial signal settings for GPIO pinsThe default serial signal settings for the GPIO pins on a Digi

set groupChapter 2 Command Descriptions 65set groupDevices supportedThis command is supported in Digi Connect WAN and Digi Connect RG devices only.P

set group66 Chapter 2 Command Descriptions name= stringSpecifies the name of the group to be acted on.newname=stringSpecifies a new group name.comma

set groupChapter 2 Command Descriptions 67Default permissions When a new group is created, it has no permissions.Examples Add a new groupset group a

set host68 Chapter 2 Command Descriptions set hostDevice support This command is supported in all Digi Connect Family devices.Purpose Configures a n

set menuChapter 2 Command Descriptions 69set menuDevices supportedThis command is currently not supported in any Digi Connect Family devices. Purpos

Quick Reference for Configuring FeaturesChapter 1 Introduction 7Modem emulation "set pmodem" on page 102"set serial" on page 116

set menu70 Chapter 2 Command Descriptions previous_key=keyThe key and text displayed on the custom menu next to the “previous_label” that allows a u

set menuChapter 2 Command Descriptions 71title=stringsubtitle=stringThe title and optional subtitle for a particular menu. The title is displayed ab

set menu72 Chapter 2 Command Descriptions Options for Adding/Updating Custom Menu Itemsrange=1-32The index of the custom menu to add menu items to.

set menuChapter 2 Command Descriptions 73Examples Updating Global Settingsset menu quit_key=Q quit_label=”Quit” previous_key=Rprevious_label=”Return

set mgmtconnection74 Chapter 2 Command Descriptions set mgmtconnectionDevices supportedThis command is supported in all Digi Connect Family devices.

set mgmtconnectionChapter 2 Command Descriptions 75timedperiod=periodFor a timed connection, this option is used to specify the time interval in min

set mgmtconnection76 Chapter 2 Command Descriptions Examples Set values for the client connectionset mgmtconnection connenabled=on conntype=client c

set mgmtglobalChapter 2 Command Descriptions 77set mgmtglobalDevices supportedThis command is supported in all Digi Connect Family devices. Purpose

set mgmtnetwork78 Chapter 2 Command Descriptions set mgmtnetworkDevices supportedThis command is supported in all Digi Connect Family devices. Purpo

set mgmtnetworkChapter 2 Command Descriptions 79connectionmethod={auto|none|mt|mdh|proxy}Used to specify the Connectware Device Protocol firewall tr

Quick Reference for Configuring Features8 Chapter 1 Introduction Security and access permissions • To change user name for a user: "set user&qu

set mgmtnetwork80 Chapter 2 Command Descriptions mtwaitcount=countUsed to specify the wait count when connection method is MT.mdhrxkeepalive=timeUse

set natChapter 2 Command Descriptions 81set natDevices supportedThis command is supported in Digi Connect WAN devices only.Purpose Used to set or di

set nat82 Chapter 2 Command Descriptions prnumber[1-4]=greUsed to specify the IP protocol whose packets will be forwarded for this entry. The keywor

set natChapter 2 Command Descriptions 83Examples Enable NAT and specify settings for port forwarding entry 1This example command will enable the for

set network84 Chapter 2 Command Descriptions set networkDevices supportedThis command is supported in all Digi Connect Family devices.Purpose Used t

set networkChapter 2 Command Descriptions 85IP address, gateway address, and submask. The default is on.autoip={on|off}When enabled, the device atte

set permissions86 Chapter 2 Command Descriptions set permissionsDevices supportedThis command is supported in all Digi Connect Family devices. Howev

set permissionsChapter 2 Command Descriptions 87Syntax Set permissionsset permissions [type={user|group}] {id=range|name=string} [backup={none|execu

set permissions88 Chapter 2 Command Descriptions Options type={user|group}Specifies whether the command applies to users or groups. This option defa

set permissionsChapter 2 Command Descriptions 89connect={none|execute}Specifies permissions for the “connect” command.noneThe command cannot be exec

Basic Command InformationChapter 1 Introduction 9Basic Command InformationNavigation and Editing KeysUse the keys listed in the table to navigate th

set permissions90 Chapter 2 Command Descriptions revert-all={none|execute}Specifies permissions for the “revert all” command. Individual “revert” co

set permissionsChapter 2 Command Descriptions 91s-autoconnect={none|r-self|read|rw-self|w-self-r|rw}Specifies permissions for the “set autoconnect”

set permissions92 Chapter 2 Command Descriptions s-gpio={none|read|rw}Specifies permissions for the “set gpio” command.noneThe command cannot be exe

set permissionsChapter 2 Command Descriptions 93s-mgmtglobal={none|read|rw}Specifies permissions for the “set mgmtglobal” command.noneThe command ca

set permissions94 Chapter 2 Command Descriptions s-pmodem={none|r-self|read|rw-self|w-self-r|rw}Specifies permissions for the “set pmodem” command.n

set permissionsChapter 2 Command Descriptions 95s-profile={none|r-self|read|rw-self|w-self-r|rw}Specifies permissions for the “set profile” command.

set permissions96 Chapter 2 Command Descriptions s-rtstoggle={none|r-self|read|rw-self|w-self-r|rw}Specifies permissions for the “set rtstoggle” com

set permissionsChapter 2 Command Descriptions 97s-service={none|read|rw}Specifies permissions for the “set service” command.noneThe command cannot b

set permissions98 Chapter 2 Command Descriptions s-tcpserial={none|r-self|read|rw-self|w-self-r|rw}Specifies permissions for the “set tcpserial” com

set permissionsChapter 2 Command Descriptions 99s-udpserial={none|r-self|read|rw-self|w-self-r|rw}Specifies permissions for the “set udpserial” comm