AllowRtrFrames

This parameter allows / disallows the reception of RTR frames within a PCAN Channel. This parameter doesn’t affect the acceptance filter of a PCAN Channel. Furthermore, other applications working with the same hardware can individually configure the reception of RTR frames.

Note

Disabling the ReceiveStatus parameter also suppresses the reception of RTR frames.

Availability

It is available since PCAN-Basic version 4.2.0.

Supported By

PCAN-USB: Channels Usb01 to Usb16.
PCAN-PCI: Channels Pci01 to Pci16
PCAN-LAN: Channels Lan01 to Lan16.

Access Mode

This parameter is read/write. It can be configured and retrieved.

Possible Values

This parameter can be activated or deactivated. Accepts values of type ParameterValueActivation.

Default Value

The default state of receiving RTR frames is On. After switching it Off, receiving RTR frames stays inactive until it is expressly reactivated, or the Channel is disconnected, i.e., using the Uninitialize method.

Initialization Status

Get: The PCAN Channel must be initialized before using this parameter.

Set: The PCAN Channel must be initialized before using this parameter.

Example

The following code shows how to disable receiving RTR frames on a USB Channel:

C#

PcanChannel channelUsed = PcanChannel.Usb01;

if (Api.Initialize(channelUsed, Bitrate.Pcan500) == PcanStatus.OK)
{
    if (Api.SetValue(channelUsed, PcanParameter.AllowRtrFrames, ParameterValue.Activation.Off) == PcanStatus.OK)
        Console.WriteLine($"Receiving RTR frames on {channelUsed} has been successfully disabled.");
    else
        Console.WriteLine($"Error configuring the reception of RTR frames on channel {channelUsed}.");
    Api.Uninitialize(channelUsed);
}

VB

Dim channelUsed As PcanChannel = PcanChannel.Usb01

If Api.Initialize(channelUsed, Bitrate.Pcan500) = PcanStatus.OK Then
    If Api.SetValue(channelUsed, PcanParameter.AllowRtrFrames, ParameterValue.Activation.Off) = PcanStatus.OK Then
        Console.WriteLine($"Receiving RTR frames on {channelUsed} has been successfully disabled.")
    Else
        Console.WriteLine($"Error configuring the reception of RTR frames on channel {channelUsed}.")
    End If
    Api.Uninitialize(channelUsed)
End If

C++

PcanChannel channelUsed = PcanChannel::Usb01;

if (Api::Initialize(channelUsed, Bitrate::Pcan500) == PcanStatus::OK)
{
    if (Api::SetValue(channelUsed, PcanParameter::AllowRtrFrames, ParameterValue::Activation::Off) == PcanStatus::OK)
        Console::WriteLine("Receiving RTR frames on {0} has been successfully disabled.", channelUsed);
    else
        Console::WriteLine("Error configuring the reception of RTR frames on channel {0}.", channelUsed);
    Api::Uninitialize(channelUsed);
}