Admin: 1 revision

2013-02-15T19:16:42Z

1 revision

Admin: Created page with "= Action = Calls a subroutine or procedure in the BasicCard.
2013-02-13T11:52:34Z

Created page with "= Action = Calls a subroutine or procedure in the BasicCard. Action =

Calls a subroutine or procedure in the BasicCard.

 

 

= Syntax =

BCCALL name( nad , cla, ins, p1, p2 [param1 , paramn])

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="539" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="14%" style="width: 72px; border: 1px solid rgb(0, 0, 0);" |
name

| valign="top" width="100%" style="width: 458px; border: 1px solid rgb(0, 0, 0);" |
The name of the procedure to all in the BasicCard. It must be defined first with BCDEF. The name used with BCDEF and BCCALL do not need to be the same as the procedure in the BasicCard but it is advised to use the same names.

|- style="vertical-align: top;"
| valign="top" width="14%" style="width: 72px; border: 1px solid rgb(0, 0, 0);" |
NAD

| valign="top" width="100%" style="width: 458px; border: 1px solid rgb(0, 0, 0);" |
Node address byte. The BasicCard responds to all node address values. Use 0 for default.

|- style="vertical-align: top;"
| valign="top" width="14%" style="width: 72px; border: 1px solid rgb(0, 0, 0);" |
CLA

| valign="top" width="100%" style="width: 458px; border: 1px solid rgb(0, 0, 0);" |
Class byte. First byte of two byte CLA-INS command. Must match the value in the BasicCard procedure.

|- style="vertical-align: top;"
| valign="top" width="14%" style="width: 72px; border: 1px solid rgb(0, 0, 0);" |
INS

| valign="top" width="100%" style="width: 458px; border: 1px solid rgb(0, 0, 0);" |
Instruction byte. Second byte of two byte CLA-INS command. Must match the value in the BasicCard procedure.

|- style="vertical-align: top;"
| valign="top" width="14%" style="width: 72px; border: 1px solid rgb(0, 0, 0);" |
P1

| valign="top" width="100%" style="width: 458px; border: 1px solid rgb(0, 0, 0);" |
Parameter 1 of CLA–INS header.

|- style="vertical-align: top;"
| valign="top" width="14%" style="width: 72px; border: 1px solid rgb(0, 0, 0);" |
P2

| valign="top" width="100%" style="width: 458px; border: 1px solid rgb(0, 0, 0);" |
Parameter 2 of CLA-INS header

|}
</div>
 

[[File:Notice.jpg|notice]]This statements uses BCCARD.LIB, a library that is available separately from MCS Electronics.

 

 

When in your BasicCard basic program you use:

'test of passing parameters

Command &hf6 &h01 ParamTest( b as byte, w as integer,l as long)

b=b+1

w=w+1

l=l+1

end command

 

 

You need to use &HF6 for CLA and 1 for INS when you call the program:

 

Bccall Paramtest(0 , &HF6 , 1 , 0 , 0 , B , W , L)

                                             ^ NAD

 

                                        ^CLA

 

                                    ^INS

 

                              ^P1

 

                      ^P2

 

 

When you use BCCALL, the NAD, CLA, INS, P1 and P2 are sent to the BasicCard. The parameter values are also sent to the BasicCard. The BasicCard will execute the command defined with CLA and INS and will return the result in SW1 and SW2.

 

The parameter values altered by the BasicCard are also sent by the BasicCard.

 

You can not sent constant values. Only variables may be sent. This because a constant can not be changed.

 

 

= See Also =

[[CONFIG BCCARD|CONFIG BCCARD]] , [[BCDEF]] , [[BCRESET]]

 

 

 

= Example =

<source lang="bascomavr">
'------------------------------------------------------------------------------
' BCCARD.BAS
' This AN shows how to use the BasicCard from Zeitcontrol
' www.basiccard.com
'------------------------------------------------------------------------------
'connections:
' C1 = +5V
' C2 = PORTD.4 - RESET
' C3 = PIN 4 - CLOCK
' C5 = GND
' C7 = PORTD.5 - I/O

' /--------------------------------\
' | |
' | C1 C5 |
' | C2 C6 |
' | C3 C7 |
' | C4 C8 |
' | |
' \--------------------------------/
'
'

'----------- configure the pins we use ------------
Config Bccard = D , Io = 5 , Reset = 4
' ^ PORTD.4
' ^------------ PORTD.5
' ^--------------------- PORT D

'Load the sample calc.bas into the basiccard

' Now define the procedure in BASCOM
' We pass a string and also receive a string
Bcdef Calc(string)

'We need to dim the following variables
'SW1 and SW2 are returned by the BasicCard
'BC_PCB must be set to 0 before you start a session

'Our program uses a string to pass the data so DIM it
Dim S As String * 15

'Baudrate might be changed
$baud = 9600
' Crystal used must be 3579545 since it is connected to the Card too
$crystal = 3579545

'Perform an ATR
Bcreset

'Now we call the procedure in the BasicCard
'bccall funcname(nad,cla,ins,p1,p2,PRM as TYPE,PRM as TYPE)
S = "1+1+3" ' we want to calculate the result of this expression

Bccall Calc(0 , &H20 , 1 , 0 , 0 , S)
' ^--- variable to pass that holds the expression
' ^------- P2
' ^----------- P1
' ^--------------- INS
' ^-------------------- CLA
' ^-------------------------- NAD
'For info about NAD, CLA, INS, P1 and P2 see your BasicCard manual
'if an error occurs ERR is set
' The BCCALL returns also the variables SW1 and SW2
Print "Result of calc : " ; S
Print "SW1 = " ; Hex(sw1)
Print "SW2 = " ; Hex(sw2)
'Print Hex(_bc_pcb) ' for test you can see that it toggles between 0 and 40
Print "Error : " ; Err

'You can call this or another function again in this session

S = "2+2"
Bccall Calc(0 , &H20 , 1 , 0 , 0 , S)
Print "Result of calc : " ; S
Print "SW1 = " ; Hex(sw1)
Print "SW2 = " ; Hex(sw2)
'Print Hex(_bc_pcb) ' for test you can see that it toggles between 0 and 40
Print "Error : " ; Err

'perform another ATR
Bcreset
Input "expression " , S
Bccall Calc(0 , &H20 , 1 , 0 , 0 , S)
Print "Answer : " ; S

'----and now perform an ATR as a function
Dim Buf(25) As Byte , I As Byte
Buf(1) = Bcreset()
For I = 1 To 25
Print I ; " " ; Hex(buf(i))
Next
'typical returns :
'TS = 3B
'T0 = EF
'TB1 = 00
'TC1 = FF
'TD1 = 81 T=1 indication
'TD2 = 31 TA3,TB3 follow T=1 indicator
'TA3 = 50 or 20 IFSC ,50 =Compact Card, 20 = Enhanced Card
'TB3 = 45 BWT blocl waiting time
'T1 -Tk = 42 61 73 69 63 43 61 72 64 20 5A 43 31 32 33 00 00
' B a s i c C a r d Z C 1 2 3

'and another test
'define the procedure in the BasicCard program
Bcdef Paramtest(byte , Word , Long )

'dim some variables
Dim B As Byte , W As Word , L As Long

'assign the variables
B = 1 : W = &H1234 : L = &H12345678

Bccall Paramtest(0 , &HF6 , 1 , 0 , 0 , B , W , L)
Print Hex(sw1) ; Spc(3) ; Hex(sw2)
'and see that the variables are changed by the BasicCard !
Print B ; Spc(3) ; Hex(w) ; " " ; Hex(l)

'try the echotest command
Bcdef Echotest(byte)
Bccall Echotest(0 , &HC0 , &H14 , 1 , 0 , B)
Print B
End 'end program

</source>

= BasicCard Example =

<source lang="bascomavr">
Rem BasicCard Sample Source Code
Rem ------------------------------------------------------------------
Rem Copyright (C) 1997-2001 ZeitControl GmbH
Rem You have a royalty-free right to use, modify, reproduce and
Rem distribute the Sample Application Files (and/or any modified
Rem version) in any way you find useful, provided that you agree
Rem that ZeitControl GmbH has no warranty, obligations or liability
Rem for any Sample Application Files.
Rem ------------------------------------------------------------------

#Include CALCKEYS.BAS

Declare ApplicationID = "BasicCard Mini-Calculator"

Rem This BasicCard program contains recursive procedure calls, so the
Rem compiler will allocate all available RAM to the P-Code stack unless
Rem otherwise advised. This slows execution, because all strings have to
Rem be allocated from EEPROM. So we specify a stack size here:

#Stack 120

' Calculator Command (CLA = &H20, INS = &H01)
'
' Input: an ASCII expression involving integers, and these operators:
'
' * / % + - & ^ |
'
' (Parentheses are also allowed.)
'
' Output: the value of the expression, in ASCII.
'
' P1 = 0: all numbers are decimal
' P1 <> 0: all numbers are hex

' Constants
Const SyntaxError = &H81
Const ParenthesisMismatch = &H82
Const InvalidNumber = &H83
Const BadOperator = &H84

' Forward references
Declare Function EvaluateExpression (S$, Precedence) As Long
Declare Function EvaluateTerm (S$) As Long
Declare Sub Error (Code@)

'test for passing a string
Command &H20 &H01 Calculator (S$)

Private X As Long
S$ = Trim$ (S$)
X = EvaluateExpression (S$, 0)
If Len (Trim$ (S$)) <> 0 Then Call Error (SyntaxError)
If P1 = 0 Then S$ = Str$ (X) : Else S$ = Hex$ (X)

End Command

'test of passing parameters
Command &hf6 &h01 ParamTest( b as byte, w as integer,l as long)
b=b+1
w=w+1
l=l+1
end command

Function EvaluateExpression (S$, Precedence) As Long

EvaluateExpression = EvaluateTerm (S$)

Do
S$ = LTrim$ (S$)
If Len (S$) = 0 Then Exit Function

Select Case S$(1)

Case ""
If Precedence > 5 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression _
EvaluateExpression (S$, 6)
Case "/"
If Precedence > 5 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression / _
EvaluateExpression (S$, 6)
Case "%"
If Precedence > 5 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression Mod _
EvaluateExpression (S$, 6)
Case "+"
If Precedence > 4 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression + _
EvaluateExpression (S$, 5)
Case "-"
If Precedence > 4 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression - _
EvaluateExpression (S$, 5)
Case "&"
If Precedence > 3 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression And _
EvaluateExpression (S$, 4)
Case "^"
If Precedence > 2 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression Xor _
EvaluateExpression (S$, 3)
Case "|"
If Precedence > 1 Then Exit Function
S$ = Mid$ (S$, 2)
EvaluateExpression = EvaluateExpression Or _
EvaluateExpression (S$, 2)
Case Else
Exit Function
End Select

Loop

End Function

Function EvaluateTerm (S$) As Long

Do ' Ignore unary plus
S$ = LTrim$ (S$)
If Len (S$) = 0 Then Call Error (SyntaxError)
If S$(1) <> "+" Then Exit Do
S$ = Mid$ (S$, 2)
Loop

If S$(1) = "(" Then ' Expression in parentheses
S$ = Mid$ (S$, 2)
EvaluateTerm = EvaluateExpression (S$, 0)
S$ = LTrim$ (S$)
If S$(1) <> ")" Then Call Error (ParenthesisMismatch)
S$ = Mid$ (S$, 2)
Exit Function

ElseIf S$(1) = "-" Then ' Unary minus
S$ = Mid$ (S$, 2)
EvaluateTerm = -EvaluateTerm (S$)
Exit Function

Else ' Must be a number
If P1 = 0 Then ' If decimal
EvaluateTerm = Val& (S$, L@)
Else
EvaluateTerm = ValH (S$, L@)
End If
If L@ = 0 Then Call Error (InvalidNumber)
S$ = Mid$ (S$, L@ + 1)
End If

End Function

Sub Error (Code@)
SW1 = &H64
SW2 = Code@
Exit
End Sub
</source> {{Languages}}

[[Category:BCCARD/de]]

BCCALL/de - Revision history

Admin: 1 revision