/**************************************************************************** * * Copyright (c) 2014 PX4 Development Team. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name PX4 nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ /** * @file ver.cpp * * Version command, unifies way of showing versions of HW, SW, Build, GCC * In case you want to add new version just extend version_main function * * @author Vladimir Kulla */ #include #include #include #include #include #include /* string constants for version commands */ static const char sz_ver_hw_str[] = "hw"; static const char sz_ver_hwcmp_str[] = "hwcmp"; static const char sz_ver_hwtypecmp_str[] = "hwtypecmp"; #if defined(BOARD_HAS_HW_SPLIT_VERSIONING) static const char sz_ver_hwbasecmp_str[] = "hwbasecmp"; #endif static const char sz_ver_git_str[] = "git"; static const char sz_ver_bdate_str[] = "bdate"; static const char sz_ver_buri_str[] = "uri"; static const char sz_ver_gcc_str[] = "gcc"; static const char sz_ver_all_str[] = "all"; static const char mcu_ver_str[] = "mcu"; static const char px4_guid_str[] = "px4guid"; static void usage(const char *reason) { if (reason != nullptr) { PX4_INFO_RAW("%s\n", reason); } PRINT_MODULE_DESCRIPTION("Tool to print various version information"); PRINT_MODULE_USAGE_NAME("ver", "command"); PRINT_MODULE_USAGE_COMMAND_DESCR("hw", "Hardware architecture"); PRINT_MODULE_USAGE_COMMAND_DESCR("mcu", "MCU info"); PRINT_MODULE_USAGE_COMMAND_DESCR("git", "git version information"); PRINT_MODULE_USAGE_COMMAND_DESCR("bdate", "Build date and time"); PRINT_MODULE_USAGE_COMMAND_DESCR("gcc", "Compiler info"); PRINT_MODULE_USAGE_COMMAND_DESCR("bdate", "Build date and time"); PRINT_MODULE_USAGE_COMMAND_DESCR("px4guid", "PX4 GUID"); PRINT_MODULE_USAGE_COMMAND_DESCR("uri", "Build URI"); PRINT_MODULE_USAGE_COMMAND_DESCR("all", "Print all versions"); PRINT_MODULE_USAGE_COMMAND_DESCR("hwcmp", "Compare hardware version (returns 0 on match)"); PRINT_MODULE_USAGE_ARG(" []", "Hardware to compare against (eg. PX4_FMU_V4). An OR comparison is used if multiple are specified", false); PRINT_MODULE_USAGE_COMMAND_DESCR("hwtypecmp", "Compare hardware type (returns 0 on match)"); PRINT_MODULE_USAGE_ARG(" []", "Hardware type to compare against (eg. V2). An OR comparison is used if multiple are specified", false); #if defined(BOARD_HAS_HW_SPLIT_VERSIONING) PRINT_MODULE_USAGE_COMMAND_DESCR("hwbasecmp", "Compare hardware base (returns 0 on match)"); PRINT_MODULE_USAGE_ARG(" []", "Hardware type to compare against (eg. V2). An OR comparison is used if multiple are specified", false); #endif } extern "C" __EXPORT int ver_main(int argc, char *argv[]) { /* defaults to an error */ int ret = 1; /* first check if there are at least 2 params */ if (argc >= 2) { if (argv[1] != nullptr) { if (!strncmp(argv[1], sz_ver_hwcmp_str, sizeof(sz_ver_hwcmp_str))) { if (argc >= 3 && argv[2] != nullptr) { const char *board_name = px4_board_name(); for (int i = 2; i < argc; ++i) { if (strcmp(board_name, argv[i]) == 0) { return 0; // if one of the arguments match, return success } } } else { PX4_ERR("Not enough arguments, try 'ver hwcmp PX4_FMU_V2'"); } return 1; } if (!strncmp(argv[1], sz_ver_hwtypecmp_str, sizeof(sz_ver_hwtypecmp_str))) { if (argc >= 3 && argv[2] != nullptr) { const char *board_type = px4_board_sub_type(); for (int i = 2; i < argc; ++i) { if (strcmp(board_type, argv[i]) == 0) { return 0; // if one of the arguments match, return success } } } else { PX4_ERR("Not enough arguments, try 'ver hwtypecmp {V2|V2M|V30|V31}'"); } return 1; } #if defined(BOARD_HAS_HW_SPLIT_VERSIONING) if (!strncmp(argv[1], sz_ver_hwbasecmp_str, sizeof(sz_ver_hwbasecmp_str))) { if (argc >= 3 && argv[2] != nullptr) { const char *board_type = px4_board_base_type(); for (int i = 2; i < argc; ++i) { if (strcmp(board_type, argv[i]) == 0) { return 0; // if one of the arguments match, return success } } } else { PX4_ERR("Not enough arguments, try 'ver hwbasecmp {000...999}[1:*]'"); } return 1; } #endif /* check if we want to show all */ bool show_all = !strncmp(argv[1], sz_ver_all_str, sizeof(sz_ver_all_str)); if (show_all || !strncmp(argv[1], sz_ver_hw_str, sizeof(sz_ver_hw_str))) { PX4_INFO_RAW("HW arch: %s\n", px4_board_name()); #if defined(BOARD_HAS_HW_SPLIT_VERSIONING) char sbase[14] = "NA"; char sfmum[14] = "NA"; int base = GET_HW_BASE_ID(); int fmu = GET_HW_FMUM_ID(); if (base >= 0) { snprintf(sbase, sizeof(sbase), "0x%0" STRINGIFY(HW_INFO_VER_DIGITS) "X", base); } if (fmu >= 0) { snprintf(sfmum, sizeof(sfmum), "0x%0" STRINGIFY(HW_INFO_REV_DIGITS) "X", fmu); } PX4_INFO_RAW("HW type: %s\n", strlen(HW_INFO_INIT_PREFIX) ? HW_INFO_INIT_PREFIX : "NA"); PX4_INFO_RAW("HW FMUM ID: %s\n", sfmum); PX4_INFO_RAW("HW BASE ID: %s\n", sbase); #elif defined(BOARD_HAS_VERSIONING) char vb[14] = "NA"; char rb[14] = "NA"; int v = px4_board_hw_version(); int r = px4_board_hw_revision(); if (v >= 0) { snprintf(vb, sizeof(vb), "0x%0" STRINGIFY(HW_INFO_VER_DIGITS) "X", v); } if (r >= 0) { snprintf(rb, sizeof(rb), "0x%0" STRINGIFY(HW_INFO_REV_DIGITS) "X", r); } PX4_INFO_RAW("HW type: %s\n", strlen(px4_board_sub_type()) ? px4_board_sub_type() : "NA"); PX4_INFO_RAW("HW version: %s\n", vb); PX4_INFO_RAW("HW revision: %s\n", rb); #endif ret = 0; } if (show_all || !strncmp(argv[1], sz_ver_git_str, sizeof(sz_ver_git_str))) { PX4_INFO_RAW("PX4 git-hash: %s\n", px4_firmware_version_string()); unsigned fwver = px4_firmware_version(); unsigned major = (fwver >> (8 * 3)) & 0xFF; unsigned minor = (fwver >> (8 * 2)) & 0xFF; unsigned patch = (fwver >> (8 * 1)) & 0xFF; unsigned type = (fwver >> (8 * 0)) & 0xFF; if (type == 255) { PX4_INFO_RAW("PX4 version: Release %u.%u.%u (%u)\n", major, minor, patch, fwver); } else { PX4_INFO_RAW("PX4 version: %u.%u.%u %x (%u)\n", major, minor, patch, type, fwver); } if (show_all) { const char *git_branch = px4_firmware_git_branch(); if (git_branch && git_branch[0]) { PX4_INFO_RAW("PX4 git-branch: %s\n", git_branch); } } fwver = px4_firmware_vendor_version(); // Only display vendor version if it is non-zero if (fwver & 0xFFFFFF00) { major = (fwver >> (8 * 3)) & 0xFF; minor = (fwver >> (8 * 2)) & 0xFF; patch = (fwver >> (8 * 1)) & 0xFF; type = (fwver >> (8 * 0)) & 0xFF; PX4_INFO_RAW("Vendor version: %u.%u.%u %u (%u)\n", major, minor, patch, type, fwver); } fwver = px4_os_version(); major = (fwver >> (8 * 3)) & 0xFF; minor = (fwver >> (8 * 2)) & 0xFF; patch = (fwver >> (8 * 1)) & 0xFF; type = (fwver >> (8 * 0)) & 0xFF; PX4_INFO_RAW("OS: %s\n", px4_os_name()); if (type == 255) { PX4_INFO_RAW("OS version: Release %u.%u.%u (%u)\n", major, minor, patch, fwver); } else { PX4_INFO_RAW("OS version: %u.%u.%u %u (%u)\n", major, minor, patch, type, fwver); } const char *os_git_hash = px4_os_version_string(); if (os_git_hash) { PX4_INFO_RAW("OS git-hash: %s\n", os_git_hash); } ret = 0; } if (show_all || !strncmp(argv[1], sz_ver_bdate_str, sizeof(sz_ver_bdate_str))) { PX4_INFO_RAW("Build datetime: %s %s\n", __DATE__, __TIME__); ret = 0; } if (show_all || !strncmp(argv[1], sz_ver_buri_str, sizeof(sz_ver_buri_str))) { PX4_INFO_RAW("Build uri: %s\n", px4_build_uri()); ret = 0; } if (show_all) { PX4_INFO_RAW("Build variant: %s\n", px4_board_target_label()); } if (show_all || !strncmp(argv[1], sz_ver_gcc_str, sizeof(sz_ver_gcc_str))) { PX4_INFO_RAW("Toolchain: %s, %s\n", px4_toolchain_name(), px4_toolchain_version()); ret = 0; } if (show_all || !strncmp(argv[1], px4_guid_str, sizeof(px4_guid_str))) { char px4guid_fmt_buffer[PX4_GUID_FORMAT_SIZE]; board_get_px4_guid_formated(px4guid_fmt_buffer, sizeof(px4guid_fmt_buffer)); PX4_INFO_RAW("PX4GUID: %s\n", px4guid_fmt_buffer); ret = 0; } if (show_all || !strncmp(argv[1], mcu_ver_str, sizeof(mcu_ver_str))) { char rev = ' '; const char *revstr = nullptr; const char *errata = nullptr; int chip_version = board_mcu_version(&rev, &revstr, &errata); if (chip_version < 0) { PX4_INFO_RAW("UNKNOWN MCU\n"); } else { PX4_INFO_RAW("MCU: %s, rev. %c\n", revstr, rev); if (errata != nullptr) { printf("\nWARNING WARNING WARNING!\n" "Revision %c has a silicon errata:\n" "%s" "\nhttps://docs.px4.io/main/en/flight_controller/silicon_errata.html\n\n", rev, errata); } } ret = 0; } if (ret == 1) { PX4_ERR("unknown command"); return 1; } } else { usage("Error, input parameter NULL."); } } else { usage("Error, not enough parameters."); } return ret; }