6.1.1.13. MATH (dialplan function) - NEW
1. MATH - this function allows you to perform simple mathematical operations.
NOTE:Information about the Asterisk functions could be obtained by typing the show functions command.
Information about a particular function could be obtained by typing the show function <function name> on the Asterisk CLI command.
NOTE: In Asterisk versions 1.2 and up there are several applications which are mark as deprecated and which are no longer supported.
These applications will now become functions and these functions will be used in combination with the Set application.
You have to know that their functionality will be the same, but with a different syntax.
The MATH function is one of those new functions which will replace the old applications. In this tutorial we will show you its syntax and possible usage.
Check out the old syntax of the Math application here
Syntax:
List of the possible options
Purpose and usage
Prerequisites
Asterisk PBX configurations
iax.conf Configurations
extensions.conf Configurations
2. Screenshots of what you could see on the CLI of the Asterisk PBX
3. Additional information
4. Uploaded files
MATH.tar - configuration files
NOTE:Information about the Asterisk functions could be obtained by typing the show functions command.
Information about a particular function could be obtained by typing the show function <function name> on the Asterisk CLI command.
NOTE: In Asterisk versions 1.2 and up there are several applications which are mark as deprecated and which are no longer supported.
These applications will now become functions and these functions will be used in combination with the Set application.
You have to know that their functionality will be the same, but with a different syntax.
The MATH function is one of those new functions which will replace the old applications. In this tutorial we will show you its syntax and possible usage.
Check out the old syntax of the Math application here
Syntax:
Set(ReturnVar=${MATH(<parameter1>OPERATION<parameter2>,[result type])})
List of the possible options
ReturnVar - the variable, where the return result to be stored
parameter1 - the first digit
parameter2 - the second digit
OPERATION - the mathematical operation. It could be - +,-,/,*,%,<,>,>=,<=,==
parameter1 - the first digit
parameter2 - the second digit
OPERATION - the mathematical operation. It could be - +,-,/,*,%,<,>,>=,<=,==
Purpose and usage
The purpose of this function is obvious - it allows you to perform simple mathematical operations.
Below, we will give you an example.
Below, we will give you an example.
Prerequisites
To use this application you need a working Asterisk PBX with registered users in iax.conf, sip.conf or mgcp.conf(It depends on which protocol you would like to use) and made extensions. We are using Asterisk version1.2.1.
To see how the application works we recommend you to use our IAX softphone Idefisk. You could download it from here. Please also read our tutorial to learn how to configure it to work with Asterisk PBX.
To see how the application works we recommend you to use our IAX softphone Idefisk. You could download it from here. Please also read our tutorial to learn how to configure it to work with Asterisk PBX.
Asterisk PBX configurations
iax.conf Configurations
We need to create one user in the iax.conf file. This is because we are going to use the IAX2 protocol. If you want to use other protocol, such as SIP or MGCP, you have to do the configurations below respectively in sip.conf or mgcp.conf.
So, we have registered the user user1
Type=friend means that this user can make and receive calls. Host=dynamic means that the IP is not static but dynamic through a DHCP server. Allow=all means that the line which this user will use, could support all audio codecs. Context=test - this shows that this user is working with the extensions in this context of the configuration file extensions.conf.
Type=friend means that this user can make and receive calls. Host=dynamic means that the IP is not static but dynamic through a DHCP server. Allow=all means that the line which this user will use, could support all audio codecs. Context=test - this shows that this user is working with the extensions in this context of the configuration file extensions.conf.
extensions.conf Configurations
Now lets take a look at the extensions.conf file.
On the picture above you could see our extensions.conf file.
In this example, we will show you all the operation which the function could perform.
When somebody dials 100, the call will be answered by the Answer application.
Then we have an extension with the Set application. As arguments in its brackets we will set the following- NEWVAR=${MATH(1+20)}. This will perform the mathematical operation SUM in the brackets and then it will return the result in the NEWVAR variable.
We will use an extension with the NoOp application - to check the result.
Just to see the other possible mathematical operations we will use the same couple of applications.
So we have:
Set(NEWVAR=${MATH(3*10)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(10/5)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(20-10)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(10-200)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1<20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1>=20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(101>20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1==20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(20<=20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(123%16)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1%16|i)})
NoOp(${NEWVAR})
As you could see in the last Set extension there is the letter i at the end. This indicates the desired result type. So i stands for integer.
The other possible types are:
In this example, we will show you all the operation which the function could perform.
When somebody dials 100, the call will be answered by the Answer application.
Then we have an extension with the Set application. As arguments in its brackets we will set the following- NEWVAR=${MATH(1+20)}. This will perform the mathematical operation SUM in the brackets and then it will return the result in the NEWVAR variable.
We will use an extension with the NoOp application - to check the result.
Just to see the other possible mathematical operations we will use the same couple of applications.
So we have:
Set(NEWVAR=${MATH(3*10)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(10/5)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(20-10)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(10-200)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1<20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1>=20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(101>20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1==20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(20<=20)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(123%16)})
NoOp(${NEWVAR})
Set(NEWVAR=${MATH(1%16|i)})
NoOp(${NEWVAR})
As you could see in the last Set extension there is the letter i at the end. This indicates the desired result type. So i stands for integer.
The other possible types are:
- float (the default one) - use the letter f
- hex - use the letter h
- char - use the letter c
NOTE: The function MATH is case sensitive. You always have to write it in your dialplans with capital letters.
In order to be sure that the Asterisk PBX will hang up the line, when the conversation is over, it is a good idea to use the Hangup application.
- hex - use the letter h
- char - use the letter c
NOTE: The function MATH is case sensitive. You always have to write it in your dialplans with capital letters.
In order to be sure that the Asterisk PBX will hang up the line, when the conversation is over, it is a good idea to use the Hangup application.
2. Screenshots of what you could see on the CLI of the Asterisk PBX
3. Additional information
For more information about extensions.conf you can check here.
For more information about iax.conf you can check here.
This application is tested with our IAX softphone Idefisk. You can download it from here. For more information about this softphone please read our tutorial.
If you would like to test this application with the SIP channel you can read our tutorials about the SIP Softphones to learn how to configure them to work with Asterisk PBX
More information about the Set application could be found here
For more information about iax.conf you can check here.
This application is tested with our IAX softphone Idefisk. You can download it from here. For more information about this softphone please read our tutorial.
If you would like to test this application with the SIP channel you can read our tutorials about the SIP Softphones to learn how to configure them to work with Asterisk PBX
More information about the Set application could be found here
4. Uploaded files
MATH.tar - configuration files
| Add Comment |
Latest Headlines:
-
T.38 faxing with Zoiper 2.15 is now easier than ever
section: voip software
-
Asterisk 1.4.21 Released
section: Asterisk
-
Asterisk 1.4.20 Released
section: Asterisk
-
Asterisk 1.4.20-rc2 Released
section: Asterisk
-
Asterisk 1.4.20-rc1 Now Available
section: Asterisk
- News Archives (older news)
Latest Tutorials:
-
Sending Fax from Zoiper to Zoiper using T.38
added 08/Dec/2008 18:16
-
VMAuthenticate (dialplan application)
added 01/Mar/2008 15:57
-
Siptronic ST-530
added 06/Nov/2007 17:57
-
Siemens C455 IP hardphone
added 05/Nov/2007 10:24
-
Zoiper
added 22/Oct/2007 17:53
Latest Comments:
-
https://git-ce.rwth-aachen.de/mbd/kiste_...
tutorial: Basic Information
-
https://git-ce.rwth-aachen.de/mbd/kiste_...
tutorial: Basic Information
-
https://www.thebeachlittlehampton.co.uk/...
tutorial: Digium Wildcard TE405 / Wildcard TE410P
-
https://www.viessmann-community.com/t5/R...
tutorial: Asterisk Installation
-
https://d2l.msu.edu/d2l/eP/presentations...
tutorial: Asterisk Realtime configuration