Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 06-Fax over IP commands | 95.17 KB |
Fax over IP commands
The following compatibility matrix shows the support of hardware platforms for fax over IP:
|
Hardware |
Fax over IP compatibility |
|
MSR810, MSR810-W, MSR810-W-DB, MSR810-LM, MSR810-W-LM, MSR810-10-PoE, MSR810-LM-HK, MSR810-W-LM-HK, MSR810-LMS-EA |
No |
|
MSR810-LMS, MSR810-LUS |
No |
|
MSR2600-6-X1 |
No |
|
MSR2600-10-X1 |
Yes |
|
MSR 2630 |
Yes |
|
MSR3600-28, MSR3600-51 |
Yes |
|
MSR3600-28-SI, MSR3600-51-SI |
No |
|
MSR3600-28-X1, MSR3600-28-X1-DP, MSR3600-51-X1, MSR3600-51-X1-DP |
No |
|
MSR3610-I-DP, MSR3610-IE-DP |
No |
|
MSR3610-X1, MSR3610-X1-DP, MSR3610-X1-DC, MSR3610-X1-DP-DC |
Yes |
|
MSR 3610, MSR 3620, MSR 3620-DP, MSR 3640, MSR 3660 |
Yes |
|
MSR3610-G, MSR3620-G |
No |
To support fax over IP, some device models require the Voice Software License. For more information, see license management in Fundamentals Configuration Guide.
fax cng-switch enable
Use fax cng-switch enable to enable CNG fax switchover for a voice entity.
Use undo fax cng-switch enable to disable CNG fax switchover for a voice entity.
Syntax
fax cng-switch enable
undo fax cng-switch enable
Default
CNG fax switchover is disabled for a voice entity.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Examples
# Enable CNG fax switchover for POTS entity 100.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 100 pots
[Sysname-voice-dial-entity100] fax cng-switch enable
fax ecm
Use fax ecm to enable ECM for a voice entity.
Use undo fax ecm to restore the default.
Syntax
fax ecm
undo fax ecm
Default
ECM is disabled for a voice entity.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Usage guidelines
To use ECM, make sure the calling and called fax machines support ECM.
Use this command on both calling and called devices.
Examples
# Enable ECM for POTS entity 4.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 4 pots
[Sysname-voice-dial-entity4] fax ecm
fax level
Use fax level to set the transmit energy level.
Use undo fax level to restore the default.
Syntax
fax level level
undo fax level
Default
The transmit energy level is –15 dBm.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Parameters
level: Specifies transmit energy level (the transmit energy level attenuation value) in dBm, in the range of –60 to –3. The greater the level value, the higher the energy. The smaller the level value, the greater the attenuation.
Usage guidelines
As a best practice, use the default transmit energy level. Use this command if you cannot establish fax calls when all settings are correct.
Examples
# Set the transmit energy level to –20 dBm for POTS entity 4.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 4 pots
[Sysname-voice-dial-entity4] fax level -20
fax local-train threshold
Use fax local-train threshold to set the local training threshold.
Use undo fax local-train threshold to restore the default.
Syntax
fax local-train threshold threshold
undo fax local-train threshold
Default
The local training threshold is 10.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Parameters
threshold: Specifies the local training threshold in percentage, in the range of 0 to 100.
Usage guidelines
If the threshold value is exceeded during rate training, the rate training failed.
The threshold configured with the fax local-train threshold command is valid only when the local training mode is used.
Examples
# Set the local training threshold to 20 for POTS entity 10.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] fax local-train threshold 20
Related commands
fax train-mode
fax nsf
Use fax nsf to configure an NSF code for nonstandard capabilities negotiation.
Use undo fax nsf to restore the default.
Syntax
fax nsf value
undo fax nsf
Default
The NSF code for nonstandard capabilities negotiation is 264833.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Parameters
value: Specifies an NSF code in hexadecimal format (2-digit country code plus 4-digit manufacturer code), in the range of 0 to FFFFFF. The country code must be T.35-compliant. The value 000000 specifies standard capabilities negotiation.
Examples
# Configure an NSF code of 264834 for nonstandard capabilities negotiation for POTS entity 10.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] fax nsf 264834
fax protocol
Use fax protocol to configure fax pass-through or the standard T.38 protocol for a voice entity.
Use undo fax protocol to restore default.
Syntax
fax protocol { pass-through { g711alaw | g711ulaw } | standard-t38 [ ls-redundancy number [ hs-redundancy number ] ] }
undo fax protocol
Default
The standard T.38 protocol is used.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Parameters
pass-through: Enables fax pass-through. The codec used for fax pass-through must be a codec specified for the voice entity.
g711alaw: Specifies the G.711 A-law codec for fax pass-through.
g711ulaw: Specifies the G.711 μ-law codec for fax pass-through.
standard-t38: Enables the standard T.38 protocol.
ls-redundancy number: Specifies the number of redundant packets to be sent for low-speed transmission. The value range for number is 0 to 5, and the default is 0.
hs-redundancy number: Specifies the number of redundant packets to be sent for high-speed transmission. The value range for number is 0 to 2, and the default is 0.
Usage guidelines
To ensure successful transmission when you use the standard T.38 protocol under poor network conditions, configure the device to send redundant packets.
You only need to configure this command on the calling device. The called device automatically matches the protocol configured on the calling device.
Examples
# Configure the standard T.38 protocol, and set the number of redundant packets to 4 for low-speed transmission.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] fax protocol standard-t38 ls-redundancy 4
# Enable fax pass-through and specify the G.711 A-law codec for fax pass-through.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] fax protocol pass-through g711alaw
fax rate
Use fax rate to set the maximum fax rate for rate training.
Use undo fax rate to restore the default.
Syntax
fax rate { 2400 | 4800 | 7200 | 9600 | 12000 | 14400 | disable | voice }
undo fax rate
Default
The maximum fax rate for rate training depends on the codec used.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Parameters
2400: Specifies 2400 bps.
4800: Specifies 4800 bps.
7200: Specifies 7200 bps.
9600: Specifies 9600 bps.
12000: Specifies 12000 bps.
14400: Specifies 14400 bps.
disable: Disables the fax feature.
voice: Determines the maximum fax rate for rate training according to the codec used.
· If G.711 is used, the maximum fax rate is 14400 bps, and the corresponding modem standard is V.17.
· If G.723.1 Annex A is used, the maximum fax rate is 4800 bps, and the corresponding modem standard is V.27.
· If G.726 is used, the maximum fax rate is 14400 bps, and the corresponding modem standard is V.17.
· If G.729 is used, the maximum fax rate is to 7200 bps, and the corresponding modem standard is V.29.
Usage guidelines
If you set the rate to a value other than disable and voice, the maximum rate is first used during rate training. If the negotiation fails, the next lower supported rate is used.
Examples
# Set the maximum fax rate for rate training to 9600 bps for POTS entity 4.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 4 pots
[Sysname-voice-dial-entity4] fax rate 9600
fax train-mode
Use fax train-mode to specify a rate training mode.
Use undo fax train-mode to restore the default.
Syntax
fax train-mode { local | ppp }
undo fax train-mode
Default
Point-to-point training is used.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Parameters
local: Uses the local training mode.
ppp: Uses the point-to-point training mode.
Examples
# Specify local training mode for POTS entity 10.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 10 pots
[Sysname-voice-dial-entity10] fax train-mode local
Related commands
fax local-train threshold
modem passthrough
Use modem passthrough to configure a codec and a switching mode for modem pass-through.
Use undo modem passthrough to restore the default.
Syntax
modem passthrough { nse [ payload-type number ] | protocol } codec { g711alaw | g711ulaw }
undo modem passthrough
Default
Modem pass-through is not used.
Views
POTS entity view
VoIP entity view
Predefined user roles
network-admin
Parameters
nse: Uses the named signaling event (NSE) mode to switch to modem pass-through.
payload-type number: Specifies the value for the NSE payload type, in the range of 98 to 120. The default is 100.
protocol: Uses SIP to switch to modem pass-through.
codec: Specifies a codec used for modem pass-through. The codec used for modem pass-through must be a codec specified for the voice entity.
g711alaw: Specifies the G.711 A-law codec.
g711ulaw: Specifies the G.711 μ-law codec.
Usage guidelines
Configure the same codec and switching mode on the calling and called devices.
Configure the same payload type value for NSE on the calling and called devices.
The NSE mode disables VAD and echo cancellation.
Examples
# Use SIP to switch to modem pass-through and specify the G.711 A-law codec for modem pass-through.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 550 voip
[Sysname-voice-dial-entity550] modem passthrough protocol codec g711alaw
# Use NSE to switch to modem pass-through and specify the G.711 A-law codec for modem pass-through.
<Sysname> system-view
[Sysname] voice-setup
[Sysname-voice] dial-program
[Sysname-voice-dial] entity 550 voip
[Sysname-voice-dial-entity550] modem passthrough nse codec g711alaw
