/* This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ /* * AP_CANManager - board specific configuration for CAN interface */ #include #include #include "AP_CANManager.h" #if HAL_CANMANAGER_ENABLED #include #include #include #include #include #include #include #include "AP_CANTester.h" #include #if CONFIG_HAL_BOARD == HAL_BOARD_LINUX #include #elif CONFIG_HAL_BOARD == HAL_BOARD_SITL #include #elif CONFIG_HAL_BOARD == HAL_BOARD_CHIBIOS #include #endif #include #define LOG_TAG "CANMGR" #define LOG_BUFFER_SIZE 1024 extern const AP_HAL::HAL& hal; // table of user settable parameters const AP_Param::GroupInfo AP_CANManager::var_info[] = { #if HAL_NUM_CAN_IFACES > 0 // @Group: P1_ // @Path: ../AP_CANManager/AP_CANIfaceParams.cpp AP_SUBGROUPINFO(_interfaces[0], "P1_", 1, AP_CANManager, AP_CANManager::CANIface_Params), #endif #if HAL_NUM_CAN_IFACES > 1 // @Group: P2_ // @Path: ../AP_CANManager/AP_CANIfaceParams.cpp AP_SUBGROUPINFO(_interfaces[1], "P2_", 2, AP_CANManager, AP_CANManager::CANIface_Params), #endif #if HAL_NUM_CAN_IFACES > 2 // @Group: P3_ // @Path: ../AP_CANManager/AP_CANIfaceParams.cpp AP_SUBGROUPINFO(_interfaces[2], "P3_", 3, AP_CANManager, AP_CANManager::CANIface_Params), #endif #if HAL_MAX_CAN_PROTOCOL_DRIVERS > 0 // @Group: D1_ // @Path: ../AP_CANManager/AP_CANDriver.cpp AP_SUBGROUPINFO(_drv_param[0], "D1_", 4, AP_CANManager, AP_CANManager::CANDriver_Params), #endif #if HAL_MAX_CAN_PROTOCOL_DRIVERS > 1 // @Group: D2_ // @Path: ../AP_CANManager/AP_CANDriver.cpp AP_SUBGROUPINFO(_drv_param[1], "D2_", 5, AP_CANManager, AP_CANManager::CANDriver_Params), #endif #if HAL_MAX_CAN_PROTOCOL_DRIVERS > 2 // @Group: D3_ // @Path: ../AP_CANManager/AP_CANDriver.cpp AP_SUBGROUPINFO(_drv_param[2], "D3_", 6, AP_CANManager, AP_CANManager::CANDriver_Params), #endif // @Group: SLCAN_ // @Path: ../AP_CANManager/AP_SLCANIface.cpp AP_SUBGROUPINFO(_slcan_interface, "SLCAN_", 7, AP_CANManager, SLCAN::CANIface), // @Param: LOGLEVEL // @DisplayName: Loglevel // @Description: Loglevel for recording initialisation and debug information from CAN Interface // @Range: 0 4 // @Values: 0: Log None, 1: Log Error, 2: Log Warning and below, 3: Log Info and below, 4: Log Everything // @User: Advanced AP_GROUPINFO("LOGLEVEL", 8, AP_CANManager, _loglevel, AP_CANManager::LOG_NONE), AP_GROUPEND }; AP_CANManager *AP_CANManager::_singleton; AP_CANManager::AP_CANManager() { AP_Param::setup_object_defaults(this, var_info); if (_singleton != nullptr) { AP_HAL::panic("AP_CANManager must be singleton"); } _singleton = this; } void AP_CANManager::init() { WITH_SEMAPHORE(_sem); #if CONFIG_HAL_BOARD == HAL_BOARD_SITL if (AP::sitl() != nullptr) { if (AP::sitl()->speedup > 1) { log_text(AP_CANManager::LOG_ERROR, LOG_TAG, "CAN is not supported under speedup."); return; } } else { AP_HAL::panic("CANManager: SITL not initialised!"); } #endif // We only allocate log buffer only when under debug if (_loglevel != AP_CANManager::LOG_NONE) { _log_buf = new char[LOG_BUFFER_SIZE]; _log_pos = 0; } //Reset all SLCAN related params that needs resetting at boot _slcan_interface.reset_params(); Driver_Type drv_type[HAL_MAX_CAN_PROTOCOL_DRIVERS] = {}; // loop through interfaces and allocate and initialise Iface, // Also allocate Driver objects, and add interfaces to them for (uint8_t i = 0; i < HAL_NUM_CAN_IFACES; i++) { // Get associated Driver to the interface uint8_t drv_num = _interfaces[i]._driver_number; if (drv_num == 0 || drv_num > HAL_MAX_CAN_PROTOCOL_DRIVERS) { continue; } drv_num--; if (hal.can[i] == nullptr) { // So if this interface is not allocated allocate it here, // also pass the index of the CANBus const_cast (hal).can[i] = new HAL_CANIface(i); } // Initialise the interface we just allocated if (hal.can[i] == nullptr) { continue; } AP_HAL::CANIface* iface = hal.can[i]; // Find the driver type that we need to allocate and register this interface with drv_type[drv_num] = (Driver_Type) _drv_param[drv_num]._driver_type.get(); bool can_initialised = false; // Check if this interface need hooking up to slcan passthrough // instead of a driver if (_slcan_interface.init_passthrough(i)) { // we have slcan bridge setup pass that on as can iface can_initialised = hal.can[i]->init(_interfaces[i]._bitrate, AP_HAL::CANIface::NormalMode); iface = &_slcan_interface; } else if(drv_type[drv_num] == Driver_Type_UAVCAN) { // We do Message ID filtering when using UAVCAN without SLCAN can_initialised = hal.can[i]->init(_interfaces[i]._bitrate, AP_HAL::CANIface::FilteredMode); } else { can_initialised = hal.can[i]->init(_interfaces[i]._bitrate, AP_HAL::CANIface::NormalMode); } if (!can_initialised) { log_text(AP_CANManager::LOG_ERROR, LOG_TAG, "Failed to initialise CAN Interface %d", i+1); continue; } log_text(AP_CANManager::LOG_INFO, LOG_TAG, "CAN Interface %d initialized well", i + 1); if (_drivers[drv_num] != nullptr) { //We already initialised the driver just add interface and move on log_text(AP_CANManager::LOG_INFO, LOG_TAG, "Adding Interface %d to Driver %d", i + 1, drv_num + 1); _drivers[drv_num]->add_interface(iface); continue; } if (_num_drivers >= HAL_MAX_CAN_PROTOCOL_DRIVERS) { // We are exceeding number of drivers, // this can't be happening time to panic AP_BoardConfig::config_error("Max number of CAN Drivers exceeded\n\r"); } // Allocate the set type of Driver if (drv_type[drv_num] == Driver_Type_UAVCAN) { _drivers[drv_num] = _drv_param[drv_num]._uavcan = new AP_UAVCAN; if (_drivers[drv_num] == nullptr) { AP_BoardConfig::allocation_error("uavcan %d", i + 1); continue; } AP_Param::load_object_from_eeprom((AP_UAVCAN*)_drivers[drv_num], AP_UAVCAN::var_info); } else if (drv_type[drv_num] == Driver_Type_KDECAN) { #if (APM_BUILD_COPTER_OR_HELI || APM_BUILD_TYPE(APM_BUILD_ArduPlane) || APM_BUILD_TYPE(APM_BUILD_ArduSub)) // To be replaced with macro saying if KDECAN library is included _drivers[drv_num] = _drv_param[drv_num]._kdecan = new AP_KDECAN; if (_drivers[drv_num] == nullptr) { AP_BoardConfig::allocation_error("KDECAN %d", drv_num + 1); continue; } AP_Param::load_object_from_eeprom((AP_KDECAN*)_drivers[drv_num], AP_KDECAN::var_info); #endif } else if (drv_type[drv_num] == Driver_Type_ToshibaCAN) { _drivers[drv_num] = new AP_ToshibaCAN; if (_drivers[drv_num] == nullptr) { AP_BoardConfig::allocation_error("ToshibaCAN %d", drv_num + 1); continue; } } else if (drv_type[drv_num] == Driver_Type_PiccoloCAN) { #if HAL_PICCOLO_CAN_ENABLE _drivers[drv_num] = _drv_param[drv_num]._piccolocan = new AP_PiccoloCAN; if (_drivers[drv_num] == nullptr) { AP_BoardConfig::allocation_error("PiccoloCAN %d", drv_num + 1); continue; } AP_Param::load_object_from_eeprom((AP_PiccoloCAN*)_drivers[drv_num], AP_PiccoloCAN::var_info); #endif } else if (drv_type[drv_num] == Driver_Type_CANTester) { #if HAL_NUM_CAN_IFACES > 1 && !HAL_MINIMIZE_FEATURES _drivers[drv_num] = _drv_param[drv_num]._testcan = new CANTester; if (_drivers[drv_num] == nullptr) { AP_BoardConfig::allocation_error("CANTester %d", drv_num + 1); continue; } AP_Param::load_object_from_eeprom((CANTester*)_drivers[drv_num], CANTester::var_info); #endif } else { continue; } _num_drivers++; // Hook this interface to the selected Driver Type _drivers[drv_num]->add_interface(iface); log_text(AP_CANManager::LOG_INFO, LOG_TAG, "Adding Interface %d to Driver %d", i + 1, drv_num + 1); } for (uint8_t drv_num = 0; drv_num < HAL_MAX_CAN_PROTOCOL_DRIVERS; drv_num++) { //initialise all the Drivers if (_drivers[drv_num] == nullptr) { continue; } bool enable_filter = false; for (uint8_t i = 0; i < HAL_NUM_CAN_IFACES; i++) { if (_interfaces[i]._driver_number == (drv_num+1) && hal.can[i] != nullptr && hal.can[i]->get_operating_mode() == AP_HAL::CANIface::FilteredMode) { // Don't worry we don't enable Filters for Normal Ifaces under the driver // this is just to ensure we enable them for the ones we already decided on enable_filter = true; break; } } _drivers[drv_num]->init(drv_num, enable_filter); // Finally initialise driver type, this will be used // to find and reference protocol drivers _driver_type_cache[drv_num] = drv_type[drv_num]; } } /* register a new CAN driver */ bool AP_CANManager::register_driver(Driver_Type dtype, AP_CANDriver *driver) { WITH_SEMAPHORE(_sem); for (uint8_t i = 0; i < HAL_NUM_CAN_IFACES; i++) { uint8_t drv_num = _interfaces[i]._driver_number; if (drv_num == 0 || drv_num > HAL_MAX_CAN_PROTOCOL_DRIVERS) { continue; } // from 1 based to 0 based drv_num--; if (dtype != (Driver_Type)_drv_param[drv_num]._driver_type.get()) { continue; } if (_drivers[drv_num] != nullptr) { continue; } if (_num_drivers >= HAL_MAX_CAN_PROTOCOL_DRIVERS) { continue; } if (hal.can[i] == nullptr) { // if this interface is not allocated allocate it here, // also pass the index of the CANBus const_cast (hal).can[i] = new HAL_CANIface(i); } // Initialise the interface we just allocated if (hal.can[i] == nullptr) { continue; } AP_HAL::CANIface* iface = hal.can[i]; _drivers[drv_num] = driver; _drivers[drv_num]->add_interface(iface); log_text(AP_CANManager::LOG_INFO, LOG_TAG, "Adding Interface %d to Driver %d", i + 1, drv_num + 1); _drivers[drv_num]->init(drv_num, false); _driver_type_cache[drv_num] = dtype; _num_drivers++; return true; } return false; } // Method used by CAN related library methods to report status and debug info // The result of this method can be accessed via ftp get @SYS/can_log.txt void AP_CANManager::log_text(AP_CANManager::LogLevel loglevel, const char *tag, const char *fmt, ...) { if (_log_buf == nullptr) { return; } if (loglevel > _loglevel) { return; } if ((LOG_BUFFER_SIZE - _log_pos) < (10 + strlen(tag) + strlen(fmt))) { // reset log pos _log_pos = 0; } //Tag Log Message switch (loglevel) { case AP_CANManager::LOG_DEBUG : _log_pos += hal.util->snprintf(&_log_buf[_log_pos], LOG_BUFFER_SIZE - _log_pos, "\n%s DEBUG :", tag); break; case AP_CANManager::LOG_INFO : _log_pos += hal.util->snprintf(&_log_buf[_log_pos], LOG_BUFFER_SIZE - _log_pos, "\n%s INFO :", tag); break; case AP_CANManager::LOG_WARNING : _log_pos += hal.util->snprintf(&_log_buf[_log_pos], LOG_BUFFER_SIZE - _log_pos, "\n%s WARN :", tag); break; case AP_CANManager::LOG_ERROR : _log_pos += hal.util->snprintf(&_log_buf[_log_pos], LOG_BUFFER_SIZE - _log_pos, "\n%s ERROR :", tag); break; default : return; } va_list arg_list; va_start(arg_list, fmt); _log_pos += hal.util->vsnprintf(&_log_buf[_log_pos], LOG_BUFFER_SIZE - _log_pos, fmt, arg_list); va_end(arg_list); } // log retrieve method used by file sys method to report can log void AP_CANManager::log_retrieve(ExpandingString &str) const { if (_log_buf == nullptr) { gcs().send_text(MAV_SEVERITY_ERROR, "Log buffer not available"); return; } str.append(_log_buf, _log_pos); } AP_CANManager& AP::can() { return *AP_CANManager::get_singleton(); } #endif