N3_sub/modules/libcanard/tests/stm32/test_can_timings.cpp

/*
 * Copyright (c) 2016 UAVCAN Team
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 *
 * Contributors: https://github.com/UAVCAN/libcanard/contributors
 */

#include <catch.hpp>
#include <drivers/stm32/canard_stm32.h>
#include <cstdio>
#include <string>
#include <stdexcept>


static std::uint32_t computeBDTR(const std::uint32_t pclk1,
                                 const std::uint32_t target_bitrate)
{
    CanardSTM32CANTimings timings = CanardSTM32CANTimings();

    const int res = canardSTM32ComputeCANTimings(pclk1, target_bitrate, &timings);

    const auto sample_point_permill =
        std::uint16_t((1000 * (1 + timings.bit_segment_1) / (1 + timings.bit_segment_1 + timings.bit_segment_2)));

    const std::uint32_t bdtr = (((timings.max_resynchronization_jump_width - 1U) &    3U) << 24U) |
                               (((timings.bit_segment_1 - 1U)                    &   15U) << 16U) |
                               (((timings.bit_segment_2 - 1U)                    &    7U) << 20U) |
                               (((timings.bit_rate_prescaler - 1U)               & 1023U) << 0U);

    std::printf("PCLK %9u    Target %9u    %s (%d)    Presc %4u    BS %2u/%u %.1f%%    BDTR 0x%08x\n",
                unsigned(pclk1),
                unsigned(target_bitrate),
                (res == 0) ? "OK" : "FAIL",
                res,
                timings.bit_rate_prescaler,
                timings.bit_segment_1,
                timings.bit_segment_2,
                double(sample_point_permill) * 0.1,
                unsigned(bdtr));
    if (res != 0)
    {
        throw std::runtime_error("canardSTM32ComputeCANTimings() returned " + std::to_string(res));
    }

    return bdtr;
}

/*
 * Reference values were validated manually with the help of http://www.bittiming.can-wiki.info/
 */
TEST_CASE("STM32, CANTimings")
{
    CHECK(0x00060003 == computeBDTR(36000000, 1000000));
    CHECK(0x00180005 == computeBDTR(36000000,  500000));
    CHECK(0x001c0008 == computeBDTR(36000000,  250000));
    CHECK(0x001c0011 == computeBDTR(36000000,  125000));
    CHECK(0x001b0017 == computeBDTR(36000000,  100000));
    CHECK(0x001c00e0 == computeBDTR(36000000,   10000));

    CHECK(0x00070008 == computeBDTR(90000000, 1000000));
    CHECK(0x001b000b == computeBDTR(90000000,  500000));
    CHECK(0x001b0017 == computeBDTR(90000000,  250000));
    CHECK(0x001c002c == computeBDTR(90000000,  125000));
    CHECK(0x001b003b == computeBDTR(90000000,  100000));
    CHECK(0x001b0257 == computeBDTR(90000000,   10000));
}