Setting the BACK DIGITS variable
(→Compelled sequence and information exchange) |
m (Needs revising edit) |
||
(4 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
− | + | #REDIRECT [[Setting the CAS R2 BACK DIGITS variable]] | |
+ | The default CASR2 scripts included with Toolpack present a way to configure the sequence of tone requests sent by the backward end. | ||
− | To learn how to set a | + | To learn how to set a CASR2 variable in Toolpack, refer to [[Setting CASR2 variables]]. |
− | ''The digit meanings in this article are the ones defined in the [[ | + | ''The digit meanings in this article are the ones defined in the [[CASR2 ITU specification]]. Digit meanings may vary depending on the variant specification.'' |
== Compelled sequence and information exchange == | == Compelled sequence and information exchange == | ||
[[File:Casr2_fwd_bwd_diagram.png]] | [[File:Casr2_fwd_bwd_diagram.png]] | ||
− | In most implementations, the information available from | + | In most implementations, the information available from CASR2 signaling is exchanged through compelled sequences of tones. A compelled sequence consists into the forward end emitting a digit and the backward end responding with a second digit. The backward end confirms reception of the digit by stopping to emit, and waits for the forward end to do so as well to initiate the next sequence. In a way, the forward end is mostly passive: it responds to backward end requests, except when the requests cannot be met, or for the first sequence. |
One way of representing such exchanges can be expressed as follows: | One way of representing such exchanges can be expressed as follows: | ||
Line 26: | Line 27: | ||
In this example, the backward end requested the calling party category (using digit '5') after having received all the called number digits. Still using digit '5', it then requested the calling number. Once it was fully received, the backward end accepted the call with digit '6'. | In this example, the backward end requested the calling party category (using digit '5') after having received all the called number digits. Still using digit '5', it then requested the calling number. Once it was fully received, the backward end accepted the call with digit '6'. | ||
− | Here is a second example where the backward send an extra '5' when gathering the calling number (The picture also shows the different | + | Here is a second example where the backward send an extra '5' when gathering the calling number (The picture also shows the different CASR2 concepts and TelcoBridges Cas R2 script BACK_DIGITS variable): |
Called number: 4506558993 | Called number: 4506558993 | ||
Calling number: 4506559511 | Calling number: 4506559511 | ||
Line 40: | Line 41: | ||
Backward : 1 1 1 1 1 1 1 1 1 5 5 5 5 5 5 5 3 6 | Backward : 1 1 1 1 1 1 1 1 1 5 5 5 5 5 5 5 3 6 | ||
− | In this final example, the backward end sent an | + | In this final example, the backward end sent an extra '5' digit, and the backward end responded with 'F' to mark the end of the calling number. Then, the backward end sent digit '3' which represent two things: request of the category again, and also signify to the forward end that the next digit belongs to a different grouping (named "Group B"). Once the category was received, the backward end accepted the call with the '6'. |
== The BACK_DIGITS variable == | == The BACK_DIGITS variable == | ||
− | In the | + | In the CASR2 default scripts found in Toolpack, the BACK_DIGITS variable expresses the digits that must be emitted from the backward end (incoming CASR2 call). A functioning BACK_DIGITS variable that complies with the second example of the last section would be: |
BACK_DIGITS = "111111111555555536" | BACK_DIGITS = "111111111555555536" | ||
Line 53: | Line 54: | ||
BACK_DIGITS = "1111111115A3V" | BACK_DIGITS = "1111111115A3V" | ||
− | With such a string, the only thing to worry about is the length of the called number. If the called number length may vary, the number of '1's must match the longest possible number. In the case where the | + | With such a string, the only thing to worry about is the length of the called number. If the called number length may vary, the number of '1's must match the longest possible number. In the case where the forward end receives a '1' when it has sent all its digits, the conventional way of handling this is for the forward end to not emit anything for a while, until the backward end detects this condition and requests something else. In this case, the default scripts in Toolpack will handle this case gracefully and skip the remaining '1's found in the BACK_DIGITS variable. |
− | + | ||
− | + |
Latest revision as of 07:40, 19 April 2018
The default CASR2 scripts included with Toolpack present a way to configure the sequence of tone requests sent by the backward end.
To learn how to set a CASR2 variable in Toolpack, refer to Setting CASR2 variables.
The digit meanings in this article are the ones defined in the CASR2 ITU specification. Digit meanings may vary depending on the variant specification.
Compelled sequence and information exchange
In most implementations, the information available from CASR2 signaling is exchanged through compelled sequences of tones. A compelled sequence consists into the forward end emitting a digit and the backward end responding with a second digit. The backward end confirms reception of the digit by stopping to emit, and waits for the forward end to do so as well to initiate the next sequence. In a way, the forward end is mostly passive: it responds to backward end requests, except when the requests cannot be met, or for the first sequence.
One way of representing such exchanges can be expressed as follows:
Called number: 4506558993 Forward : 4 5 0 6 5 5 8 9 9 3 Backward : 1 1 1 1 1 1 1 1 1 6
In the previous example, the forward end emits the first digit of the called number '4'. The backward end responds with the '1' digit, which request the next called number digit. The exchanges goes on until the backward end has received all the digits it needed, and closed the exchange with the '6' digit, which means the call was accepted.
The incoming end may (and will, most of the time) request the calling number and the calling party category as well:
Called number: 4506558993 Calling number: 4506559511 Calling party category: 1 (Subscriber without priority) Forward : 4 5 0 6 5 5 8 9 9 3 1 4 5 0 6 5 5 9 5 1 1 Backward : 1 1 1 1 1 1 1 1 1 5 5 5 5 5 5 5 5 5 5 5 6
In this example, the backward end requested the calling party category (using digit '5') after having received all the called number digits. Still using digit '5', it then requested the calling number. Once it was fully received, the backward end accepted the call with digit '6'.
Here is a second example where the backward send an extra '5' when gathering the calling number (The picture also shows the different CASR2 concepts and TelcoBridges Cas R2 script BACK_DIGITS variable):
Called number: 4506558993 Calling number: 4506559511 Calling party category: 2 (Subscriber without priority)
Finally, here is a final example:
Called number: 4506558993 Calling number: 12345 Calling party category: 2 (Subscriber with priority) Forward : 4 5 0 6 5 5 8 9 9 3 2 1 2 3 4 5 F 2 Backward : 1 1 1 1 1 1 1 1 1 5 5 5 5 5 5 5 3 6
In this final example, the backward end sent an extra '5' digit, and the backward end responded with 'F' to mark the end of the calling number. Then, the backward end sent digit '3' which represent two things: request of the category again, and also signify to the forward end that the next digit belongs to a different grouping (named "Group B"). Once the category was received, the backward end accepted the call with the '6'.
The BACK_DIGITS variable
In the CASR2 default scripts found in Toolpack, the BACK_DIGITS variable expresses the digits that must be emitted from the backward end (incoming CASR2 call). A functioning BACK_DIGITS variable that complies with the second example of the last section would be:
BACK_DIGITS = "111111111555555536"
However, such a sequence has many problems. Firsthand, the called number may be invalid and the call should be refused. To let Toolpack handle the decision of accepting or refusing the call when in group B, the 'V' symbol is used. With the aid of tables found in the script, Toolpack will be able to find the appropriate digit to emit considering the acceptation or refusal of the call.
BACK_DIGITS = "11111111155555553V"
To simplify the variable contents, the 'A' symbol may be used. What it does is send the '5' digit until 'F' is received. The variable would be slimmer:
BACK_DIGITS = "1111111115A3V"
With such a string, the only thing to worry about is the length of the called number. If the called number length may vary, the number of '1's must match the longest possible number. In the case where the forward end receives a '1' when it has sent all its digits, the conventional way of handling this is for the forward end to not emit anything for a while, until the backward end detects this condition and requests something else. In this case, the default scripts in Toolpack will handle this case gracefully and skip the remaining '1's found in the BACK_DIGITS variable.