Fax over IP commands -- 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

mdc-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 over IP commands -- 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

mdc-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 over IP commands -- 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

mdc-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 over IP commands -- 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

mdc-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 over IP commands -- 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

mdc-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 over IP commands -- 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

mdc-admin

Parameters

pass-through: Enables fax pass-through.

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 over IP commands -- 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

mdc-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 over IP commands -- 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

mdc-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

Fax over IP commands -- 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

mdc-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.

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