//============================================================================ // QP/C++ Real-Time Embedded Framework (RTEF) // Copyright (C) 2005 Quantum Leaps, LLC. All rights reserved. // // SPDX-License-Identifier: GPL-3.0-or-later OR LicenseRef-QL-commercial // // This software is dual-licensed under the terms of the open source GNU // General Public License version 3 (or any later version), or alternatively, // under the terms of one of the closed source Quantum Leaps commercial // licenses. // // The terms of the open source GNU General Public License version 3 // can be found at: // // The terms of the closed source Quantum Leaps commercial licenses // can be found at: // // Redistributions in source code must retain this top-level comment block. // Plagiarizing this software to sidestep the license obligations is illegal. // // Contact information: // // //============================================================================ //! @date Last updated on: 2023-12-13 //! @version Last updated for: @ref qpcpp_7_3_2 //! //! @file //! @brief QUTEST port for Windows, GNU or Visual C++ #ifndef Q_SPY #error "Q_SPY must be defined for QUTest application" #endif // Q_SPY #define QP_IMPL // this is QP implementation #include "qp_port.hpp" // QP port #include "qsafe.h" // QP Functional Safety (FuSa) Subsystem #include "qs_port.hpp" // QS port #include "safe_std.h" // portable "safe" / facilities #include #include #include // Minimum required Windows version is Windows-XP or newer (0x0501) #ifdef WINVER #undef WINVER #endif #ifdef _WIN32_WINNT #undef _WIN32_WINNT #endif #define WINVER _WIN32_WINNT_WINXP #define _WIN32_WINNT _WIN32_WINNT_WINXP #include #define QS_TX_SIZE (8*1024) #define QS_RX_SIZE (2*1024) #define QS_TX_CHUNK QS_TX_SIZE #define QS_TIMEOUT_MS 10 namespace { // unnamed local namespace //Q_DEFINE_THIS_MODULE("qutest_port") // local variables ........................................................... static SOCKET l_sock = INVALID_SOCKET; } // unnamed local namespace //============================================================================ namespace QP { //............................................................................ bool QS::onStartup(void const *arg) { static uint8_t qsBuf[QS_TX_SIZE]; // buffer for QS-TX channel initBuf(qsBuf, sizeof(qsBuf)); static uint8_t qsRxBuf[QS_RX_SIZE]; // buffer for QS-RX channel rxInitBuf(qsRxBuf, sizeof(qsRxBuf)); char hostName[128]; char const *serviceName = "6601"; // default QSPY server port char const *src; char *dst; int status; struct addrinfo *result = NULL; struct addrinfo *rp = NULL; struct addrinfo hints; BOOL sockopt_bool; ULONG ioctl_opt; WSADATA wsaData; // initialize Windows sockets version 2.2 if (WSAStartup(MAKEWORD(2, 2), &wsaData) != NO_ERROR) { FPRINTF_S(stderr, " ERROR %s\n", "Windows Sockets cannot be initialized"); goto error; } // extract hostName from 'arg' (hostName:port_remote)... src = (arg != (void *)0) ? (char const *)arg : "localhost"; // default QSPY host dst = hostName; while ((*src != '\0') && (*src != ':') && (dst < &hostName[sizeof(hostName) - 1])) { *dst++ = *src++; } *dst = '\0'; // zero-terminate hostName // extract serviceName from 'arg' (hostName:serviceName)... if (*src == ':') { serviceName = src + 1; } //printf(" Connecting to QSPY on Host=%s:%s...\n", // hostName, serviceName); memset(&hints, 0, sizeof(hints)); hints.ai_family = AF_INET; hints.ai_socktype = SOCK_STREAM; hints.ai_protocol = IPPROTO_TCP; status = getaddrinfo(hostName, serviceName, &hints, &result); if (status != 0) { FPRINTF_S(stderr, " ERROR cannot resolve host Name=%s:%s,Err=%d\n", hostName, serviceName, status); goto error; } for (rp = result; rp != NULL; rp = rp->ai_next) { l_sock = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol); if (l_sock != INVALID_SOCKET) { if (connect(l_sock, rp->ai_addr, static_cast(rp->ai_addrlen)) == SOCKET_ERROR) { closesocket(l_sock); l_sock = INVALID_SOCKET; } break; } } freeaddrinfo(result); // socket could not be opened & connected? if (l_sock == INVALID_SOCKET) { FPRINTF_S(stderr, " ERROR cannot connect to QSPY at " "host=%s:%s\n", hostName, serviceName); goto error; } // set the socket to non-blocking mode ioctl_opt = 1; if (ioctlsocket(l_sock, FIONBIO, &ioctl_opt) != NO_ERROR) { FPRINTF_S(stderr, " ERROR %s WASErr=%d\n,", "Failed to set non-blocking socket", WSAGetLastError()); QF::stop(); // <== stop and exit the application goto error; } // configure the socket to reuse the address and not to linger sockopt_bool = TRUE; setsockopt(l_sock, SOL_SOCKET, SO_REUSEADDR, (const char *)&sockopt_bool, sizeof(sockopt_bool)); sockopt_bool = TRUE; setsockopt(l_sock, SOL_SOCKET, SO_DONTLINGER, (const char *)&sockopt_bool, sizeof(sockopt_bool)); //PRINTF_S(" Connected to QSPY at Host=%s:%d\n", // hostName, port_remote); onFlush(); return true; // success error: return false; // failure } //............................................................................ void QS::onCleanup() { Sleep(QS_TIMEOUT_MS * 10U); // allow the last QS output to come out if (l_sock != INVALID_SOCKET) { closesocket(l_sock); l_sock = INVALID_SOCKET; } WSACleanup(); //PRINTF_S("%s\n", " Disconnected from QSPY"); } //............................................................................ void QS::onReset() { onCleanup(); //PRINTF_S("\n%s\n", "QS_onReset"); exit(0); } //............................................................................ // NOTE: // No critical section in QS::onFlush() to avoid nesting of critical sections // in case QS::onFlush() is called from Q_onError(). void QS::onFlush() { if (l_sock == INVALID_SOCKET) { // socket NOT initialized? FPRINTF_S(stderr, " ERROR %s\n", "invalid TCP socket"); QF::stop(); // <== stop and exit the application return; } std::uint16_t nBytes = QS_TX_CHUNK; std::uint8_t const *data; while ((data = getBlock(&nBytes)) != nullptr) { for (;;) { // for-ever until break or return int nSent = send(l_sock, (char const *)data, (int)nBytes, 0); if (nSent == SOCKET_ERROR) { // sending failed? int err = WSAGetLastError(); if (err == WSAEWOULDBLOCK) { // sleep for the timeout and then loop back // to send() the SAME data again Sleep(QS_TIMEOUT_MS); } else { // some other socket error... FPRINTF_S(stderr, " ERROR sending data over TCP," "errno=%d\n", errno); QF::stop(); // <== stop and exit the application return; } } else if (nSent < (int)nBytes) { // sent fewer than requested? Sleep(QS_TIMEOUT_MS); // sleep for the timeout // adjust the data and loop back to send() the rest data += nSent; nBytes -= (uint16_t)nSent; } else { break; // break out of the for-ever loop } } // set nBytes for the next call to QS::getBlock() nBytes = QS_TX_CHUNK; } } //............................................................................ void QS::onTestLoop() { fd_set readSet; FD_ZERO(&readSet); rxPriv_.inTestLoop = true; while (rxPriv_.inTestLoop) { FD_SET(l_sock, &readSet); struct timeval timeout = { (long)0, (long)(QS_TIMEOUT_MS * 1000) }; // selective, timed blocking on the TCP/IP socket... int status = select(0, &readSet, (fd_set *)0, (fd_set *)0, &timeout); if (status == SOCKET_ERROR) { FPRINTF_S(stderr, " ERROR socket select,WSAErr=%d", WSAGetLastError()); QF::stop(); // <== stop and exit the application } else if (FD_ISSET(l_sock, &readSet)) { // socket ready? status = recv(l_sock, (char *)QS::rxPriv_.buf, (int)QS::rxPriv_.end, 0); if (status > 0) { // any data received? QS::rxPriv_.tail = 0U; QS::rxPriv_.head = status; // # bytes received QS::rxParse(); // parse all received bytes } } onFlush(); wint_t ch = 0; while (_kbhit()) { // any key pressed? ch = _getwch(); } switch (ch) { case 'x': // 'x' pressed? case 'X': // 'X' pressed? case '\033': { // ESC pressed? onCleanup(); exit(1); break; } } } // set inTestLoop to true in case calls to QS_onTestLoop() nest, // which can happen through the calls to QS_TEST_PAUSE(). rxPriv_.inTestLoop = true; } } // namespace QP