- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
04-GPON VoIP commands | 123.92 KB |
GPON VoIP commands
Basic GPON VoIP commands
display pon iad
Use display pon iad to display information about the IAD module on an ONU.
Syntax
display pon iad interface interface-type interface-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type, which can be ONU.
interface-number: Specifies an interface number.
Examples
# Display information about the IAD module on ONU 1.
<Sysname> display pon iad interface onu 1/0/1:1
IAD basic information:
MAC address: 000f-e200-0004
Protocol: SIP
Software version: 101
User count: 2
IAD configuration:
IAD IP address configuration mode: Manual
IAD IP address: 172.3.170.58
IAD IP mask: 255.255.255.0
IAD IP gateway: 172.3.103.8
Voice VLAN mode: Tag
CVLAN: 4094
SVLAN: N/A
Priority: 5
Fax/modem configuration:
Fax/modem transmission mode: Transparent
Fax/modem negotiation mode: N/A
Table 1 Command output
Field |
Description |
IAD basic information |
Basic information about the IAD module. |
MAC address |
MAC address of the IAD module. |
Protocol |
Voice protocol supported by the IAD module: · SIP. · H.248. |
Software version |
Software version of the IAD module. This field displays N/A if the device does not support this field. |
User count |
Number of VoIP ports on the ONU. |
IAD configuration |
IAD module configuration. |
IAD IP address configuration mode |
Configuration mode of the IP address on the IAD module: · Manual—The IP address is manually assigned. · DHCP—The IP address is obtained through DHCP. · PPPoE—The IP address is obtained through PPPoE. |
IAD IP address |
IP address of the IAD module. |
IAD IP mask |
Subnet mask of the IAD module's IP address. |
IAD IP gateway |
Gateway address of the IAD module. |
Voice VLAN mode |
Operation mode for the voice VLAN feature: · Transparent—Voice packets are directly transmitted without VLAN tagging. · Tag—VLAN packets are tagged with a VLAN ID before transmission. |
CVLAN |
Inner VLAN ID tagged for voice packets. This field displays N/A if the voice VLAN operation mode is transparent. |
SVLAN |
Outer VLAN ID tagged for voice packets. This field displays N/A if the voice VLAN operation mode is transparent or VLAN tagging. |
Priority |
802.1p priority for voice packets that belong to the outer VLAN. |
Fax/modem configuration |
Fax or modem configuration. |
Fax/modem transmission mode |
Transmission mode for the fax and modem services: · Transparent. · T38. |
Fax/modem negotiation mode |
Negotiation mode for the fax and modem services: · Negotiate—Auto-negotiation mode. · Auto VBD—Auto VBD mode. This field displays N/A if the device does not support this field. |
display pon voip-port status
Use display pon voip-port status to display the status of a VoIP port on an ONU.
Syntax
display pon interface interface-type interface-number voip-port port-number status
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type, which can be ONU.
interface-number: Specifies an interface number.
port-number: Specifies a VoIP port by its port number, in the range of 1.
Examples
# Display the status of VoIP port 1 on ONU 1.
<Sysname> display pon interface onu 1/0/1:1 voip-port 1 status
Port status: Idle, on-hook
Service status: None/initial
Codec mode: PCMU
Table 2 Command output
Field |
Description |
Port status |
Status of the VoIP port: · Audible ringback. · Connected. · Connecting. · Dialing. · Disconnecting, audible indication. · Idle, on-hook. · Off-hook dial tone. · Ringing or FSK alerting/data. · RegFailure. · ROH, no tone. · ROH with tone. · Unknown or undefined. |
Service status |
Service status of the VoIP port: · CONFIGDONE—The service configuration is completed. · Disabled BySwitch—The service port is disabled by the call server. · INSESSION—Service in progress. · InvFail-AUTH—Failed to initiate a session, because authentication failed. · InvFail-ICMP—Failed to initiate a session due to ICMP errors. · InvFail-Server—Failed to initiate a session due to server errors. · InvFail-TCP—Failed to initiate a session due to TCP errors. · InvFail-Timeout—Failed to initiate a session due to timeout. · None/initial—The service has been initialized. · PortNotconfigure—The port is not configured. · RegFail-AUTH—Service registration failed due to authentication failure. · RegFail-ICMP—Service registration failed due to ICMP errors. · RegFail-Server—Service registration failed due to server errors. · RegFail-TCP—Service registration failed due to TCP errors. · RegFail-Timeout—Service registration failed due to timeout. · REGISTERED—The service has been registered. |
Codec mode |
Codec used by the VoIP port: · CN. · DVI4, 11.025 kHz. · DVI4, 16 kHz. · DVI4, 22.050 kHz. · DVI4, 8 kHz. · GSM. · ITU-T G.722. · ITU-T G.723. · ITU-T G.728. · ITU-T G.729. · L16, 1 channel. · L16, 2 channels. · LPC. · MPA. · PCMA. · PCMU. · QCELP. · RESERVED1. · RESERVED2. · Other. |
iad address
Use iad address to configure the IP address of the IAD module on an ONU.
Use undo iad address to restore the default.
Syntax
iad address { ip-address { mask-length | mask } gateway gateway | dhcp-alloc }
undo iad address
Default
No IP address is configured for the IAD module on an ONU.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
ip-address: Manually configures an IP address in dotted decimal notation.
mask-length: Specifies the mask length of the IP address, in the range of 1 to 31.
mask: Specifies the subnet mask of the IP address, in dotted decimal notation.
gateway gateway: Configures the gateway address.
dhcp-alloc: Obtains an IP address through DHCP.
Examples
# Configure the IAD module on an ONU to automatically obtain an IP address through DHCP.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] iad address dhcp-alloc
voice vlan
Use voice vlan to configure the voice VLAN operation mode on an ONU.
Use undo voice vlan to restore the default.
Syntax
Transparent mode:
undo voice vlan
VLAN tagging mode:
voice vlan cvlan-id [ priority priority ]
Default
The transparent mode is used.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
cvlan-id: Specifies the inner VLAN ID to tag voice packets, in the range of 1 to 4094.
priority priority: Specifies the 802.1p priority for voice packets that belong to the outer VLAN. The value range for the priority argument is 0 to 7 and the default is 5.
Examples
# Configure ONU 1 to tag voice packets with VLAN 100.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voice vlan 100
voip fax-modem transmission-mode
Use voip fax-modem transmission-mode to configure the transmission mode for the fax and modem services on an ONU.
Use undo voip fax-modem transmission-mode to restore the default.
Syntax
voip fax-modem transmission-mode { t38 | transparent }
undo voip fax-modem transmission-mode
Default
The transparent mode is used for the fax and modem services on an ONU.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
t38: Specifies the T.38 transmission mode.
transparent: Specifies the transparent transmission mode.
Examples
# Configure ONU 1 to use the T.38 transmission mode for the fax and modem services.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip fax-modem transmission-mode t38
voip heartbeat
Use voip heartbeat to configure the heartbeat parameters for the voice service on an ONU.
Use undo voip heartbeat to restore the default.
Syntax
voip heartbeat cycle interval
undo voip heartbeat
Default
For the voice service on an ONU, the heartbeat interval is 60 seconds, and the heartbeat count is 3.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
cycle interval: Specifies the heartbeat interval in the range of 1 to 65535 seconds.
Usage guidelines
An ONU sends a keepalive packet to the SIP server or MGC at the specified time interval (heartbeat interval). If the ONU does not receive a response from the server after the specified number of heartbeat intervals, the ONU considers the link to the SIP server or MGC disconnected.
Examples
# Configure the heartbeat interval as 180 seconds for the voice service on an ONU.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip heartbeat cycle 180
voip-port shutdown
Use voip-port shutdown to shut down a VoIP port on an ONU.
Use undo voip-port shutdown to bring up a VoIP port on an ONU.
Syntax
voip-port port-number shutdown
undo voip-port port-number shutdown
Default
All VoIP ports on an ONU are shut down.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
port-number: Specifies a VoIP port by its number, in the range of 1 to the current number of VoIP ports on the ONU.
Examples
# Bring up VoIP port 1 on ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] undo voip-port 1 shutdown
GPON SIP commands
display pon voip sip
Use display pon voip sip to display the SIP configuration on an ONU.
Syntax
display pon voip sip interface interface-type interface-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type: Specifies an interface type, ONU.
interface-number: Specifies an interface number.
Examples
# Display the SIP configuration on ONU 1.
<Sysname> display pon voip sip interface onu 1/0/1:1
SIP MG port number: 0
Main SIP proxy server IP address: N/A
Main SIP proxy server port number: 0
Standby SIP proxy server IP address: N/A
Standby SIP proxy server port number: 0
Active SIP proxy server: 0.0.0.0
Main SIP registrar server IP address: N/A
Main SIP registrar server port number: 0
Standby SIP registrar server IP address: N/A
Standby SIP registrar server port number: 0
SIP outbound server IP address: N/A
SIP outbound server port number: 0
SIP registration Interval: 0s
SIP heartbeat cycle: 0s
SIP heartbeat count: N/A
Table 3 Command output
Field |
Description |
SIP MG port number |
Port number of the SIP media gateway. This field displays 0 is GPON SIP is not configured. |
Main SIP proxy server IP address |
IP address of the primary SIP proxy server. |
Main SIP proxy server port number |
Port number of the primary SIP proxy server. This field displays 0 is GPON SIP is not configured. |
Standby SIP proxy server IP address |
IP address of the backup SIP proxy server. |
Standby SIP proxy server port number |
Port number of the backup SIP proxy server. This field displays 0 is GPON SIP is not configured. |
Active SIP proxy server |
IP address of the active SIP proxy server. |
Main SIP registrar server IP address |
IP address of the primary SIP registrar server. |
Main SIP registrar server port number |
Port number of the primary SIP registrar server. This field displays 0 is GPON SIP is not configured. |
Standby SIP registrar server IP address |
IP address of the backup SIP registrar server. |
Standby SIP registrar server port number |
Port number of the backup SIP registrar server. This field displays 0 is GPON SIP is not configured. |
SIP outbound server IP address |
IP address of the outbound SIP server. |
SIP outbound server port number |
Port number of the outbound SIP server. This field displays 0 is GPON SIP is not configured. |
SIP registration interval |
SIP user registration interval, in seconds. This field displays 0 is GPON SIP is not configured. |
SIP heartbeat cycle |
Heartbeat cycle, in seconds. |
SIP heartbeat count |
Heartbeat count in a heartbeat cycle. This field displays N/A if the device does not support this field. |
voip digit-map
Use voip digit-map to configure a SIP digit map for an ONU.
Use undo voip digit-map to delete a SIP digit map for an ONU.
Syntax
voip digit-map map-name map-content
undo voip digit-map map-name
Default
No SIP digit maps are configured for an ONU.
Default digit maps exist on some ONUs. Calls can be directly placed on these ONUs and no digit maps are required to be configured. Support for default digit maps depends on ONU model.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
map-name: Specifies a digit map name, a case-sensitive string of 1 to 31 characters.
map-content: Specifies the content of the digit map, a case-sensitive string of 1 to 28 characters.
Usage guidelines
A digit map is a dial plane used to restrict outgoing calls that can be placed on an ONU. If the dialed number does not meet the requirements of a digit map, the call cannot be placed.
The device issues the configured digit maps to ONUs. Support for digit maps depends on the ONU model. Interpretation of digit maps varies by ONU model.
To allow an ONU to place any call number, configure only one digit map [0-9*#]..
If you configure the content multiples times for the same digit map, the most recent configuration takes effect.
You can configure a maximum of 8 digit maps.
Examples
# Configure a digit map named map1 to allow four-digit call numbers starting with 3 to be dialed out..
<Sysname> system-view
[Sysname] interface Onu1/0/1:1
[Sysname-Onu1/0/1:1] voip digit-map map1 8888xxxx
voip sip mg-port
Use voip sip mg-port to specify the port number of the SIP media gateway for an ONU.
Use undo voip sip mg-port to restore the default.
Syntax
voip sip mg-port port
undo voip sip mg-port
Default
The port number is 5060 for the SIP media gateway on an ONU.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
port: Specifies the port number of the SIP media gateway, in the range of 1 to 65535.
Examples
# Specify 5080 as the port number of the SIP media gateway on ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip mg-port 5080
voip sip outbound-server
Use voip sip outbound-server to specify the outbound SIP server for an ONU.
Use undo voip sip outbound-server to remove the outbound SIP server.
Syntax
voip sip outbound-server ip ip-address [ port port ]
undo voip sip outbound-server
Default
No outbound SIP server is specified for an ONU.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the IP address of the outbound SIP server, in dotted decimal notation.
port: Specifies the port number of the outbound SIP server, in the range of 1 to 65535. The default is 5060.
Examples
# Specify 10.10.10.12 and 4098 as the IP address and port number of the outbound SIP server for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip outbound-server ip 10.10.10.12 port 4098
voip sip proxy-server
Use voip sip proxy-server to specify a SIP proxy server for an ONU.
Use undo voip sip proxy-server to remove a SIP proxy server for an ONU.
Syntax
voip sip proxy-server [ standby ] ip ip-address [ port port ]
undo voip sip proxy-server [ standby ]
Default
NO SIP proxy servers are specified.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
standby: Specifies the backup SIP proxy server. To specify the primary SIP proxy server, do not specify this keyword.
ip ip-address: Specifies the IP address of the SIP proxy server, in dotted decimal notation.
port port: Specifies the port number of the SIP proxy server, in the range of 1 to 65535. The default is 5060.
Usage guidelines
If you specify the primary or backup SIP proxy server multiple times, the most recent configuration takes effect.
Examples
# Specify 10.10.10.10 and 4096 as the IP address and port number of the primary SIP proxy server for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip proxy-server ip 10.10.10.10 port 4096
voip sip registrar-server
Use voip sip registrar-server to specify a SIP registrar server for an ONU.
Use undo voip sip registrar-server to remove a SIP registrar server for an ONU.
Syntax
voip sip registrar-server [ standby ] ip ip-address [ port port ]
undo voip sip registrar-server [ standby ]
Default
No SIP registrar servers are specified for an ONU.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
standby: Specifies the backup SIP registrar server. To specify the primary SIP registrar server, do not specify this keyword.
ip ip-address: Specifies the IP address of the SIP registrar server, in dotted decimal notation.
port port: Specifies the port number of the SIP registrar server, in the range of 1 to 65535. The default is 5060.
Usage guidelines
If you specify the primary or backup SIP registrar server multiple times, the most recent configuration takes effect.
Examples
# Specify 10.10.10.11 and 4097 as the IP address and port number of the primary SIP registrar server for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip registrar-server ip 10.10.10.11 port 4097
voip sip registration-interval
Use voip sip registration-interval to set the SIP user registration interval for an ONU.
Use undo voip sip registration-interval to restore the default.
Syntax
voip sip registration-interval interval
undo voip sip registration-interval
Default
The SIP user registration interval is 3600 seconds for an ONU.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the SIP user registration interval, in the range of 1 to 4294967295 seconds.
Usage guidelines
An ONU registers SIP users with the SIP registrar server at the specified interval. This mechanism ensures that the SIP registrar server manages only active SIP user accounts, which reduces the burden of the SIP registrar server.
As a best practice, use the default setting.
The SIP registrar and the ONU will negotiate the SIP user registration interval, which might be different from the value you set.
Examples
# Set the SIP user registration interval to 3000 seconds for ONU 1.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip sip registration-interval 3000
voip-port sip account
Use voip-port sip account to add a SIP user to an ONU.
Use undo voip-port sip account to remove a SIP user from an ONU.
Syntax
voip-port port-number sip account phone-number username username password { cipher | simple } password
undo voip-port port-number sip account
Default
No SIP users exist on an ONU.
Views
ONU interface view
Predefined user roles
network-admin
Parameters
port-number: Specifies a VoIP port by its number, in the range of 1 to the current number of VoIP ports on the ONU. An ONU can have a maximum of 64 VoIP ports.
phone-number: Specifies the phone number of the SIP user, a string of 1 to 16 digits.
username: Specifies the username of the SIP user, a string of 1 to 25 characters.
cipher: Specifies a password in encrypted form.
simple: Specifies a password in plaintext form. For security purposes, the password specified in plaintext form will be stored in encrypted form.
password: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 16 characters. Its encrypted form is a case-sensitive string of 1 to 53 characters.
Usage guidelines
The SIP user to be added must use the phone number as well as the username and password that have already been registered with the SIP registrar server.
Only one SIP user can be added to a VoIP port and a SIP user can be added to only one VoIP port.
Examples
# Add a SIP user to ONU 1. The phone number of the user is 13812345678, and the username and password of the user is alan and 123 in plaintext form, respectively.
<Sysname> system-view
[Sysname] interface onu 1/0/1:1
[Sysname-Onu1/0/1:1] voip-port 1 sip account 13812345678 username alan password simple 123