Admin: 1 revision

2013-02-15T19:13:00Z

1 revision

Admin: Created page with "= Action = Receives data from a received CAN frame and stores it into a variable.
2013-02-07T16:20:02Z

Created page with "= Action = Receives data from a received CAN frame and stores it into a variable. Action =

Receives data from a received CAN frame and stores it into a variable.

 

 

= Syntax =

numrec = CANRECEIVE(var [, bytes])

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="396" 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="26%" style="width: 99px; border: 1px solid rgb(0, 0, 0);" |
numrec

| valign="top" width="116%" style="width: 288px; border: 1px solid rgb(0, 0, 0);" |
Number of bytes received.

|- style="vertical-align: top;"
| valign="top" width="26%" style="width: 99px; border: 1px solid rgb(0, 0, 0);" |
var

| valign="top" width="116%" style="width: 288px; border: 1px solid rgb(0, 0, 0);" |
The variable into which the received data is stored. This must be a numeric variable or array. Version 2076 supports strings as well.

|- style="vertical-align: top;"
| valign="top" width="26%" style="width: 99px; border: 1px solid rgb(0, 0, 0);" |
bytes

| valign="top" width="116%" style="width: 288px; border: 1px solid rgb(0, 0, 0);" |
This is an optional parameter and specifies the number of bytes to retrieve.

|}
</div>
 

The compiler will use the data type of the variable to determine how many bytes need to be retrieved. So when you use a variable that was [http://avrhelp.mcselec.com/dim.htm DIM]ensioned as a long, an attempt will be made to read 4 bytes.

 

The CANRECEIVE function operates on the current selected Message Object which is selected with CANSELPAGE.

The CANRECEIVE function is intended to be used inside the CAN interrupt routine.

After you have retrieved the data from the received CAN frame, the Message Object is free to be used again. You MUST configure it again in order to receive a new interrupt.

 

 

= See also =

[[CONFIG_CANBUS|CONFIG CANBUS]] , [[CONFIG_CANMOB|CONFIG CANMOB]] , [[CANBAUD]] , [[CANRESET]] , [[CANCLEARMOB]] , [[CANCLEARALLMOBS]] , [[CANSEND]] , [[CANID]] , [[CANSELPAGE]] , [[CANGETINTS]]

 

 

 

= Example =

 <source lang="bascomavr">
Breceived = Canreceive(porta) ' read the data and store in PORTA
Print #2 , "Got : " ; Breceived ; " bytes" ' show what we received
Print #2 , Hex(porta)
Config Canmob = -1 , Bitlen = 11 , Msgobject = Receive , Msglen = 1 , Autoreply = Disabled , Clearmob = No
' reconfig with value -1 for the current MOB and do not set ID and MASK
</source> {{Languages}}

[[Category:BASCOM Language Reference/de]]