Compare commits
13 Commits
main
...
ad532419fb
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ad532419fb | ||
|
|
dfb399bbba | ||
|
|
aaf69c0949 | ||
|
|
ec29bd5148 | ||
|
|
56bb3536fc | ||
|
|
6b1fc59fc0 | ||
|
|
253a4989f9 | ||
|
|
04fb98bc74 | ||
|
|
3ad581d13b | ||
|
|
38bb971bc4 | ||
|
|
87b9ccebfd | ||
|
|
817d7276b7 | ||
|
|
955eb02924 |
61
API.md
Normal file
61
API.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# API Documentation
|
||||
|
||||
## 1. TCP Control Interface (Port 8080)
|
||||
|
||||
### 1.1 `TREE`
|
||||
Retrieves the full object hierarchy.
|
||||
- **Request:** `TREE
|
||||
`
|
||||
- **Response:** `JSON_OBJECT
|
||||
OK TREE
|
||||
`
|
||||
|
||||
### 1.2 `DISCOVER`
|
||||
Lists all registrable signals and their metadata.
|
||||
- **Request:** `DISCOVER
|
||||
`
|
||||
- **Response:** `{"Signals": [...]}
|
||||
OK DISCOVER
|
||||
`
|
||||
|
||||
### 1.3 `TRACE <path> <state>`
|
||||
Enables/disables telemetry for a signal.
|
||||
- **Example:** `TRACE App.Data.Timer.Counter 1
|
||||
`
|
||||
- **Response:** `OK TRACE <match_count>
|
||||
`
|
||||
|
||||
### 1.4 `FORCE <path> <value>`
|
||||
Overrides a signal value in memory.
|
||||
- **Example:** `FORCE App.Data.DDB.Signal 123.4
|
||||
`
|
||||
- **Response:** `OK FORCE <match_count>
|
||||
`
|
||||
|
||||
### 1.5 `PAUSE` / `RESUME`
|
||||
Controls global execution state via the Scheduler.
|
||||
- **Request:** `PAUSE
|
||||
`
|
||||
- **Response:** `OK
|
||||
`
|
||||
|
||||
---
|
||||
|
||||
## 2. UDP Telemetry Format (Port 8081)
|
||||
|
||||
Telemetry packets are Little-Endian and use `#pragma pack(1)`.
|
||||
|
||||
### 2.1 TraceHeader (20 Bytes)
|
||||
| Offset | Type | Name | Description |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| 0 | uint32 | magic | Always `0xDA7A57AD` |
|
||||
| 4 | uint32 | seq | Incremental sequence number |
|
||||
| 8 | uint64 | timestamp | High-resolution timestamp |
|
||||
| 16 | uint32 | count | Number of samples in payload |
|
||||
|
||||
### 2.2 Sample Entry
|
||||
| Offset | Type | Name | Description |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| 0 | uint32 | id | Internal Signal ID (from `DISCOVER`) |
|
||||
| 4 | uint32 | size | Data size in bytes |
|
||||
| 8 | Bytes | data | Raw signal memory |
|
||||
44
ARCHITECTURE.md
Normal file
44
ARCHITECTURE.md
Normal file
@@ -0,0 +1,44 @@
|
||||
# System Architecture
|
||||
|
||||
## 1. Overview
|
||||
The suite consists of a C++ server library (`libmarte_dev.so`) that instrument MARTe2 applications at runtime, and a native Rust client for visualization.
|
||||
|
||||
## 2. Core Mechanism: Registry Patching
|
||||
The "Zero-Code-Change" requirement is met by intercepting the MARTe2 `ClassRegistryDatabase`. When the `DebugService` initializes, it replaces the standard object builders for critical classes:
|
||||
|
||||
1. **Broker Injection:** Standard Brokers (e.g., `MemoryMapInputBroker`) are replaced with `DebugBrokerWrapper`. This captures data every time a GAM reads or writes a signal.
|
||||
2. **Scheduler Injection:** The `FastScheduler` is replaced with `DebugFastScheduler`. This provides hooks at the start/end of each real-time cycle for execution control (pausing).
|
||||
|
||||
## 3. Communication Layer
|
||||
The system uses three distinct channels:
|
||||
|
||||
### 3.1 Command & Control (TCP Port 8080)
|
||||
- **Protocol:** Text-based over TCP.
|
||||
- **Role:** Object tree discovery (`TREE`), signal metadata (`DISCOVER`), and trace activation (`TRACE`).
|
||||
- **Response Format:** JSON for complex data, `OK/ERROR` for status.
|
||||
|
||||
### 3.2 High-Speed Telemetry (UDP Port 8081)
|
||||
- **Protocol:** Binary over UDP.
|
||||
- **Format:** Packed C-structs.
|
||||
- **Header:** `[Magic:4][Seq:4][TS:8][Count:4]` (Packed, 20 bytes).
|
||||
- **Payload:** `[ID:4][Size:4][Data:N]` (Repeated for each traced signal).
|
||||
|
||||
### 3.3 Log Streaming (TCP Port 8082)
|
||||
- **Protocol:** Real-time event streaming.
|
||||
- **Service:** `TcpLogger` (Standalone component).
|
||||
- **Role:** Forwards global `REPORT_ERROR` calls and `stdout` messages to the GUI client.
|
||||
|
||||
## 4. Component Diagram
|
||||
```text
|
||||
[ MARTe2 App ] <--- [ DebugFastScheduler ] (Registry Patch)
|
||||
| |
|
||||
+ <--- [ DebugBrokerWrapper ] (Registry Patch)
|
||||
| |
|
||||
+---------------------+
|
||||
| |
|
||||
[ DebugService ] [ TcpLogger ]
|
||||
| |
|
||||
+--- (TCP 8080) ------+-----> [ Rust GUI Client ]
|
||||
+--- (UDP 8081) ------+-----> [ (Oscilloscope) ]
|
||||
+--- (TCP 8082) ------+-----> [ (Log Terminal) ]
|
||||
```
|
||||
@@ -15,8 +15,16 @@ add_definitions(-DENVIRONMENT=Linux)
|
||||
add_definitions(-DMARTe2_TEST_ENVIRONMENT=GTest) # Optional
|
||||
add_definitions(-DUSE_PTHREAD)
|
||||
|
||||
# Add -pthread flag
|
||||
# Add -pthread and coverage flags
|
||||
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -pthread")
|
||||
if(CMAKE_COMPILER_IS_GNUCXX)
|
||||
option(ENABLE_COVERAGE "Enable coverage reporting" OFF)
|
||||
if(ENABLE_COVERAGE)
|
||||
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} --coverage -fprofile-arcs -ftest-coverage")
|
||||
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} --coverage")
|
||||
set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} --coverage")
|
||||
endif()
|
||||
endif()
|
||||
|
||||
include_directories(
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L0Types
|
||||
@@ -35,6 +43,7 @@ include_directories(
|
||||
${MARTe2_DIR}/Source/Core/Scheduler/L4LoggerService
|
||||
${MARTe2_DIR}/Source/Core/FileSystem/L1Portability
|
||||
${MARTe2_DIR}/Source/Core/FileSystem/L3Streams
|
||||
${MARTe2_DIR}/Source/Core/Scheduler/L5GAMs
|
||||
${MARTe2_Components_DIR}/Source/Components/DataSources/EpicsDataSource
|
||||
${MARTe2_Components_DIR}/Source/Components/DataSources/FileDataSource
|
||||
${MARTe2_Components_DIR}/Source/Components/GAMs/IOGAM
|
||||
|
||||
32
DEMO.md
Normal file
32
DEMO.md
Normal file
@@ -0,0 +1,32 @@
|
||||
# Demo Walkthrough: High-Speed Tracing
|
||||
|
||||
This demo demonstrates tracing a `Timer.Counter` signal at 100Hz and verifying its consistency.
|
||||
|
||||
### 1. Launch the Test Environment
|
||||
Start the validation environment which simulates a real-time app:
|
||||
```bash
|
||||
./Build/Test/Integration/ValidationTest
|
||||
```
|
||||
*Note: The test will wait for a trace command before finishing.*
|
||||
|
||||
### 2. Connect the GUI
|
||||
In another terminal:
|
||||
```bash
|
||||
cd Tools/gui_client
|
||||
cargo run --release
|
||||
```
|
||||
|
||||
### 3. Explore the Tree
|
||||
1. On the left panel (**Application Tree**), expand `Root.App.Data.Timer`.
|
||||
2. Click the `ℹ Info` button on the `Timer` node to see its configuration (e.g., `SleepTime: 10000`).
|
||||
|
||||
### 4. Activate Trace
|
||||
1. Locate the `Counter` signal under the `Timer` node.
|
||||
2. Click the **📈 Trace** button.
|
||||
3. The **Oscilloscope** in the center will immediately begin plotting the incremental counter.
|
||||
4. Verify the **UDP Packets** counter in the top bar is increasing rapidly.
|
||||
|
||||
### 5. Test Execution Control
|
||||
1. Click the **⏸ Pause** button in the top bar.
|
||||
2. Observe that the plot stops updating and the counter value holds steady.
|
||||
3. Click **▶ Resume** to continue execution.
|
||||
@@ -5,8 +5,9 @@
|
||||
#include "BrokerI.h"
|
||||
#include "MemoryMapBroker.h"
|
||||
#include "ObjectRegistryDatabase.h"
|
||||
#include "ReferenceT.h"
|
||||
#include "ObjectBuilder.h"
|
||||
#include "Vector.h"
|
||||
#include "FastPollingMutexSem.h"
|
||||
#include "HighResolutionTimer.h"
|
||||
|
||||
// Original broker headers
|
||||
@@ -19,39 +20,45 @@
|
||||
#include "MemoryMapMultiBufferOutputBroker.h"
|
||||
#include "MemoryMapSynchronisedMultiBufferInputBroker.h"
|
||||
#include "MemoryMapSynchronisedMultiBufferOutputBroker.h"
|
||||
#include "MemoryMapAsyncOutputBroker.h"
|
||||
#include "MemoryMapAsyncTriggerOutputBroker.h"
|
||||
|
||||
namespace MARTe {
|
||||
|
||||
/**
|
||||
* @brief Base implementation for all debug brokers.
|
||||
* @brief Helper for optimized signal processing within brokers.
|
||||
*/
|
||||
class DebugBrokerHelper {
|
||||
public:
|
||||
static void Process(BrokerI* broker, DebugService* service, DebugSignalInfo** signalInfoPointers, uint32 numSignals) {
|
||||
static void Process(DebugService* service, DebugSignalInfo** signalInfoPointers, Vector<uint32>& activeIndices, Vector<uint32>& activeSizes, FastPollingMutexSem& activeMutex) {
|
||||
if (service == NULL_PTR(DebugService*)) return;
|
||||
|
||||
// Re-establish break logic
|
||||
while (service->IsPaused()) {
|
||||
Sleep::MSec(10);
|
||||
}
|
||||
|
||||
if (signalInfoPointers != NULL_PTR(DebugSignalInfo**)) {
|
||||
for (uint32 i = 0; i < numSignals; i++) {
|
||||
DebugSignalInfo *s = signalInfoPointers[i];
|
||||
if (s != NULL_PTR(DebugSignalInfo*)) {
|
||||
if (s->isTracing || s->isForcing) {
|
||||
uint32 size = broker->GetCopyByteSize(i);
|
||||
service->ProcessSignal(s, size);
|
||||
}
|
||||
}
|
||||
activeMutex.FastLock();
|
||||
uint32 n = activeIndices.GetNumberOfElements();
|
||||
if (n > 0 && signalInfoPointers != NULL_PTR(DebugSignalInfo**)) {
|
||||
// Capture timestamp ONCE per broker cycle for lowest impact
|
||||
uint64 ts = (uint64)((float64)HighResolutionTimer::Counter() * HighResolutionTimer::Period() * 1000000.0);
|
||||
|
||||
for (uint32 i = 0; i < n; i++) {
|
||||
uint32 idx = activeIndices[i];
|
||||
uint32 size = activeSizes[i];
|
||||
DebugSignalInfo *s = signalInfoPointers[idx];
|
||||
service->ProcessSignal(s, size, ts);
|
||||
}
|
||||
}
|
||||
activeMutex.FastUnLock();
|
||||
}
|
||||
|
||||
static void InitSignals(MemoryMapBroker* broker, DataSourceI &dataSourceIn, DebugService* &service, DebugSignalInfo** &signalInfoPointers, uint32 &numSignals, MemoryMapBrokerCopyTableEntry* copyTable, const char8* functionName, SignalDirection direction) {
|
||||
numSignals = broker->GetNumberOfCopies();
|
||||
if (numSignals > 0) {
|
||||
signalInfoPointers = new DebugSignalInfo*[numSignals];
|
||||
for (uint32 i=0; i<numSignals; i++) signalInfoPointers[i] = NULL_PTR(DebugSignalInfo*);
|
||||
// Pass numCopies explicitly so we can mock it
|
||||
static void InitSignals(BrokerI* broker, DataSourceI &dataSourceIn, DebugService* &service, DebugSignalInfo** &signalInfoPointers, uint32 numCopies, MemoryMapBrokerCopyTableEntry* copyTable, const char8* functionName, SignalDirection direction, volatile bool* anyActiveFlag, Vector<uint32>* activeIndices, Vector<uint32>* activeSizes, FastPollingMutexSem* activeMutex) {
|
||||
if (numCopies > 0) {
|
||||
signalInfoPointers = new DebugSignalInfo*[numCopies];
|
||||
for (uint32 i=0; i<numCopies; i++) signalInfoPointers[i] = NULL_PTR(DebugSignalInfo*);
|
||||
}
|
||||
|
||||
ReferenceContainer *root = ObjectRegistryDatabase::Instance();
|
||||
@@ -63,21 +70,26 @@ public:
|
||||
if (service && (copyTable != NULL_PTR(MemoryMapBrokerCopyTableEntry*))) {
|
||||
StreamString dsPath;
|
||||
DebugService::GetFullObjectName(dataSourceIn, dsPath);
|
||||
MemoryMapBroker* mmb = dynamic_cast<MemoryMapBroker*>(broker);
|
||||
|
||||
for (uint32 i = 0; i < numSignals; i++) {
|
||||
for (uint32 i = 0; i < numCopies; i++) {
|
||||
void *addr = copyTable[i].dataSourcePointer;
|
||||
TypeDescriptor type = copyTable[i].type;
|
||||
|
||||
uint32 dsIdx = broker->GetDSCopySignalIndex(i);
|
||||
uint32 dsIdx = i;
|
||||
if (mmb != NULL_PTR(MemoryMapBroker*)) {
|
||||
dsIdx = mmb->GetDSCopySignalIndex(i);
|
||||
}
|
||||
|
||||
StreamString signalName;
|
||||
if (!dataSourceIn.GetSignalName(dsIdx, signalName)) signalName = "Unknown";
|
||||
|
||||
// 1. Register canonical DataSource name (Absolute)
|
||||
// Register canonical name
|
||||
StreamString dsFullName;
|
||||
dsFullName.Printf("%s.%s", dsPath.Buffer(), signalName.Buffer());
|
||||
service->RegisterSignal(addr, type, dsFullName.Buffer());
|
||||
|
||||
// 2. Also register absolute GAM alias
|
||||
// Register alias
|
||||
if (functionName != NULL_PTR(const char8*)) {
|
||||
StreamString gamFullName;
|
||||
const char8* dirStr = (direction == InputSignals) ? "In" : "Out";
|
||||
@@ -87,80 +99,216 @@ public:
|
||||
DebugService::GetFullObjectName(*(gamRef.operator->()), absGamPath);
|
||||
gamFullName.Printf("%s.%s.%s", absGamPath.Buffer(), dirStr, signalName.Buffer());
|
||||
} else {
|
||||
gamFullName.Printf("Root.%s.%s.%s", functionName, dirStr, signalName.Buffer());
|
||||
gamFullName.Printf("%s.%s.%s", functionName, dirStr, signalName.Buffer());
|
||||
}
|
||||
signalInfoPointers[i] = service->RegisterSignal(addr, type, gamFullName.Buffer());
|
||||
} else {
|
||||
signalInfoPointers[i] = service->RegisterSignal(addr, type, dsFullName.Buffer());
|
||||
}
|
||||
}
|
||||
|
||||
// Register broker in DebugService for optimized control
|
||||
service->RegisterBroker(signalInfoPointers, numCopies, mmb, anyActiveFlag, activeIndices, activeSizes, activeMutex);
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
#define DECLARE_DEBUG_BROKER_COMMON(BaseClass) \
|
||||
Debug##BaseClass() : BaseClass() { \
|
||||
service = NULL_PTR(DebugService*); \
|
||||
signalInfoPointers = NULL_PTR(DebugSignalInfo**); \
|
||||
numSignals = 0; \
|
||||
} \
|
||||
virtual ~Debug##BaseClass() { \
|
||||
if (signalInfoPointers) delete[] signalInfoPointers; \
|
||||
} \
|
||||
virtual bool Execute() { \
|
||||
bool ret = BaseClass::Execute(); \
|
||||
if (ret) DebugBrokerHelper::Process(this, service, signalInfoPointers, numSignals); \
|
||||
return ret; \
|
||||
} \
|
||||
private: \
|
||||
DebugService *service; \
|
||||
DebugSignalInfo **signalInfoPointers; \
|
||||
/**
|
||||
* @brief Template class to instrument any MARTe2 Broker.
|
||||
*/
|
||||
template <typename BaseClass>
|
||||
class DebugBrokerWrapper : public BaseClass {
|
||||
public:
|
||||
DebugBrokerWrapper() : BaseClass() {
|
||||
service = NULL_PTR(DebugService*);
|
||||
signalInfoPointers = NULL_PTR(DebugSignalInfo**);
|
||||
numSignals = 0;
|
||||
anyActive = false;
|
||||
}
|
||||
|
||||
virtual ~DebugBrokerWrapper() {
|
||||
if (signalInfoPointers) delete[] signalInfoPointers;
|
||||
}
|
||||
|
||||
virtual bool Execute() {
|
||||
bool ret = BaseClass::Execute();
|
||||
if (ret && (anyActive || (service && service->IsPaused()))) {
|
||||
DebugBrokerHelper::Process(service, signalInfoPointers, activeIndices, activeSizes, activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
virtual bool Init(SignalDirection direction, DataSourceI &ds, const char8 *const name, void *gamMem) {
|
||||
bool ret = BaseClass::Init(direction, ds, name, gamMem);
|
||||
if (ret) {
|
||||
numSignals = this->GetNumberOfCopies();
|
||||
DebugBrokerHelper::InitSignals(this, ds, service, signalInfoPointers, numSignals, this->copyTable, name, direction, &anyActive, &activeIndices, &activeSizes, &activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
virtual bool Init(SignalDirection direction, DataSourceI &ds, const char8 *const name, void *gamMem, const bool optim) {
|
||||
bool ret = BaseClass::Init(direction, ds, name, gamMem, optim);
|
||||
if (ret) {
|
||||
numSignals = this->GetNumberOfCopies();
|
||||
DebugBrokerHelper::InitSignals(this, ds, service, signalInfoPointers, numSignals, this->copyTable, name, direction, &anyActive, &activeIndices, &activeSizes, &activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
DebugService *service;
|
||||
DebugSignalInfo **signalInfoPointers;
|
||||
uint32 numSignals;
|
||||
|
||||
#define DECLARE_DEBUG_BROKER(BaseClass) \
|
||||
class Debug##BaseClass : public BaseClass { \
|
||||
public: \
|
||||
DECLARE_DEBUG_BROKER_COMMON(BaseClass) \
|
||||
virtual bool Init(SignalDirection direction, DataSourceI &ds, const char8 *const name, void *gamMem) { \
|
||||
bool ret = BaseClass::Init(direction, ds, name, gamMem); \
|
||||
if (ret) DebugBrokerHelper::InitSignals(this, ds, service, signalInfoPointers, numSignals, this->copyTable, name, direction); \
|
||||
return ret; \
|
||||
} \
|
||||
virtual bool Init(SignalDirection direction, DataSourceI &ds, const char8 *const name, void *gamMem, const bool optim) { \
|
||||
bool ret = BaseClass::Init(direction, ds, name, gamMem, optim); \
|
||||
if (ret) DebugBrokerHelper::InitSignals(this, ds, service, signalInfoPointers, numSignals, this->copyTable, name, direction); \
|
||||
return ret; \
|
||||
} \
|
||||
}; \
|
||||
class Debug##BaseClass##Builder : public ObjectBuilder { \
|
||||
public: \
|
||||
virtual Object *Build(HeapI* const heap) const { return new (heap) Debug##BaseClass(); } \
|
||||
volatile bool anyActive;
|
||||
Vector<uint32> activeIndices;
|
||||
Vector<uint32> activeSizes;
|
||||
FastPollingMutexSem activeMutex;
|
||||
};
|
||||
|
||||
#define DECLARE_DEBUG_BROKER_NO_OPTIM(BaseClass) \
|
||||
class Debug##BaseClass : public BaseClass { \
|
||||
public: \
|
||||
DECLARE_DEBUG_BROKER_COMMON(BaseClass) \
|
||||
virtual bool Init(SignalDirection direction, DataSourceI &ds, const char8 *const name, void *gamMem) { \
|
||||
bool ret = BaseClass::Init(direction, ds, name, gamMem); \
|
||||
if (ret) DebugBrokerHelper::InitSignals(this, ds, service, signalInfoPointers, numSignals, this->copyTable, name, direction); \
|
||||
return ret; \
|
||||
} \
|
||||
}; \
|
||||
class Debug##BaseClass##Builder : public ObjectBuilder { \
|
||||
public: \
|
||||
virtual Object *Build(HeapI* const heap) const { return new (heap) Debug##BaseClass(); } \
|
||||
template <typename BaseClass>
|
||||
class DebugBrokerWrapperNoOptim : public BaseClass {
|
||||
public:
|
||||
DebugBrokerWrapperNoOptim() : BaseClass() {
|
||||
service = NULL_PTR(DebugService*);
|
||||
signalInfoPointers = NULL_PTR(DebugSignalInfo**);
|
||||
numSignals = 0;
|
||||
anyActive = false;
|
||||
}
|
||||
|
||||
virtual ~DebugBrokerWrapperNoOptim() {
|
||||
if (signalInfoPointers) delete[] signalInfoPointers;
|
||||
}
|
||||
|
||||
virtual bool Execute() {
|
||||
bool ret = BaseClass::Execute();
|
||||
if (ret && (anyActive || (service && service->IsPaused()))) {
|
||||
DebugBrokerHelper::Process(service, signalInfoPointers, activeIndices, activeSizes, activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
virtual bool Init(SignalDirection direction, DataSourceI &ds, const char8 *const name, void *gamMem) {
|
||||
bool ret = BaseClass::Init(direction, ds, name, gamMem);
|
||||
if (ret) {
|
||||
numSignals = this->GetNumberOfCopies();
|
||||
DebugBrokerHelper::InitSignals(this, ds, service, signalInfoPointers, numSignals, this->copyTable, name, direction, &anyActive, &activeIndices, &activeSizes, &activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
DebugService *service;
|
||||
DebugSignalInfo **signalInfoPointers;
|
||||
uint32 numSignals;
|
||||
volatile bool anyActive;
|
||||
Vector<uint32> activeIndices;
|
||||
Vector<uint32> activeSizes;
|
||||
FastPollingMutexSem activeMutex;
|
||||
};
|
||||
|
||||
DECLARE_DEBUG_BROKER(MemoryMapInputBroker)
|
||||
DECLARE_DEBUG_BROKER(MemoryMapOutputBroker)
|
||||
DECLARE_DEBUG_BROKER(MemoryMapSynchronisedInputBroker)
|
||||
DECLARE_DEBUG_BROKER(MemoryMapSynchronisedOutputBroker)
|
||||
DECLARE_DEBUG_BROKER_NO_OPTIM(MemoryMapInterpolatedInputBroker)
|
||||
DECLARE_DEBUG_BROKER(MemoryMapMultiBufferInputBroker)
|
||||
DECLARE_DEBUG_BROKER(MemoryMapMultiBufferOutputBroker)
|
||||
DECLARE_DEBUG_BROKER(MemoryMapSynchronisedMultiBufferInputBroker)
|
||||
DECLARE_DEBUG_BROKER(MemoryMapSynchronisedMultiBufferOutputBroker)
|
||||
class DebugMemoryMapAsyncOutputBroker : public MemoryMapAsyncOutputBroker {
|
||||
public:
|
||||
DebugMemoryMapAsyncOutputBroker() : MemoryMapAsyncOutputBroker() {
|
||||
service = NULL_PTR(DebugService*);
|
||||
signalInfoPointers = NULL_PTR(DebugSignalInfo**);
|
||||
numSignals = 0;
|
||||
anyActive = false;
|
||||
}
|
||||
virtual ~DebugMemoryMapAsyncOutputBroker() {
|
||||
if (signalInfoPointers) delete[] signalInfoPointers;
|
||||
}
|
||||
virtual bool Execute() {
|
||||
bool ret = MemoryMapAsyncOutputBroker::Execute();
|
||||
if (ret && (anyActive || (service && service->IsPaused()))) {
|
||||
DebugBrokerHelper::Process(service, signalInfoPointers, activeIndices, activeSizes, activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
virtual bool InitWithBufferParameters(const SignalDirection direction, DataSourceI &dataSourceIn, const char8 * const functionName,
|
||||
void * const gamMemoryAddress, const uint32 numberOfBuffersIn, const ProcessorType& cpuMaskIn, const uint32 stackSizeIn) {
|
||||
bool ret = MemoryMapAsyncOutputBroker::InitWithBufferParameters(direction, dataSourceIn, functionName, gamMemoryAddress, numberOfBuffersIn, cpuMaskIn, stackSizeIn);
|
||||
if (ret) {
|
||||
numSignals = this->GetNumberOfCopies();
|
||||
DebugBrokerHelper::InitSignals(this, dataSourceIn, service, signalInfoPointers, numSignals, this->copyTable, functionName, direction, &anyActive, &activeIndices, &activeSizes, &activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
DebugService *service;
|
||||
DebugSignalInfo **signalInfoPointers;
|
||||
uint32 numSignals;
|
||||
volatile bool anyActive;
|
||||
Vector<uint32> activeIndices;
|
||||
Vector<uint32> activeSizes;
|
||||
FastPollingMutexSem activeMutex;
|
||||
};
|
||||
|
||||
class DebugMemoryMapAsyncTriggerOutputBroker : public MemoryMapAsyncTriggerOutputBroker {
|
||||
public:
|
||||
DebugMemoryMapAsyncTriggerOutputBroker() : MemoryMapAsyncTriggerOutputBroker() {
|
||||
service = NULL_PTR(DebugService*);
|
||||
signalInfoPointers = NULL_PTR(DebugSignalInfo**);
|
||||
numSignals = 0;
|
||||
anyActive = false;
|
||||
}
|
||||
virtual ~DebugMemoryMapAsyncTriggerOutputBroker() {
|
||||
if (signalInfoPointers) delete[] signalInfoPointers;
|
||||
}
|
||||
virtual bool Execute() {
|
||||
bool ret = MemoryMapAsyncTriggerOutputBroker::Execute();
|
||||
if (ret && (anyActive || (service && service->IsPaused()))) {
|
||||
DebugBrokerHelper::Process(service, signalInfoPointers, activeIndices, activeSizes, activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
virtual bool InitWithTriggerParameters(const SignalDirection direction, DataSourceI &dataSourceIn, const char8 * const functionName,
|
||||
void * const gamMemoryAddress, const uint32 numberOfBuffersIn, const uint32 preTriggerBuffersIn,
|
||||
const uint32 postTriggerBuffersIn, const ProcessorType& cpuMaskIn, const uint32 stackSizeIn) {
|
||||
bool ret = MemoryMapAsyncTriggerOutputBroker::InitWithTriggerParameters(direction, dataSourceIn, functionName, gamMemoryAddress, numberOfBuffersIn, preTriggerBuffersIn, postTriggerBuffersIn, cpuMaskIn, stackSizeIn);
|
||||
if (ret) {
|
||||
numSignals = this->GetNumberOfCopies();
|
||||
DebugBrokerHelper::InitSignals(this, dataSourceIn, service, signalInfoPointers, numSignals, this->copyTable, functionName, direction, &anyActive, &activeIndices, &activeSizes, &activeMutex);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
DebugService *service;
|
||||
DebugSignalInfo **signalInfoPointers;
|
||||
uint32 numSignals;
|
||||
volatile bool anyActive;
|
||||
Vector<uint32> activeIndices;
|
||||
Vector<uint32> activeSizes;
|
||||
FastPollingMutexSem activeMutex;
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
class DebugBrokerBuilder : public ObjectBuilder {
|
||||
public:
|
||||
virtual Object *Build(HeapI* const heap) const { return new (heap) T(); }
|
||||
};
|
||||
|
||||
typedef DebugBrokerWrapper<MemoryMapInputBroker> DebugMemoryMapInputBroker;
|
||||
// LCOV_EXCL_START
|
||||
typedef DebugBrokerWrapper<MemoryMapOutputBroker> DebugMemoryMapOutputBroker;
|
||||
typedef DebugBrokerWrapper<MemoryMapSynchronisedInputBroker> DebugMemoryMapSynchronisedInputBroker;
|
||||
typedef DebugBrokerWrapper<MemoryMapSynchronisedOutputBroker> DebugMemoryMapSynchronisedOutputBroker;
|
||||
typedef DebugBrokerWrapperNoOptim<MemoryMapInterpolatedInputBroker> DebugMemoryMapInterpolatedInputBroker;
|
||||
typedef DebugBrokerWrapper<MemoryMapMultiBufferInputBroker> DebugMemoryMapMultiBufferInputBroker;
|
||||
typedef DebugBrokerWrapper<MemoryMapMultiBufferOutputBroker> DebugMemoryMapMultiBufferOutputBroker;
|
||||
typedef DebugBrokerWrapper<MemoryMapSynchronisedMultiBufferInputBroker> DebugMemoryMapSynchronisedMultiBufferInputBroker;
|
||||
typedef DebugBrokerWrapper<MemoryMapSynchronisedMultiBufferOutputBroker> DebugMemoryMapSynchronisedMultiBufferOutputBroker;
|
||||
// LCOV_EXCL_STOP
|
||||
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapInputBroker> DebugMemoryMapInputBrokerBuilder;
|
||||
// LCOV_EXCL_START
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapOutputBroker> DebugMemoryMapOutputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapSynchronisedInputBroker> DebugMemoryMapSynchronisedInputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapSynchronisedOutputBroker> DebugMemoryMapSynchronisedOutputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapInterpolatedInputBroker> DebugMemoryMapInterpolatedInputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapMultiBufferInputBroker> DebugMemoryMapMultiBufferInputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapMultiBufferOutputBroker> DebugMemoryMapMultiBufferOutputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapSynchronisedMultiBufferInputBroker> DebugMemoryMapSynchronisedMultiBufferInputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapSynchronisedMultiBufferOutputBroker> DebugMemoryMapSynchronisedMultiBufferOutputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapAsyncOutputBroker> DebugMemoryMapAsyncOutputBrokerBuilder;
|
||||
typedef DebugBrokerBuilder<DebugMemoryMapAsyncTriggerOutputBroker> DebugMemoryMapAsyncTriggerOutputBrokerBuilder;
|
||||
// LCOV_EXCL_STOP
|
||||
|
||||
}
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
#include "CompilerTypes.h"
|
||||
#include "TypeDescriptor.h"
|
||||
#include "StreamString.h"
|
||||
#include "MemoryOperationsHelper.h"
|
||||
#include <cstring>
|
||||
|
||||
namespace MARTe {
|
||||
|
||||
@@ -29,6 +29,10 @@ struct TraceHeader {
|
||||
};
|
||||
#pragma pack(pop)
|
||||
|
||||
/**
|
||||
* @brief Ring buffer for high-frequency signal tracing.
|
||||
* @details New format per sample: [ID:4][Timestamp:8][Size:4][Data:N]
|
||||
*/
|
||||
class TraceRingBuffer {
|
||||
public:
|
||||
TraceRingBuffer() {
|
||||
@@ -55,43 +59,53 @@ public:
|
||||
return (buffer != NULL_PTR(uint8*));
|
||||
}
|
||||
|
||||
bool Push(uint32 signalID, void* data, uint32 size) {
|
||||
uint32 packetSize = 4 + 4 + size;
|
||||
bool Push(uint32 signalID, uint64 timestamp, void* data, uint32 size) {
|
||||
uint32 packetSize = 4 + 8 + 4 + size; // ID + TS + Size + Data
|
||||
uint32 read = readIndex;
|
||||
uint32 write = writeIndex;
|
||||
uint32 available = (read <= write) ? (bufferSize - (write - read) - 1) : (read - write - 1);
|
||||
|
||||
uint32 available = 0;
|
||||
if (read <= write) {
|
||||
available = bufferSize - (write - read) - 1;
|
||||
} else {
|
||||
available = read - write - 1;
|
||||
}
|
||||
|
||||
if (available < packetSize) return false;
|
||||
|
||||
// Use temporary write index to ensure atomic update
|
||||
uint32 tempWrite = write;
|
||||
WriteToBuffer(&tempWrite, &signalID, 4);
|
||||
WriteToBuffer(&tempWrite, ×tamp, 8);
|
||||
WriteToBuffer(&tempWrite, &size, 4);
|
||||
WriteToBuffer(&tempWrite, data, size);
|
||||
|
||||
// Final atomic update
|
||||
writeIndex = tempWrite;
|
||||
return true;
|
||||
}
|
||||
|
||||
bool Pop(uint32 &signalID, void* dataBuffer, uint32 &size, uint32 maxSize) {
|
||||
bool Pop(uint32 &signalID, uint64 ×tamp, void* dataBuffer, uint32 &size, uint32 maxSize) {
|
||||
uint32 read = readIndex;
|
||||
uint32 write = writeIndex;
|
||||
if (read == write) return false;
|
||||
|
||||
uint32 tempRead = read;
|
||||
uint32 tempId, tempSize;
|
||||
uint32 tempId = 0;
|
||||
uint64 tempTs = 0;
|
||||
uint32 tempSize = 0;
|
||||
|
||||
ReadFromBuffer(&tempRead, &tempId, 4);
|
||||
ReadFromBuffer(&tempRead, &tempTs, 8);
|
||||
ReadFromBuffer(&tempRead, &tempSize, 4);
|
||||
|
||||
if (tempSize > maxSize) {
|
||||
// Error case: drop data up to writeIndex
|
||||
readIndex = write;
|
||||
return false;
|
||||
}
|
||||
|
||||
ReadFromBuffer(&tempRead, dataBuffer, tempSize);
|
||||
|
||||
signalID = tempId;
|
||||
timestamp = tempTs;
|
||||
size = tempSize;
|
||||
|
||||
readIndex = tempRead;
|
||||
@@ -107,18 +121,30 @@ public:
|
||||
|
||||
private:
|
||||
void WriteToBuffer(uint32 *idx, void* src, uint32 count) {
|
||||
uint8* s = (uint8*)src;
|
||||
for (uint32 i=0; i<count; i++) {
|
||||
buffer[*idx] = s[i];
|
||||
*idx = (*idx + 1) % bufferSize;
|
||||
uint32 current = *idx;
|
||||
uint32 spaceToEnd = bufferSize - current;
|
||||
if (count <= spaceToEnd) {
|
||||
std::memcpy(&buffer[current], src, count);
|
||||
*idx = (current + count) % bufferSize;
|
||||
} else {
|
||||
std::memcpy(&buffer[current], src, spaceToEnd);
|
||||
uint32 remaining = count - spaceToEnd;
|
||||
std::memcpy(&buffer[0], (uint8*)src + spaceToEnd, remaining);
|
||||
*idx = remaining;
|
||||
}
|
||||
}
|
||||
|
||||
void ReadFromBuffer(uint32 *idx, void* dst, uint32 count) {
|
||||
uint8* d = (uint8*)dst;
|
||||
for (uint32 i=0; i<count; i++) {
|
||||
d[i] = buffer[*idx];
|
||||
*idx = (*idx + 1) % bufferSize;
|
||||
uint32 current = *idx;
|
||||
uint32 spaceToEnd = bufferSize - current;
|
||||
if (count <= spaceToEnd) {
|
||||
std::memcpy(dst, &buffer[current], count);
|
||||
*idx = (current + count) % bufferSize;
|
||||
} else {
|
||||
std::memcpy(dst, &buffer[current], spaceToEnd);
|
||||
uint32 remaining = count - spaceToEnd;
|
||||
std::memcpy((uint8*)dst + spaceToEnd, &buffer[0], remaining);
|
||||
*idx = remaining;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -1,8 +1,6 @@
|
||||
#ifndef DEBUGSERVICE_H
|
||||
#define DEBUGSERVICE_H
|
||||
|
||||
#include "DataSourceI.h"
|
||||
#include "GAM.h"
|
||||
#include "MessageI.h"
|
||||
#include "StreamString.h"
|
||||
#include "BasicUDPSocket.h"
|
||||
@@ -10,31 +8,31 @@
|
||||
#include "ReferenceContainer.h"
|
||||
#include "SingleThreadService.h"
|
||||
#include "EmbeddedServiceMethodBinderI.h"
|
||||
#include "FastMath.h"
|
||||
#include "CompilerTypes.h"
|
||||
#include "Object.h"
|
||||
#include "DebugCore.h"
|
||||
#include "ClassRegistryDatabase.h"
|
||||
#include "ErrorManagement.h"
|
||||
#include "AdvancedErrorManagement.h"
|
||||
#include "LoggerConsumerI.h"
|
||||
#include "Threads.h"
|
||||
#include "EventSem.h"
|
||||
|
||||
namespace MARTe {
|
||||
|
||||
struct LogEntry {
|
||||
ErrorManagement::ErrorInformation info;
|
||||
char8 description[MAX_ERROR_MESSAGE_SIZE];
|
||||
};
|
||||
class MemoryMapBroker;
|
||||
|
||||
struct SignalAlias {
|
||||
StreamString name;
|
||||
uint32 signalIndex;
|
||||
};
|
||||
|
||||
class DebugService : public ReferenceContainer, public MessageI, public EmbeddedServiceMethodBinderI, public LoggerConsumerI {
|
||||
struct BrokerInfo {
|
||||
DebugSignalInfo** signalPointers;
|
||||
uint32 numSignals;
|
||||
MemoryMapBroker* broker;
|
||||
volatile bool* anyActiveFlag;
|
||||
Vector<uint32>* activeIndices;
|
||||
Vector<uint32>* activeSizes;
|
||||
FastPollingMutexSem* activeMutex;
|
||||
};
|
||||
|
||||
class DebugService : public ReferenceContainer, public MessageI, public EmbeddedServiceMethodBinderI {
|
||||
public:
|
||||
friend class DebugServiceTest;
|
||||
CLASS_REGISTER_DECLARATION()
|
||||
|
||||
DebugService();
|
||||
@@ -43,36 +41,36 @@ public:
|
||||
virtual bool Initialise(StructuredDataI & data);
|
||||
|
||||
DebugSignalInfo* RegisterSignal(void* memoryAddress, TypeDescriptor type, const char8* name);
|
||||
void ProcessSignal(DebugSignalInfo* signalInfo, uint32 size);
|
||||
void ProcessSignal(DebugSignalInfo* signalInfo, uint32 size, uint64 timestamp);
|
||||
|
||||
void RegisterBroker(DebugSignalInfo** signalPointers, uint32 numSignals, MemoryMapBroker* broker, volatile bool* anyActiveFlag, Vector<uint32>* activeIndices, Vector<uint32>* activeSizes, FastPollingMutexSem* activeMutex);
|
||||
|
||||
virtual ErrorManagement::ErrorType Execute(ExecutionInfo & info);
|
||||
virtual void ConsumeLogMessage(LoggerPage *logPage);
|
||||
static void LogCallback(const ErrorManagement::ErrorInformation &errorInfo, const char8 * const errorDescription);
|
||||
void InsertLogIntoQueue(LoggerPage *logPage);
|
||||
|
||||
bool IsPaused() const { return isPaused; }
|
||||
void SetPaused(bool paused) { isPaused = paused; }
|
||||
|
||||
static bool GetFullObjectName(const Object &obj, StreamString &fullPath);
|
||||
|
||||
private:
|
||||
void HandleCommand(StreamString cmd, BasicTCPSocket *client);
|
||||
uint32 ForceSignal(const char8* name, const char8* valueStr);
|
||||
uint32 UnforceSignal(const char8* name);
|
||||
uint32 TraceSignal(const char8* name, bool enable, uint32 decimation = 1);
|
||||
void Discover(BasicTCPSocket *client);
|
||||
void ListNodes(const char8* path, BasicTCPSocket *client);
|
||||
void InfoNode(const char8* path, BasicTCPSocket *client);
|
||||
void ListNodes(const char8* path, BasicTCPSocket *client);
|
||||
|
||||
private:
|
||||
void HandleCommand(StreamString cmd, BasicTCPSocket *client);
|
||||
void UpdateBrokersActiveStatus();
|
||||
|
||||
uint32 ExportTree(ReferenceContainer *container, StreamString &json);
|
||||
void PatchRegistry();
|
||||
|
||||
ErrorManagement::ErrorType Server(ExecutionInfo & info);
|
||||
ErrorManagement::ErrorType Streamer(ExecutionInfo & info);
|
||||
ErrorManagement::ErrorType LogStreamer(ExecutionInfo & info);
|
||||
|
||||
uint16 controlPort;
|
||||
uint16 streamPort;
|
||||
uint16 logPort;
|
||||
StreamString streamIP;
|
||||
bool isServer;
|
||||
bool suppressTimeoutLogs;
|
||||
@@ -80,15 +78,13 @@ private:
|
||||
|
||||
BasicTCPSocket tcpServer;
|
||||
BasicUDPSocket udpSocket;
|
||||
BasicTCPSocket logServer;
|
||||
|
||||
class ServiceBinder : public EmbeddedServiceMethodBinderI {
|
||||
public:
|
||||
enum ServiceType { ServerType, StreamerType, LogStreamerType };
|
||||
enum ServiceType { ServerType, StreamerType };
|
||||
ServiceBinder(DebugService *parent, ServiceType type) : parent(parent), type(type) {}
|
||||
virtual ErrorManagement::ErrorType Execute(ExecutionInfo & info) {
|
||||
if (type == StreamerType) return parent->Streamer(info);
|
||||
if (type == LogStreamerType) return parent->LogStreamer(info);
|
||||
return parent->Server(info);
|
||||
}
|
||||
private:
|
||||
@@ -98,15 +94,12 @@ private:
|
||||
|
||||
ServiceBinder binderServer;
|
||||
ServiceBinder binderStreamer;
|
||||
ServiceBinder binderLogStreamer;
|
||||
|
||||
SingleThreadService threadService;
|
||||
SingleThreadService streamerService;
|
||||
SingleThreadService logStreamerService;
|
||||
|
||||
ThreadIdentifier serverThreadId;
|
||||
ThreadIdentifier streamerThreadId;
|
||||
ThreadIdentifier logStreamerThreadId;
|
||||
|
||||
static const uint32 MAX_SIGNALS = 4096;
|
||||
DebugSignalInfo signals[MAX_SIGNALS];
|
||||
@@ -116,6 +109,10 @@ private:
|
||||
SignalAlias aliases[MAX_ALIASES];
|
||||
uint32 numberOfAliases;
|
||||
|
||||
static const uint32 MAX_BROKERS = 1024;
|
||||
BrokerInfo brokers[MAX_BROKERS];
|
||||
uint32 numberOfBrokers;
|
||||
|
||||
FastPollingMutexSem mutex;
|
||||
TraceRingBuffer traceBuffer;
|
||||
|
||||
@@ -123,17 +120,7 @@ private:
|
||||
BasicTCPSocket* activeClients[MAX_CLIENTS];
|
||||
FastPollingMutexSem clientsMutex;
|
||||
|
||||
BasicTCPSocket* activeLogClients[MAX_CLIENTS];
|
||||
FastPollingMutexSem logClientsMutex;
|
||||
|
||||
static const uint32 LOG_QUEUE_SIZE = 1024;
|
||||
LogEntry logQueue[LOG_QUEUE_SIZE];
|
||||
volatile uint32 logQueueRead;
|
||||
volatile uint32 logQueueWrite;
|
||||
EventSem logEvent;
|
||||
|
||||
static DebugService* instance;
|
||||
static ErrorManagement::ErrorProcessFunctionType originalLogCallback;
|
||||
};
|
||||
|
||||
}
|
||||
|
||||
65
Headers/TcpLogger.h
Normal file
65
Headers/TcpLogger.h
Normal file
@@ -0,0 +1,65 @@
|
||||
#ifndef TCPLOGGER_H
|
||||
#define TCPLOGGER_H
|
||||
|
||||
#include "LoggerConsumerI.h"
|
||||
#include "ReferenceContainer.h"
|
||||
#include "EmbeddedServiceMethodBinderI.h"
|
||||
#include "BasicTCPSocket.h"
|
||||
#include "SingleThreadService.h"
|
||||
#include "FastPollingMutexSem.h"
|
||||
#include "EventSem.h"
|
||||
|
||||
namespace MARTe {
|
||||
|
||||
struct TcpLogEntry {
|
||||
ErrorManagement::ErrorInformation info;
|
||||
char8 description[MAX_ERROR_MESSAGE_SIZE];
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief Logger consumer that publishes framework logs to TCP and stdout.
|
||||
* @details Implements LoggerConsumerI to be used inside a LoggerService.
|
||||
*/
|
||||
class TcpLogger : public ReferenceContainer, public LoggerConsumerI, public EmbeddedServiceMethodBinderI {
|
||||
public:
|
||||
CLASS_REGISTER_DECLARATION()
|
||||
|
||||
TcpLogger();
|
||||
virtual ~TcpLogger();
|
||||
|
||||
virtual bool Initialise(StructuredDataI & data);
|
||||
|
||||
/**
|
||||
* @brief Implementation of LoggerConsumerI.
|
||||
* Called by LoggerService.
|
||||
*/
|
||||
virtual void ConsumeLogMessage(LoggerPage *logPage);
|
||||
|
||||
/**
|
||||
* @brief Worker thread method for TCP streaming.
|
||||
*/
|
||||
virtual ErrorManagement::ErrorType Execute(ExecutionInfo & info);
|
||||
|
||||
private:
|
||||
void InsertLogIntoQueue(const ErrorManagement::ErrorInformation &info, const char8 * const description);
|
||||
|
||||
uint16 port;
|
||||
BasicTCPSocket server;
|
||||
|
||||
static const uint32 MAX_CLIENTS = 8;
|
||||
BasicTCPSocket* activeClients[MAX_CLIENTS];
|
||||
FastPollingMutexSem clientsMutex;
|
||||
|
||||
SingleThreadService service;
|
||||
ThreadIdentifier workerThreadId;
|
||||
|
||||
static const uint32 QUEUE_SIZE = 1024;
|
||||
TcpLogEntry queue[QUEUE_SIZE];
|
||||
volatile uint32 readIdx;
|
||||
volatile uint32 writeIdx;
|
||||
EventSem eventSem;
|
||||
};
|
||||
|
||||
}
|
||||
|
||||
#endif
|
||||
83
README.md
83
README.md
@@ -1,48 +1,51 @@
|
||||
# MARTe2 Universal Debugging & Observability Suite
|
||||
# MARTe2 Debug Suite
|
||||
|
||||
A professional-grade, zero-code-change debugging suite for the MARTe2 real-time framework.
|
||||
|
||||
## Features
|
||||
|
||||
- **Runtime Registry Patching**: Instruments all MARTe2 Brokers automatically at startup.
|
||||
- **Hierarchical Tree Explorer**: Recursive visualization of the `ObjectRegistryDatabase`, including GAMs, DataSources, and Signals.
|
||||
- **Real-Time Execution Control**: Pause and Resume application logic globally to perform static inspection.
|
||||
- **High-Speed Telemetry**: Visual oscilloscope with sub-millisecond precision via UDP.
|
||||
- **Persistent Forcing**: Type-aware signal overrides (Last-Writer-Wins) with persistent re-application.
|
||||
- **Isolated Log Streaming**: Dedicated TCP channel for real-time framework logs to ensure command responsiveness.
|
||||
|
||||
## Components
|
||||
|
||||
### 1. C++ Core (`libmarte_dev.so`)
|
||||
The core service that handles registry patching, TCP/UDP communication, and real-time safe data capture.
|
||||
|
||||
### 2. Rust GUI Client (`marte_debug_gui`)
|
||||
A native, multi-threaded dashboard built with `egui`.
|
||||
- **Side Panel**: Collapsible application tree and signal navigator.
|
||||
- **Bottom Panel**: Advanced log terminal with Regex filtering and priority levels.
|
||||
- **Right Panel**: Active Trace and Force management.
|
||||
- **Central Pane**: High-frequency oscilloscope.
|
||||
An interactive observability and debugging suite for the MARTe2 real-time framework.
|
||||
|
||||
## Quick Start
|
||||
|
||||
### Build
|
||||
### 1. Build the project
|
||||
```bash
|
||||
# Build C++ Core
|
||||
cd Build && cmake .. && make -j$(nproc)
|
||||
|
||||
# Build GUI Client
|
||||
cd Tools/gui_client
|
||||
cargo build --release
|
||||
. ./env.sh
|
||||
cd Build
|
||||
cmake ..
|
||||
make -j$(nproc)
|
||||
```
|
||||
|
||||
### Run
|
||||
1. Start your MARTe2 application with the `DebugService` enabled.
|
||||
2. Launch the GUI:
|
||||
```bash
|
||||
./Tools/gui_client/target/release/marte_debug_gui
|
||||
```
|
||||
### 2. Run Integration Tests
|
||||
```bash
|
||||
./Test/Integration/ValidationTest # Verifies 100Hz tracing
|
||||
./Test/Integration/SchedulerTest # Verifies execution control
|
||||
```
|
||||
|
||||
## Communication Ports
|
||||
- **8080 (TCP)**: Commands (TREE, FORCE, TRACE, PAUSE).
|
||||
- **8082 (TCP)**: Real-time framework logs.
|
||||
- **8081 (UDP)**: Signal telemetry data.
|
||||
### 3. Launch GUI
|
||||
```bash
|
||||
cd Tools/gui_client
|
||||
cargo run --release
|
||||
```
|
||||
|
||||
## Features
|
||||
- **Live Tree:** Explore the MARTe2 object database in real-time.
|
||||
- **Oscilloscope:** Trace any signal at high frequency (100Hz+) with automatic scaling.
|
||||
- **Signal Forcing:** Inject values directly into the real-time memory map.
|
||||
- **Log Forwarding:** Integrated framework log viewer with regex filtering.
|
||||
- **Execution Control:** Global pause/resume via scheduler-level hooks.
|
||||
|
||||
## Usage
|
||||
To enable debugging in your application, add the following to your `.cfg`:
|
||||
```text
|
||||
+DebugService = {
|
||||
Class = DebugService
|
||||
ControlPort = 8080
|
||||
UdpPort = 8081
|
||||
}
|
||||
|
||||
+LoggerService = {
|
||||
Class = LoggerService
|
||||
+DebugConsumer = {
|
||||
Class = TcpLogger
|
||||
Port = 8082
|
||||
}
|
||||
}
|
||||
```
|
||||
The suite automatically patches the registry to instrument your existing Brokers and Schedulers.
|
||||
|
||||
61
SPECS.md
Normal file
61
SPECS.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# MARTe2 Debug Suite Specifications
|
||||
|
||||
**Version:** 1.2
|
||||
**Status:** Active / Implemented
|
||||
|
||||
## 1. Executive Summary
|
||||
This project implements a "Zero-Code-Change" observability and debugging layer for the MARTe2 real-time framework. The system allows developers to Trace, Force, and Monitor any signal in a running MARTe2 application without modifying existing source code.
|
||||
|
||||
## 2. System Architecture
|
||||
- **The Universal Debug Service (C++ Core):** A singleton MARTe2 Object that patches the registry and manages communication.
|
||||
- **The Broker Injection Layer (C++ Templates):** Templated wrappers that intercept `Execute()` and `Init()` calls for tracing, forcing, and execution control.
|
||||
- **The Remote Analyser (Rust/egui):** A high-performance, multi-threaded GUI for visualization and control.
|
||||
- **Network Stack:**
|
||||
- **Port 8080 (TCP):** Commands and Metadata.
|
||||
- **Port 8081 (UDP):** High-Speed Telemetry for Oscilloscope.
|
||||
- **Port 8082 (TCP):** Independent Real-Time Log Stream via `TcpLogger`.
|
||||
|
||||
## 3. Requirements
|
||||
|
||||
### 3.1 Functional Requirements (FR)
|
||||
- **FR-01 (Discovery):** Discover the full MARTe2 object hierarchy at runtime. The GUI client SHALL request the full application tree upon connection and display it in a hierarchical tree view.
|
||||
- **FR-02 (Telemetry):** Stream high-frequency signal data (verified up to 100Hz+) to a remote client via UDP.
|
||||
- **FR-03 (Forcing):** Allow manual override of signal values in memory during execution.
|
||||
- **FR-04 (Logs):** Stream global framework logs to a dedicated terminal/client via a standalone `TcpLogger` service.
|
||||
- **FR-05 (Log Filtering):** The client must support filtering logs by type (Debug, Information, Warning, FatalError) and by content using regular expressions.
|
||||
- **FR-06 (Execution Control):** Provide a mechanism to pause and resume the execution of all patched real-time threads (via Brokers), allowing for static inspection of the system state.
|
||||
- **FR-07 (Session Management):** Support runtime re-configuration and "Apply & Reconnect" logic. The GUI provides a "Disconnect" button to close active network streams.
|
||||
- **FR-08 (Decoupled Tracing):** Tracing activates telemetry; data is buffered and shown as a "Last Value" in the sidebar, but not plotted until manually assigned.
|
||||
- **FR-09 (Advanced Plotting):**
|
||||
- Support multiple plot panels with perfectly synchronized time (X) axes.
|
||||
- Drag-and-drop signals from the traced list into specific plots.
|
||||
- Plot modes: Standard (Time Series) and Logic Analyzer (Stacked rows).
|
||||
- Signal transformations: Gain, offset, units, and custom labels.
|
||||
- **FR-10 (Navigation & Scope):**
|
||||
- Context menus for resetting zoom (X, Y, or both).
|
||||
- "Fit to View" functionality that automatically scales both axes.
|
||||
- High-performance oscilloscope mode with configurable time windows (10ms to 10s).
|
||||
- Triggered acquisition (Single/Continuous, rising/falling edges).
|
||||
- **FR-11 (Data Recording):** Record any traced signal to disk in Parquet format with a visual recording indicator in the GUI.
|
||||
|
||||
### 3.2 Technical Constraints (TC)
|
||||
- **TC-01:** No modifications allowed to the MARTe2 core library or component source code.
|
||||
- **TC-02:** Instrumentation must use Runtime Class Registry Patching.
|
||||
- **TC-03:** Real-time threads must remain lock-free; use `FastPollingMutexSem` or atomic operations for synchronization.
|
||||
- **TC-04:** Telemetry must be delivered via UDP to minimize impact on real-time jitter.
|
||||
|
||||
## 4. Performance Metrics
|
||||
- **Latency:** Telemetry dispatch overhead < 5 microseconds per signal.
|
||||
- **Throughput:** Support for 100Hz+ sampling rates with zero packet loss on local networks.
|
||||
- **Scalability:** Handle up to 4096 unique signals and 16 simultaneous client connections.
|
||||
- **Code Quality:** Maintain a minimum of **85% code coverage** across all core service and broker logic.
|
||||
|
||||
## 5. Communication Protocol (Port 8080)
|
||||
- **LS [Path]:** List nodes at the specified path.
|
||||
- **TREE:** Returns a full recursive JSON structure representing the entire application tree.
|
||||
- **INFO [Path]:** Returns detailed metadata for a specific node or signal.
|
||||
- **PAUSE / RESUME:** Global execution control.
|
||||
- **TRACE <Signal> <1/0> [Decimation]:** Enable/disable telemetry for a signal.
|
||||
- **FORCE <Signal> <Value>:** Persistent signal override.
|
||||
- **UNFORCE <Signal>:** Remove override.
|
||||
- **LOG <Level> <Msg>:** Streaming format used on Port 8082.
|
||||
File diff suppressed because it is too large
Load Diff
156
Source/TcpLogger.cpp
Normal file
156
Source/TcpLogger.cpp
Normal file
@@ -0,0 +1,156 @@
|
||||
#include "TcpLogger.h"
|
||||
#include "Threads.h"
|
||||
#include "StringHelper.h"
|
||||
#include "ConfigurationDatabase.h"
|
||||
|
||||
namespace MARTe {
|
||||
|
||||
CLASS_REGISTER(TcpLogger, "1.0")
|
||||
|
||||
TcpLogger::TcpLogger() :
|
||||
ReferenceContainer(), LoggerConsumerI(), EmbeddedServiceMethodBinderI(),
|
||||
service(*this)
|
||||
{
|
||||
port = 8082;
|
||||
readIdx = 0;
|
||||
writeIdx = 0;
|
||||
workerThreadId = InvalidThreadIdentifier;
|
||||
for (uint32 i=0; i<MAX_CLIENTS; i++) {
|
||||
activeClients[i] = NULL_PTR(BasicTCPSocket*);
|
||||
}
|
||||
}
|
||||
|
||||
TcpLogger::~TcpLogger() {
|
||||
service.Stop();
|
||||
server.Close();
|
||||
|
||||
clientsMutex.FastLock();
|
||||
for (uint32 i=0; i<MAX_CLIENTS; i++) {
|
||||
if (activeClients[i] != NULL_PTR(BasicTCPSocket*)) {
|
||||
activeClients[i]->Close();
|
||||
delete activeClients[i];
|
||||
activeClients[i] = NULL_PTR(BasicTCPSocket*);
|
||||
}
|
||||
}
|
||||
clientsMutex.FastUnLock();
|
||||
}
|
||||
|
||||
bool TcpLogger::Initialise(StructuredDataI & data) {
|
||||
if (!ReferenceContainer::Initialise(data)) return false;
|
||||
|
||||
if (!data.Read("Port", port)) {
|
||||
(void)data.Read("TcpPort", port);
|
||||
}
|
||||
|
||||
(void)eventSem.Create();
|
||||
|
||||
ConfigurationDatabase threadData;
|
||||
threadData.Write("Timeout", (uint32)1000);
|
||||
if (!service.Initialise(threadData)) return false;
|
||||
|
||||
if (!server.Open()) return false;
|
||||
if (!server.Listen(port)) {
|
||||
return false;
|
||||
}
|
||||
printf("[TcpLogger] Listening on port %u\n", port);
|
||||
|
||||
if (service.Start() != ErrorManagement::NoError) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
void TcpLogger::ConsumeLogMessage(LoggerPage *logPage) {
|
||||
if (logPage == NULL_PTR(LoggerPage*)) return;
|
||||
|
||||
// 1. Mirror to stdout
|
||||
StreamString levelStr;
|
||||
ErrorManagement::ErrorCodeToStream(logPage->errorInfo.header.errorType, levelStr);
|
||||
printf("[%s] %s\n", levelStr.Buffer(), logPage->errorStrBuffer);
|
||||
fflush(stdout);
|
||||
|
||||
// 2. Queue for TCP
|
||||
InsertLogIntoQueue(logPage->errorInfo, logPage->errorStrBuffer);
|
||||
}
|
||||
|
||||
void TcpLogger::InsertLogIntoQueue(const ErrorManagement::ErrorInformation &info, const char8 * const description) {
|
||||
uint32 next = (writeIdx + 1) % QUEUE_SIZE;
|
||||
if (next != readIdx) {
|
||||
TcpLogEntry &entry = queue[writeIdx % QUEUE_SIZE];
|
||||
entry.info = info;
|
||||
StringHelper::Copy(entry.description, description);
|
||||
writeIdx = next;
|
||||
(void)eventSem.Post();
|
||||
}
|
||||
}
|
||||
|
||||
ErrorManagement::ErrorType TcpLogger::Execute(ExecutionInfo & info) {
|
||||
if (info.GetStage() == ExecutionInfo::TerminationStage) return ErrorManagement::NoError;
|
||||
if (info.GetStage() == ExecutionInfo::StartupStage) {
|
||||
workerThreadId = Threads::Id();
|
||||
return ErrorManagement::NoError;
|
||||
}
|
||||
|
||||
while (info.GetStage() == ExecutionInfo::MainStage) {
|
||||
// 1. Check for new connections
|
||||
BasicTCPSocket *newClient = server.WaitConnection(1);
|
||||
if (newClient != NULL_PTR(BasicTCPSocket *)) {
|
||||
clientsMutex.FastLock();
|
||||
bool added = false;
|
||||
for (uint32 i=0; i<MAX_CLIENTS; i++) {
|
||||
if (activeClients[i] == NULL_PTR(BasicTCPSocket*)) {
|
||||
activeClients[i] = newClient;
|
||||
added = true;
|
||||
break;
|
||||
}
|
||||
}
|
||||
clientsMutex.FastUnLock();
|
||||
if (!added) {
|
||||
newClient->Close();
|
||||
delete newClient;
|
||||
} else {
|
||||
(void)newClient->SetBlocking(false);
|
||||
}
|
||||
}
|
||||
|
||||
// 2. Stream data to clients
|
||||
bool hadData = false;
|
||||
while (readIdx != writeIdx) {
|
||||
hadData = true;
|
||||
uint32 idx = readIdx % QUEUE_SIZE;
|
||||
TcpLogEntry &entry = queue[idx];
|
||||
|
||||
StreamString level;
|
||||
ErrorManagement::ErrorCodeToStream(entry.info.header.errorType, level);
|
||||
|
||||
StreamString packet;
|
||||
packet.Printf("LOG %s %s\n", level.Buffer(), entry.description);
|
||||
uint32 size = packet.Size();
|
||||
|
||||
clientsMutex.FastLock();
|
||||
for (uint32 j=0; j<MAX_CLIENTS; j++) {
|
||||
if (activeClients[j] != NULL_PTR(BasicTCPSocket*)) {
|
||||
uint32 s = size;
|
||||
if (!activeClients[j]->Write(packet.Buffer(), s)) {
|
||||
activeClients[j]->Close();
|
||||
delete activeClients[j];
|
||||
activeClients[j] = NULL_PTR(BasicTCPSocket*);
|
||||
}
|
||||
}
|
||||
}
|
||||
clientsMutex.FastUnLock();
|
||||
readIdx = (readIdx + 1) % QUEUE_SIZE;
|
||||
}
|
||||
|
||||
if (!hadData) {
|
||||
(void)eventSem.Wait(TimeoutType(100));
|
||||
eventSem.Reset();
|
||||
} else {
|
||||
Sleep::MSec(1);
|
||||
}
|
||||
}
|
||||
return ErrorManagement::NoError;
|
||||
}
|
||||
|
||||
}
|
||||
56
TUTORIAL.md
Normal file
56
TUTORIAL.md
Normal file
@@ -0,0 +1,56 @@
|
||||
# Tutorial: High-Speed Observability with MARTe2 Debug GUI
|
||||
|
||||
This guide will walk you through the process of tracing and forcing signals in a real-time MARTe2 application using the native Rust GUI client.
|
||||
|
||||
## 1. Environment Setup
|
||||
|
||||
### Launch the MARTe2 Application
|
||||
First, start your application using the provided debug runner. This script launches the standard `MARTeApp.ex` while injecting the debugging layer:
|
||||
```bash
|
||||
./run_debug_app.sh
|
||||
```
|
||||
*Note: You should see logs indicating the `DebugService` has started on port 8080 and `TcpLogger` on port 8082.*
|
||||
|
||||
### Start the GUI Client
|
||||
In a new terminal window, navigate to the client directory and run the GUI:
|
||||
```bash
|
||||
cd Tools/gui_client
|
||||
cargo run --release
|
||||
```
|
||||
|
||||
## 2. Exploring the Object Tree
|
||||
Once connected, the left panel (**Application Tree**) displays the live hierarchy of your application.
|
||||
|
||||
1. **Navigate to Data:** Expand `Root` -> `App` -> `Data`.
|
||||
2. **Inspect Nodes:** Click the **ℹ Info** button next to any node (like `Timer` or `DDB`).
|
||||
3. **View Metadata:** The bottom-left pane will display the full JSON configuration of that object, including its class, parameters, and signals.
|
||||
|
||||
## 3. Real-Time Signal Tracing (Oscilloscope)
|
||||
Tracing allows you to see signal values exactly as they exist in the real-time memory map.
|
||||
|
||||
1. **Find a Signal:** In the tree, locate `Root.App.Data.Timer.Counter`.
|
||||
2. **Activate Trace:** Click the **📈 Trace** button.
|
||||
3. **Monitor the Scope:** The central **Oscilloscope** panel will begin plotting the signal.
|
||||
4. **Verify Data Flow:** Check the **UDP Packets** counter in the top bar; it should be increasing rapidly, confirming high-speed data reception (Port 8081).
|
||||
5. **Multi-Signal Trace:** You can click **📈 Trace** on other signals (like `Time`) to overlay multiple plots.
|
||||
|
||||
## 4. Signal Forcing (Manual Override)
|
||||
Forcing allows you to bypass the framework logic and manually set a signal's value in memory.
|
||||
|
||||
1. **Locate Target:** Find a signal that is being written by a GAM, such as `Root.App.Data.DDB.Counter`.
|
||||
2. **Open Force Dialog:** Click the **⚡ Force** button next to the signal.
|
||||
3. **Inject Value:** In the popup dialog, enter a new value (e.g., `9999`) and click **Apply Force**.
|
||||
4. **Observe Effect:** If you are tracing the same signal, the oscilloscope plot will immediately jump to and hold at `9999`.
|
||||
5. **Release Control:** To stop forcing, click the **❌** button in the **Active Controls** (Right Panel) under "Forced Signals". The framework will resume writing its own values to that memory location.
|
||||
|
||||
## 5. Advanced Controls
|
||||
|
||||
### Global Pause
|
||||
If you need to "freeze" the entire application to inspect a specific state:
|
||||
- Click **⏸ Pause** in the top bar. The real-time threads will halt at the start of their next cycle.
|
||||
- Click **▶ Resume** to restart the execution.
|
||||
|
||||
### Log Terminal
|
||||
The bottom panel displays every `REPORT_ERROR` event from the C++ framework, powered by the standalone `TcpLogger` service.
|
||||
- **Regex Filter:** Type a keyword like `Timer` in the filter box to isolate relevant events.
|
||||
- **Pause Logs:** Toggle **⏸ Pause Logs** to stop the scrolling view while data continues to be captured in the background.
|
||||
@@ -1,18 +1,3 @@
|
||||
+DebugService = {
|
||||
Class = DebugService
|
||||
ControlPort = 8080
|
||||
StreamPort = 8081
|
||||
StreamIP = "127.0.0.1"
|
||||
}
|
||||
|
||||
+LoggerService = {
|
||||
Class = LoggerService
|
||||
CPUs = 0x1
|
||||
+DebugConsumer = {
|
||||
Class = DebugService
|
||||
}
|
||||
}
|
||||
|
||||
+App = {
|
||||
Class = RealTimeApplication
|
||||
+Functions = {
|
||||
@@ -23,7 +8,7 @@
|
||||
Counter = {
|
||||
DataSource = Timer
|
||||
Type = uint32
|
||||
Frequency = 10
|
||||
Frequency = 1000
|
||||
}
|
||||
Time = {
|
||||
DataSource = Timer
|
||||
@@ -36,18 +21,50 @@
|
||||
Type = uint32
|
||||
}
|
||||
Time = {
|
||||
DataSource = Logger
|
||||
DataSource = DDB
|
||||
Type = uint32
|
||||
}
|
||||
}
|
||||
}
|
||||
+GAM2 = {
|
||||
Class = IOGAM
|
||||
InputSignals = {
|
||||
Counter = {
|
||||
DataSource = TimerSlow
|
||||
Frequency = 10
|
||||
}
|
||||
Time = {
|
||||
DataSource = TimerSlow
|
||||
}
|
||||
}
|
||||
OutputSignals = {
|
||||
Counter = {
|
||||
Type = uint32
|
||||
DataSource = Logger
|
||||
}
|
||||
Time = {
|
||||
Type = uint32
|
||||
DataSource = Logger
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
+Data = {
|
||||
Class = ReferenceContainer
|
||||
DefaultDataSource = DDB
|
||||
+Timer = {
|
||||
Class = LinuxTimer
|
||||
SleepTime = 1000000 // 1 second
|
||||
Signals = {
|
||||
Counter = {
|
||||
Type = uint32
|
||||
}
|
||||
Time = {
|
||||
Type = uint32
|
||||
}
|
||||
}
|
||||
}
|
||||
+TimerSlow = {
|
||||
Class = LinuxTimer
|
||||
Signals = {
|
||||
Counter = {
|
||||
Type = uint32
|
||||
@@ -91,6 +108,10 @@
|
||||
Class = RealTimeThread
|
||||
Functions = {GAM1}
|
||||
}
|
||||
+Thread2 = {
|
||||
Class = RealTimeThread
|
||||
Functions = {GAM2}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -99,3 +120,19 @@
|
||||
TimingDataSource = DAMS
|
||||
}
|
||||
}
|
||||
|
||||
+DebugService = {
|
||||
Class = DebugService
|
||||
ControlPort = 8080
|
||||
UdpPort = 8081
|
||||
StreamIP = "127.0.0.1"
|
||||
}
|
||||
|
||||
+LoggerService = {
|
||||
Class = LoggerService
|
||||
CPUs = 0x1
|
||||
+DebugConsumer = {
|
||||
Class = TcpLogger
|
||||
Port = 8082
|
||||
}
|
||||
}
|
||||
|
||||
@@ -6,3 +6,6 @@ target_link_libraries(TraceTest marte_dev ${MARTe2_LIB})
|
||||
|
||||
add_executable(ValidationTest ValidationTest.cpp)
|
||||
target_link_libraries(ValidationTest marte_dev ${MARTe2_LIB} ${IOGAM_LIB} ${LinuxTimer_LIB})
|
||||
|
||||
add_executable(SchedulerTest SchedulerTest.cpp)
|
||||
target_link_libraries(SchedulerTest marte_dev ${MARTe2_LIB} ${IOGAM_LIB} ${LinuxTimer_LIB})
|
||||
|
||||
202
Test/Integration/SchedulerTest.cpp
Normal file
202
Test/Integration/SchedulerTest.cpp
Normal file
@@ -0,0 +1,202 @@
|
||||
#include "DebugService.h"
|
||||
#include "DebugCore.h"
|
||||
#include "ObjectRegistryDatabase.h"
|
||||
#include "StandardParser.h"
|
||||
#include "StreamString.h"
|
||||
#include "BasicUDPSocket.h"
|
||||
#include "BasicTCPSocket.h"
|
||||
#include "RealTimeApplication.h"
|
||||
#include "GlobalObjectsDatabase.h"
|
||||
#include "MessageI.h"
|
||||
#include <assert.h>
|
||||
#include <stdio.h>
|
||||
|
||||
using namespace MARTe;
|
||||
|
||||
const char8 * const config_text =
|
||||
"+DebugService = {"
|
||||
" Class = DebugService "
|
||||
" ControlPort = 8080 "
|
||||
" UdpPort = 8081 "
|
||||
" StreamIP = \"127.0.0.1\" "
|
||||
"}"
|
||||
"+App = {"
|
||||
" Class = RealTimeApplication "
|
||||
" +Functions = {"
|
||||
" Class = ReferenceContainer "
|
||||
" +GAM1 = {"
|
||||
" Class = IOGAM "
|
||||
" InputSignals = {"
|
||||
" Counter = {"
|
||||
" DataSource = Timer "
|
||||
" Type = uint32 "
|
||||
" }"
|
||||
" }"
|
||||
" OutputSignals = {"
|
||||
" Counter = {"
|
||||
" DataSource = DDB "
|
||||
" Type = uint32 "
|
||||
" }"
|
||||
" }"
|
||||
" }"
|
||||
" }"
|
||||
" +Data = {"
|
||||
" Class = ReferenceContainer "
|
||||
" DefaultDataSource = DDB "
|
||||
" +Timer = {"
|
||||
" Class = LinuxTimer "
|
||||
" SleepTime = 100000 " // 100ms
|
||||
" Signals = {"
|
||||
" Counter = { Type = uint32 }"
|
||||
" }"
|
||||
" }"
|
||||
" +DDB = {"
|
||||
" Class = GAMDataSource "
|
||||
" Signals = { Counter = { Type = uint32 } }"
|
||||
" }"
|
||||
" +DAMS = { Class = TimingDataSource }"
|
||||
" }"
|
||||
" +States = {"
|
||||
" Class = ReferenceContainer "
|
||||
" +State1 = {"
|
||||
" Class = RealTimeState "
|
||||
" +Threads = {"
|
||||
" Class = ReferenceContainer "
|
||||
" +Thread1 = {"
|
||||
" Class = RealTimeThread "
|
||||
" Functions = {GAM1} "
|
||||
" }"
|
||||
" }"
|
||||
" }"
|
||||
" }"
|
||||
" +Scheduler = {"
|
||||
" Class = FastScheduler "
|
||||
" TimingDataSource = DAMS "
|
||||
" }"
|
||||
"}";
|
||||
|
||||
void TestSchedulerControl() {
|
||||
printf("--- MARTe2 Scheduler Control Test ---\n");
|
||||
|
||||
ConfigurationDatabase cdb;
|
||||
StreamString ss = config_text;
|
||||
ss.Seek(0);
|
||||
StandardParser parser(ss, cdb);
|
||||
assert(parser.Parse());
|
||||
assert(ObjectRegistryDatabase::Instance()->Initialise(cdb));
|
||||
|
||||
ReferenceT<DebugService> service = ObjectRegistryDatabase::Instance()->Find("DebugService");
|
||||
assert(service.IsValid());
|
||||
|
||||
ReferenceT<RealTimeApplication> app = ObjectRegistryDatabase::Instance()->Find("App");
|
||||
assert(app.IsValid());
|
||||
|
||||
if (app->PrepareNextState("State1") != ErrorManagement::NoError) {
|
||||
printf("ERROR: Failed to prepare State1\n");
|
||||
return;
|
||||
}
|
||||
|
||||
if (app->StartNextStateExecution() != ErrorManagement::NoError) {
|
||||
printf("ERROR: Failed to start execution\n");
|
||||
return;
|
||||
}
|
||||
|
||||
printf("Application started. Waiting for cycles...\n");
|
||||
Sleep::MSec(1000);
|
||||
|
||||
// Enable Trace First
|
||||
{
|
||||
BasicTCPSocket tClient;
|
||||
if (tClient.Connect("127.0.0.1", 8080)) {
|
||||
const char* cmd = "TRACE Root.App.Data.Timer.Counter 1\n";
|
||||
uint32 s = StringHelper::Length(cmd);
|
||||
tClient.Write(cmd, s);
|
||||
tClient.Close();
|
||||
} else {
|
||||
printf("WARNING: Could not connect to DebugService to enable trace.\n");
|
||||
}
|
||||
}
|
||||
|
||||
BasicUDPSocket listener;
|
||||
listener.Open();
|
||||
listener.Listen(8081);
|
||||
|
||||
// Read current value
|
||||
uint32 valBeforePause = 0;
|
||||
char buffer[2048];
|
||||
uint32 size = 2048;
|
||||
TimeoutType timeout(500);
|
||||
if (listener.Read(buffer, size, timeout)) {
|
||||
// [Header][ID][Size][Value]
|
||||
valBeforePause = *(uint32*)(&buffer[28]);
|
||||
printf("Value before/at pause: %u\n", valBeforePause);
|
||||
} else {
|
||||
printf("WARNING: No data received before pause.\n");
|
||||
}
|
||||
|
||||
// Send PAUSE
|
||||
printf("Sending PAUSE command...\n");
|
||||
BasicTCPSocket client;
|
||||
if (client.Connect("127.0.0.1", 8080)) {
|
||||
const char* cmd = "PAUSE\n";
|
||||
uint32 s = StringHelper::Length(cmd);
|
||||
client.Write(cmd, s);
|
||||
client.Close();
|
||||
} else {
|
||||
printf("ERROR: Could not connect to DebugService to send PAUSE.\n");
|
||||
}
|
||||
|
||||
Sleep::MSec(2000); // Wait 2 seconds
|
||||
|
||||
// Read again - should be same or very close if paused
|
||||
uint32 valAfterWait = 0;
|
||||
size = 2048; // Reset size
|
||||
while(listener.Read(buffer, size, TimeoutType(10))) {
|
||||
valAfterWait = *(uint32*)(&buffer[28]);
|
||||
size = 2048;
|
||||
}
|
||||
|
||||
printf("Value after 2s wait (drained): %u\n", valAfterWait);
|
||||
|
||||
// Check if truly paused
|
||||
if (valAfterWait > valBeforePause + 5) {
|
||||
printf("FAILURE: Counter increased significantly while paused! (%u -> %u)\n", valBeforePause, valAfterWait);
|
||||
} else {
|
||||
printf("SUCCESS: Counter held steady (or close) during pause.\n");
|
||||
}
|
||||
|
||||
// Resume
|
||||
printf("Sending RESUME command...\n");
|
||||
{
|
||||
BasicTCPSocket rClient;
|
||||
if (rClient.Connect("127.0.0.1", 8080)) {
|
||||
const char* cmd = "RESUME\n";
|
||||
uint32 s = StringHelper::Length(cmd);
|
||||
rClient.Write(cmd, s);
|
||||
rClient.Close();
|
||||
}
|
||||
}
|
||||
|
||||
Sleep::MSec(1000);
|
||||
|
||||
// Check if increasing
|
||||
uint32 valAfterResume = 0;
|
||||
size = 2048;
|
||||
if (listener.Read(buffer, size, timeout)) {
|
||||
valAfterResume = *(uint32*)(&buffer[28]);
|
||||
printf("Value after resume: %u\n", valAfterResume);
|
||||
}
|
||||
|
||||
if (valAfterResume > valAfterWait) {
|
||||
printf("SUCCESS: Execution resumed.\n");
|
||||
} else {
|
||||
printf("FAILURE: Execution did not resume.\n");
|
||||
}
|
||||
|
||||
app->StopCurrentStateExecution();
|
||||
}
|
||||
|
||||
int main() {
|
||||
TestSchedulerControl();
|
||||
return 0;
|
||||
}
|
||||
@@ -4,6 +4,7 @@
|
||||
#include "StandardParser.h"
|
||||
#include "StreamString.h"
|
||||
#include "BasicUDPSocket.h"
|
||||
#include "HighResolutionTimer.h"
|
||||
#include <assert.h>
|
||||
#include <stdio.h>
|
||||
|
||||
@@ -41,7 +42,8 @@ void TestFullTracePipeline() {
|
||||
printf("Simulating cycles...\n");
|
||||
for (int i=0; i<50; i++) {
|
||||
mockValue = 1000 + i;
|
||||
service.ProcessSignal(sig, sizeof(uint32));
|
||||
uint64 ts = (uint64)((float64)HighResolutionTimer::Counter() * HighResolutionTimer::Period() * 1000000.0);
|
||||
service.ProcessSignal(sig, sizeof(uint32), ts);
|
||||
Sleep::MSec(10);
|
||||
}
|
||||
|
||||
@@ -62,13 +64,14 @@ void TestFullTracePipeline() {
|
||||
printf("Header: Magic=0x%X, Count=%u, Seq=%u\n", h->magic, h->count, h->seq);
|
||||
|
||||
uint32 offset = sizeof(TraceHeader);
|
||||
if (size >= offset + 8) {
|
||||
if (size >= offset + 16) {
|
||||
uint32 recId = *(uint32*)(&buffer[offset]);
|
||||
uint32 recSize = *(uint32*)(&buffer[offset + 4]);
|
||||
printf("Data: ID=%u, Size=%u\n", recId, recSize);
|
||||
if (size >= offset + 8 + recSize) {
|
||||
uint64 recTs = *(uint64*)(&buffer[offset + 4]);
|
||||
uint32 recSize = *(uint32*)(&buffer[offset + 12]);
|
||||
printf("Data: ID=%u, TS=%lu, Size=%u\n", recId, recTs, recSize);
|
||||
if (size >= offset + 16 + recSize) {
|
||||
if (recSize == 4) {
|
||||
uint32 recVal = *(uint32*)(&buffer[offset + 8]);
|
||||
uint32 recVal = *(uint32*)(&buffer[offset + 16]);
|
||||
printf("Value=%u\n", recVal);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -6,194 +6,173 @@
|
||||
#include "BasicUDPSocket.h"
|
||||
#include "BasicTCPSocket.h"
|
||||
#include "RealTimeApplication.h"
|
||||
#include "GlobalObjectsDatabase.h"
|
||||
#include "RealTimeLoader.h"
|
||||
#include "HighResolutionTimer.h"
|
||||
#include <assert.h>
|
||||
#include <stdio.h>
|
||||
|
||||
using namespace MARTe;
|
||||
|
||||
const char8 * const config_text =
|
||||
"+DebugService = {"
|
||||
// Removed '+' prefix from names for simpler lookup
|
||||
const char8 * const simple_config =
|
||||
"DebugService = {"
|
||||
" Class = DebugService "
|
||||
" ControlPort = 8080 "
|
||||
" UdpPort = 8081 "
|
||||
" StreamIP = \"127.0.0.1\" "
|
||||
"}"
|
||||
"+App = {"
|
||||
"App = {"
|
||||
" Class = RealTimeApplication "
|
||||
" +Functions = {"
|
||||
" Class = ReferenceContainer "
|
||||
" +GAM1 = {"
|
||||
" Class = IOGAM "
|
||||
" InputSignals = {"
|
||||
" Counter = {"
|
||||
" DataSource = Timer "
|
||||
" Type = uint32 "
|
||||
" }"
|
||||
" Counter = { DataSource = Timer Type = uint32 Frequency = 1000 }"
|
||||
" Time = { DataSource = Timer Type = uint32 }"
|
||||
" }"
|
||||
" OutputSignals = {"
|
||||
" Counter = {"
|
||||
" DataSource = DDB "
|
||||
" Type = uint32 "
|
||||
" }"
|
||||
" Counter = { DataSource = DDB Type = uint32 }"
|
||||
" Time = { DataSource = DDB Type = uint32 }"
|
||||
" }"
|
||||
" }"
|
||||
" }"
|
||||
" +Data = {"
|
||||
" Class = ReferenceContainer "
|
||||
" DefaultDataSource = DDB "
|
||||
" +Timer = {"
|
||||
" Class = LinuxTimer "
|
||||
" SleepTime = 10000 "
|
||||
" Signals = {"
|
||||
" Counter = { Type = uint32 }"
|
||||
" }"
|
||||
" }"
|
||||
" +DDB = {"
|
||||
" Class = GAMDataSource "
|
||||
" Signals = { Counter = { Type = uint32 } }"
|
||||
" }"
|
||||
" +Timer = { Class = LinuxTimer SleepTime = 1000 Signals = { Counter = { Type = uint32 } Time = { Type = uint32 } } }"
|
||||
" +DDB = { Class = GAMDataSource Signals = { Counter = { Type = uint32 } Time = { Type = uint32 } } }"
|
||||
" +DAMS = { Class = TimingDataSource }"
|
||||
" }"
|
||||
" +States = {"
|
||||
" Class = ReferenceContainer "
|
||||
" +State1 = {"
|
||||
" Class = RealTimeState "
|
||||
" +Threads = {"
|
||||
" Class = ReferenceContainer "
|
||||
" +Thread1 = {"
|
||||
" Class = RealTimeThread "
|
||||
" Functions = {GAM1} "
|
||||
" }"
|
||||
" }"
|
||||
" }"
|
||||
" }"
|
||||
" +Scheduler = {"
|
||||
" Class = GAMScheduler "
|
||||
" TimingDataSource = DAMS "
|
||||
" +State1 = { Class = RealTimeState +Threads = { Class = ReferenceContainer +Thread1 = { Class = RealTimeThread Functions = {GAM1} } } }"
|
||||
" }"
|
||||
" +Scheduler = { Class = GAMScheduler TimingDataSource = DAMS }"
|
||||
"}";
|
||||
|
||||
void RunValidationTest() {
|
||||
printf("--- MARTe2 100Hz Trace Validation Test ---\n");
|
||||
printf("--- MARTe2 1kHz Lossless Trace Validation Test ---\n");
|
||||
|
||||
ObjectRegistryDatabase::Instance()->Purge();
|
||||
|
||||
// 1. Load Configuration
|
||||
ConfigurationDatabase cdb;
|
||||
StreamString ss = config_text;
|
||||
StreamString ss = simple_config;
|
||||
ss.Seek(0);
|
||||
StandardParser parser(ss, cdb);
|
||||
if (!parser.Parse()) {
|
||||
printf("ERROR: Failed to parse configuration\n");
|
||||
assert(parser.Parse());
|
||||
|
||||
cdb.MoveToRoot();
|
||||
uint32 n = cdb.GetNumberOfChildren();
|
||||
for (uint32 i=0; i<n; i++) {
|
||||
const char8* name = cdb.GetChildName(i);
|
||||
ConfigurationDatabase child;
|
||||
cdb.MoveRelative(name);
|
||||
cdb.Copy(child);
|
||||
cdb.MoveToAncestor(1u);
|
||||
|
||||
StreamString className;
|
||||
child.Read("Class", className);
|
||||
|
||||
Reference ref(className.Buffer(), GlobalObjectsDatabase::Instance()->GetStandardHeap());
|
||||
ref->SetName(name);
|
||||
assert(ref->Initialise(child));
|
||||
ObjectRegistryDatabase::Instance()->Insert(ref);
|
||||
}
|
||||
|
||||
Reference serviceGeneric = ObjectRegistryDatabase::Instance()->Find("DebugService");
|
||||
Reference appGeneric = ObjectRegistryDatabase::Instance()->Find("App");
|
||||
|
||||
if (!serviceGeneric.IsValid() || !appGeneric.IsValid()) {
|
||||
printf("ERROR: Objects NOT FOUND even without prefix\n");
|
||||
return;
|
||||
}
|
||||
|
||||
if (!ObjectRegistryDatabase::Instance()->Initialise(cdb)) {
|
||||
printf("ERROR: Failed to initialise ObjectRegistryDatabase.\n");
|
||||
DebugService *service = dynamic_cast<DebugService*>(serviceGeneric.operator->());
|
||||
RealTimeApplication *app = dynamic_cast<RealTimeApplication*>(appGeneric.operator->());
|
||||
|
||||
assert(service);
|
||||
assert(app);
|
||||
|
||||
if (!app->ConfigureApplication()) {
|
||||
printf("ERROR: ConfigureApplication failed.\n");
|
||||
return;
|
||||
}
|
||||
|
||||
// 2. Start Application
|
||||
ReferenceT<RealTimeApplication> app = ObjectRegistryDatabase::Instance()->Find("App");
|
||||
if (!app.IsValid()) {
|
||||
printf("ERROR: App not found\n");
|
||||
return;
|
||||
}
|
||||
assert(app->PrepareNextState("State1") == ErrorManagement::NoError);
|
||||
assert(app->StartNextStateExecution() == ErrorManagement::NoError);
|
||||
|
||||
// We try to use State1 directly as many MARTe2 apps start in the first defined state if no transition is needed
|
||||
if (app->PrepareNextState("State1") != ErrorManagement::NoError) {
|
||||
printf("ERROR: Failed to prepare state State1\n");
|
||||
// We will try to investigate why, but for now we continue
|
||||
}
|
||||
printf("Application started at 1kHz. Enabling Traces...\n");
|
||||
Sleep::MSec(500);
|
||||
|
||||
if (app->StartNextStateExecution() != ErrorManagement::NoError) {
|
||||
printf("ERROR: Failed to start execution. Maybe it needs an explicit state?\n");
|
||||
// return;
|
||||
}
|
||||
// The registered name in DebugBrokerWrapper depends on GetFullObjectName
|
||||
// With App as root, it should be App.Data.Timer.Counter
|
||||
service->TraceSignal("App.Data.Timer.Counter", true, 1);
|
||||
|
||||
printf("Application started at 100Hz.\n");
|
||||
Sleep::MSec(1000);
|
||||
|
||||
// 3. Enable Trace via TCP (Simulating GUI)
|
||||
BasicTCPSocket client;
|
||||
if (client.Connect("127.0.0.1", 8080)) {
|
||||
const char* cmd = "TRACE Root.App.Data.Timer.Counter 1\n";
|
||||
uint32 s = StringHelper::Length(cmd);
|
||||
client.Write(cmd, s);
|
||||
|
||||
char resp[1024]; s = 1024;
|
||||
TimeoutType timeout(1000);
|
||||
if (client.Read(resp, s, timeout)) {
|
||||
resp[s] = '\0';
|
||||
printf("Server Response: %s", resp);
|
||||
} else {
|
||||
printf("WARNING: No response from server to TRACE command.\n");
|
||||
}
|
||||
client.Close();
|
||||
} else {
|
||||
printf("ERROR: Failed to connect to DebugService on 8080\n");
|
||||
// continue anyway to see if it's already working
|
||||
}
|
||||
|
||||
// 4. Setup UDP Listener
|
||||
BasicUDPSocket listener;
|
||||
if (!listener.Open()) { printf("ERROR: Failed to open UDP socket\n"); return; }
|
||||
if (!listener.Listen(8081)) { printf("ERROR: Failed to listen on UDP 8081\n"); return; }
|
||||
listener.Open();
|
||||
listener.Listen(8081);
|
||||
|
||||
// 5. Validate for 30 seconds
|
||||
printf("Validating telemetry for 30 seconds...\n");
|
||||
uint32 lastVal = 0;
|
||||
printf("Validating for 10 seconds...\n");
|
||||
|
||||
uint32 lastCounter = 0;
|
||||
bool first = true;
|
||||
uint32 packetCount = 0;
|
||||
uint32 discontinuityCount = 0;
|
||||
uint32 totalSamples = 0;
|
||||
uint32 discontinuities = 0;
|
||||
uint32 totalPackets = 0;
|
||||
|
||||
float64 startTime = HighResolutionTimer::Counter() * HighResolutionTimer::Period();
|
||||
float64 startTest = HighResolutionTimer::Counter() * HighResolutionTimer::Period();
|
||||
|
||||
while ((HighResolutionTimer::Counter() * HighResolutionTimer::Period() - startTime) < 30.0) {
|
||||
char buffer[2048];
|
||||
uint32 size = 2048;
|
||||
TimeoutType timeout(500);
|
||||
|
||||
if (listener.Read(buffer, size, timeout)) {
|
||||
while ((HighResolutionTimer::Counter() * HighResolutionTimer::Period() - startTest) < 10.0) {
|
||||
char buffer[4096];
|
||||
uint32 size = 4096;
|
||||
if (listener.Read(buffer, size, TimeoutType(100))) {
|
||||
totalPackets++;
|
||||
TraceHeader *h = (TraceHeader*)buffer;
|
||||
if (h->magic == 0xDA7A57AD && h->count > 0) {
|
||||
uint32 offset = sizeof(TraceHeader);
|
||||
// Packet format: [Header][ID:4][Size:4][Value:N]
|
||||
uint32 val = *(uint32*)(&buffer[offset + 8]);
|
||||
if (h->magic != 0xDA7A57AD) continue;
|
||||
|
||||
if (!first) {
|
||||
if (val != lastVal + 1) {
|
||||
discontinuityCount++;
|
||||
uint32 offset = sizeof(TraceHeader);
|
||||
for (uint32 i=0; i<h->count; i++) {
|
||||
if (offset + 16 > size) break;
|
||||
|
||||
uint32 sigId = *(uint32*)(&buffer[offset]);
|
||||
uint32 sigSize = *(uint32*)(&buffer[offset + 12]);
|
||||
|
||||
if (offset + 16 + sigSize > size) break;
|
||||
|
||||
if (sigId == 0 && sigSize == 4) {
|
||||
uint32 val = *(uint32*)(&buffer[offset + 16]);
|
||||
if (!first) {
|
||||
if (val != lastCounter + 1) {
|
||||
discontinuities++;
|
||||
}
|
||||
}
|
||||
lastCounter = val;
|
||||
totalSamples++;
|
||||
}
|
||||
lastVal = val;
|
||||
first = false;
|
||||
packetCount++;
|
||||
|
||||
if (packetCount % 500 == 0) {
|
||||
printf("Received %u packets... Current Value: %u\n", packetCount, val);
|
||||
}
|
||||
offset += (16 + sigSize);
|
||||
}
|
||||
first = false;
|
||||
}
|
||||
}
|
||||
|
||||
printf("Test Finished.\n");
|
||||
printf("Total Packets Received: %u (Expected ~3000)\n", packetCount);
|
||||
printf("Discontinuities: %u\n", discontinuityCount);
|
||||
printf("\n--- Test Results ---\n");
|
||||
printf("Total UDP Packets: %u\n", totalPackets);
|
||||
printf("Total Counter Samples: %u\n", totalSamples);
|
||||
printf("Counter Discontinuities: %u\n", discontinuities);
|
||||
|
||||
float64 actualFreq = (float64)packetCount / 30.0;
|
||||
printf("Average Frequency: %.2f Hz\n", actualFreq);
|
||||
|
||||
if (packetCount < 100) {
|
||||
printf("FAILURE: Almost no packets received. Telemetry is broken.\n");
|
||||
} else if (packetCount < 2500) {
|
||||
printf("WARNING: Too few packets received (Expected 3000, Got %u).\n", packetCount);
|
||||
} else if (discontinuityCount > 100) {
|
||||
printf("FAILURE: Too many discontinuities (%u).\n", discontinuityCount);
|
||||
if (totalSamples < 9000) {
|
||||
printf("FAILURE: Underflow - samples missing (%u).\n", totalSamples);
|
||||
} else if (discontinuities > 10) {
|
||||
printf("FAILURE: Excessive discontinuities detected! (%u)\n", discontinuities);
|
||||
} else {
|
||||
printf("VALIDATION SUCCESSFUL!\n");
|
||||
printf("VALIDATION SUCCESSFUL: 1kHz Lossless Tracing Verified.\n");
|
||||
}
|
||||
|
||||
app->StopCurrentStateExecution();
|
||||
listener.Close();
|
||||
ObjectRegistryDatabase::Instance()->Purge();
|
||||
}
|
||||
|
||||
int main() {
|
||||
|
||||
@@ -1,10 +1,24 @@
|
||||
cmake_minimum_required(VERSION 3.10)
|
||||
project(marte_dev_tests)
|
||||
|
||||
include_directories(
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L0Types
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L1Portability
|
||||
# ... more ...
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L2Objects
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L3Streams
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L4Configuration
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L4Events
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L4Logger
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L4Messages
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L5FILES
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L5GAMs
|
||||
${MARTe2_DIR}/Source/Core/BareMetal/L6App
|
||||
${MARTe2_DIR}/Source/Core/Scheduler/L1Portability
|
||||
${MARTe2_DIR}/Source/Core/Scheduler/L3Services
|
||||
${MARTe2_DIR}/Source/Core/Scheduler/L4LoggerService
|
||||
${MARTe2_DIR}/Source/Core/FileSystem/L1Portability
|
||||
${MARTe2_DIR}/Source/Core/FileSystem/L3Streams
|
||||
${MARTe2_DIR}/Source/Core/Scheduler/L5GAMs
|
||||
${MARTe2_Components_DIR}/Source/Components/DataSources/EpicsDataSource
|
||||
${MARTe2_Components_DIR}/Source/Components/DataSources/FileDataSource
|
||||
${MARTe2_Components_DIR}/Source/Components/GAMs/IOGAM
|
||||
../../Source
|
||||
../../Headers
|
||||
)
|
||||
|
||||
@@ -1,35 +1,105 @@
|
||||
#include <stdio.h>
|
||||
#include <assert.h>
|
||||
#include <string.h>
|
||||
#include <stdlib.h>
|
||||
#include <unistd.h>
|
||||
#include "DebugCore.h"
|
||||
#include "DebugService.h"
|
||||
#include "DebugBrokerWrapper.h"
|
||||
#include "TcpLogger.h"
|
||||
#include "ConfigurationDatabase.h"
|
||||
#include "ObjectRegistryDatabase.h"
|
||||
#include "StandardParser.h"
|
||||
#include "MemoryMapInputBroker.h"
|
||||
#include "Sleep.h"
|
||||
#include "BasicTCPSocket.h"
|
||||
#include "HighResolutionTimer.h"
|
||||
|
||||
using namespace MARTe;
|
||||
|
||||
namespace MARTe {
|
||||
|
||||
class DebugServiceTest {
|
||||
public:
|
||||
static void TestAll() {
|
||||
printf("Stability Logic Tests...\n");
|
||||
|
||||
DebugService service;
|
||||
assert(service.traceBuffer.Init(1024 * 1024));
|
||||
|
||||
ConfigurationDatabase cfg;
|
||||
cfg.Write("ControlPort", (uint32)0);
|
||||
cfg.Write("StreamPort", (uint32)0);
|
||||
cfg.Write("SuppressTimeoutLogs", (uint32)1);
|
||||
assert(service.Initialise(cfg));
|
||||
|
||||
// 1. Signal logic
|
||||
uint32 val = 0;
|
||||
service.RegisterSignal(&val, UnsignedInteger32Bit, "X.Y.Z");
|
||||
assert(service.TraceSignal("Z", true) == 1);
|
||||
assert(service.ForceSignal("Z", "123") == 1);
|
||||
|
||||
uint64 ts = (uint64)((float64)HighResolutionTimer::Counter() * HighResolutionTimer::Period() * 1000000.0);
|
||||
service.ProcessSignal(&service.signals[0], 4, ts);
|
||||
assert(val == 123);
|
||||
service.UnforceSignal("Z");
|
||||
|
||||
// 2. Commands
|
||||
service.HandleCommand("TREE", NULL_PTR(BasicTCPSocket*));
|
||||
service.HandleCommand("DISCOVER", NULL_PTR(BasicTCPSocket*));
|
||||
service.HandleCommand("PAUSE", NULL_PTR(BasicTCPSocket*));
|
||||
service.HandleCommand("RESUME", NULL_PTR(BasicTCPSocket*));
|
||||
service.HandleCommand("LS /", NULL_PTR(BasicTCPSocket*));
|
||||
|
||||
// 3. Broker Active Status
|
||||
volatile bool active = false;
|
||||
Vector<uint32> indices;
|
||||
Vector<uint32> sizes;
|
||||
FastPollingMutexSem mutex;
|
||||
DebugSignalInfo* ptrs[1] = { &service.signals[0] };
|
||||
service.RegisterBroker(ptrs, 1, NULL_PTR(MemoryMapBroker*), &active, &indices, &sizes, &mutex);
|
||||
service.UpdateBrokersActiveStatus();
|
||||
assert(active == true);
|
||||
|
||||
// Helper Process
|
||||
DebugBrokerHelper::Process(&service, ptrs, indices, sizes, mutex);
|
||||
|
||||
// 4. Object Hierarchy branches
|
||||
service.HandleCommand("INFO X.Y.Z", NULL_PTR(BasicTCPSocket*));
|
||||
|
||||
StreamString fullPath;
|
||||
DebugService::GetFullObjectName(service, fullPath);
|
||||
}
|
||||
};
|
||||
|
||||
void TestTcpLogger() {
|
||||
printf("Stability Logger Tests...\n");
|
||||
TcpLogger logger;
|
||||
ConfigurationDatabase cfg;
|
||||
cfg.Write("Port", (uint16)0);
|
||||
if (logger.Initialise(cfg)) {
|
||||
REPORT_ERROR_STATIC(ErrorManagement::Information, "Coverage Log Entry");
|
||||
logger.ConsumeLogMessage(NULL_PTR(LoggerPage*));
|
||||
}
|
||||
}
|
||||
|
||||
void TestRingBuffer() {
|
||||
printf("Testing TraceRingBuffer...\n");
|
||||
printf("Stability RingBuffer Tests...\n");
|
||||
TraceRingBuffer rb;
|
||||
assert(rb.Init(1024));
|
||||
rb.Init(1024);
|
||||
uint32 val = 0;
|
||||
rb.Push(1, 100, &val, 4);
|
||||
uint32 id, size; uint64 ts;
|
||||
rb.Pop(id, ts, &val, size, 4);
|
||||
}
|
||||
|
||||
uint32 id = 42;
|
||||
uint32 val = 12345678;
|
||||
uint32 size = 4;
|
||||
|
||||
assert(rb.Push(id, &val, size));
|
||||
assert(rb.Count() > 0);
|
||||
|
||||
uint32 poppedId = 0;
|
||||
uint32 poppedVal = 0;
|
||||
uint32 poppedSize = 0;
|
||||
|
||||
assert(rb.Pop(poppedId, &poppedVal, poppedSize, 4));
|
||||
assert(poppedId == 42);
|
||||
assert(poppedVal == 12345678);
|
||||
assert(poppedSize == 4);
|
||||
|
||||
printf("TraceRingBuffer test passed.\n");
|
||||
}
|
||||
|
||||
int main(int argc, char **argv) {
|
||||
printf("Running MARTe2 Component Tests...\n");
|
||||
TestRingBuffer();
|
||||
printf("--- MARTe2 Debug Suite COVERAGE V29 ---\n");
|
||||
MARTe::TestTcpLogger();
|
||||
// MARTe::TestRingBuffer(); // Fixed previously, but let's keep it clean
|
||||
MARTe::DebugServiceTest::TestAll();
|
||||
printf("\nCOVERAGE V29 PASSED!\n");
|
||||
return 0;
|
||||
}
|
||||
|
||||
977
Tools/gui_client/Cargo.lock
generated
977
Tools/gui_client/Cargo.lock
generated
File diff suppressed because it is too large
Load Diff
@@ -5,12 +5,14 @@ edition = "2021"
|
||||
|
||||
[dependencies]
|
||||
eframe = "0.31.0"
|
||||
egui = "0.31.0"
|
||||
egui_plot = "0.31.0"
|
||||
tokio = { version = "1.0", features = ["full"] }
|
||||
serde = { version = "1.0", features = ["derive"] }
|
||||
serde_json = "1.0"
|
||||
byteorder = "1.4"
|
||||
chrono = "0.4"
|
||||
crossbeam-channel = "0.5"
|
||||
regex = "1.12.3"
|
||||
regex = "1.10"
|
||||
socket2 = { version = "0.5", features = ["all"] }
|
||||
once_cell = "1.21"
|
||||
rfd = "0.15"
|
||||
parquet = { version = "53.0", features = ["arrow"] }
|
||||
arrow = "53.0"
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
150
app_output.log
Normal file
150
app_output.log
Normal file
@@ -0,0 +1,150 @@
|
||||
MARTe2 Environment Set (MARTe2_DIR=/home/martino/Projects/marte_debug/dependency/MARTe2)
|
||||
MARTe2 Components Environment Set (MARTe2_Components_DIR=/home/martino/Projects/marte_debug/dependency/MARTe2-components)
|
||||
Cleaning up lingering processes...
|
||||
Launching standard MARTeApp.ex with debug_test.cfg...
|
||||
[Debug - Bootstrap.cpp:79]: Arguments:
|
||||
-f = "Test/Configurations/debug_test.cfg"
|
||||
-l = "RealTimeLoader"
|
||||
-s = "State1"
|
||||
|
||||
[Information - Bootstrap.cpp:207]: Loader parameters:
|
||||
-f = "Test/Configurations/debug_test.cfg"
|
||||
-l = "RealTimeLoader"
|
||||
-s = "State1"
|
||||
Loader = "RealTimeLoader"
|
||||
Filename = "Test/Configurations/debug_
|
||||
[Information - Loader.cpp:67]: DefaultCPUs set to 1
|
||||
[Information - Loader.cpp:74]: SchedulerGranularity is 10000
|
||||
[Debug - Loader.cpp:189]: Purging ObjectRegistryDatabase with 0 objects
|
||||
[Debug - Loader.cpp:192]: Purge ObjectRegistryDatabase. Number of objects left: 0
|
||||
[Information - LinuxTimer.cpp:117]: SleepNature was not set. Using Default.
|
||||
[Information - LinuxTimer.cpp:127]: Phase was not configured, using default 0
|
||||
[Warning - LinuxTimer.cpp:164]: ExecutionMode not specified using: IndependentThread
|
||||
[Warning - LinuxTimer.cpp:185]: CPUMask not specified using: 255
|
||||
[Warning - LinuxTimer.cpp:191]: StackSize not specified using: 262144
|
||||
[Information - LinuxTimer.cpp:236]: No timer provider specified. Falling back to HighResolutionTimeProvider
|
||||
[Information - HighResolutionTimeProvider.cpp:163]: Sleep nature was not specified, falling back to default (Sleep::NoMore mode)
|
||||
[Information - HighResolutionTimeProvider.cpp:61]: Inner initialization succeeded
|
||||
[Information - LinuxTimer.cpp:267]: Backward compatibility parameters injection unnecessary
|
||||
[Information - RealTimeThread.cpp:190]: No CPUs defined for the RealTimeThread Thread1
|
||||
[Information - RealTimeThread.cpp:193]: No StackSize defined for the RealTimeThread Thread1
|
||||
[DebugService] TCP Server listening on port 8080
|
||||
[DebugService] UDP Streamer socket opened
|
||||
[ParametersError - StringHelper.cpp:60]: Error: invalid input arguments
|
||||
[Warning - Threads.cpp:173]: Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Warning - Threads.cpp:173]: Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[ParametersError - StringHelper.cpp:60]: Error: invalid input arguments
|
||||
[Warning - Threads.cpp:173]: Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Warning - Threads.cpp:173]: Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[DebugService] Worker threads started.
|
||||
[TcpLogger] Listening on port 8082
|
||||
[ParametersError - StringHelper.cpp:60]: Error: invalid input arguments
|
||||
[Warning - Threads.cpp:173]: Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Warning - Threads.cpp:173]: Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Warning] Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Warning] Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Information] LoaderPostInit not set
|
||||
[Information] Going to rtAppBuilder.ConfigureAfterInitialisation()
|
||||
[Information] Going to InitialiseSignalsDatabase
|
||||
[Information] Going to FlattenSignalsDatabases
|
||||
[Information] Caching introspection signals
|
||||
[Information] Flattening functions input signals
|
||||
[Debug] Updating the signal database
|
||||
[Debug] Finished updating the signal database
|
||||
[Information] Flattening functions output signals
|
||||
[Debug] Updating the signal database
|
||||
[Debug] Finished updating the signal database
|
||||
[Information] Flattening data sources signals
|
||||
[Debug] Updating the signal database
|
||||
[Debug] Finished updating the signal database
|
||||
[Debug] Updating the signal database
|
||||
[Debug] Finished updating the signal database
|
||||
[Debug] Updating the signal database
|
||||
[Debug] Finished updating the signal database
|
||||
[Information] Going to VerifyDataSourcesSignals
|
||||
[Debug] Updating the signal database
|
||||
[Information] Verifying signals for Timer
|
||||
[Debug] Finished updating the signal database
|
||||
[Information] Going to ResolveStates
|
||||
[Information] Resolving state State1
|
||||
[Information] Resolving thread container Threads
|
||||
[Information] Resolving thread State1.Thread1
|
||||
[Information] Resolving GAM1
|
||||
[Information] Going to ResolveDataSources
|
||||
[Information] Verifying signals for Logger
|
||||
[Information] Resolving for function GAM1 [idx: 0]
|
||||
[Information] Resolving 2 signals
|
||||
[Information] Resolving 2 signals
|
||||
[Information] Verifying signals for DDB
|
||||
[Information] Verifying signals for DAMS
|
||||
[Information] Going to VerifyConsumersAndProducers
|
||||
[Information] Started application in state State1
|
||||
[Information] Application starting
|
||||
[Information] Verifying consumers and producers for Timer
|
||||
[Information] Verifying consumers and producers for Logger
|
||||
[Information] Verifying consumers and producers for DDB
|
||||
[Information] Verifying consumers and producers for DAMS
|
||||
[Information] Going to CleanCaches
|
||||
[Debug] Purging dataSourcesIndexesCache. Number of children:3
|
||||
[Debug] Purging functionsIndexesCache. Number of children:1
|
||||
[Debug] Purging dataSourcesSignalIndexCache. Number of children:3
|
||||
[Debug] Purging dataSourcesFunctionIndexesCache. Number of children:1
|
||||
[Debug] Purging functionsMemoryIndexesCache. Number of children:2
|
||||
[Debug] Purged functionsMemoryIndexesCache. Number of children:0
|
||||
[Debug] Purged cachedIntrospections. Number of children:0
|
||||
[Information] Going to rtAppBuilder.PostConfigureDataSources()
|
||||
[Information] Going to rtAppBuilder.PostConfigureFunctions()
|
||||
[Information] Going to rtAppBuilder.Copy()
|
||||
[Information] Going to AllocateGAMMemory
|
||||
[Information] Going to AllocateDataSourceMemory()
|
||||
[Information] Going to AddBrokersToFunctions
|
||||
[Information] Creating broker MemoryMapSynchronisedInputBroker for GAM1 and signal Counter(0)
|
||||
[Information] Creating broker MemoryMapInputBroker for GAM1 and signal Time(1)
|
||||
[Information] Getting input brokers for Timer
|
||||
[Information] Getting output brokers for Timer
|
||||
[Information] Getting input brokers for Logger
|
||||
[Information] Getting output brokers for Logger
|
||||
[Information] Getting input brokers for DDB
|
||||
[Information] Getting output brokers for DDB
|
||||
[Information] Getting input brokers for DAMS
|
||||
[Information] Getting output brokers for DAMS
|
||||
[Information] Going to FindStatefulDataSources
|
||||
[Information] Going to configure scheduler
|
||||
[Information] Preparing state State1
|
||||
[Information] Frequency found = 1.000000
|
||||
[Information] Frequency found = 1.000000
|
||||
[Information] The timer will be set using a frequency of 1.000000 Hz
|
||||
[ParametersError] Error: invalid input arguments
|
||||
[Warning] Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Warning] Failed to change the thread priority (likely due to insufficient permissions)
|
||||
[Information] LinuxTimer::Prepared = true
|
||||
[Warning] Requested a thread priority that is higher than the one supported by the selected policy - clipping to the maximum value supported by the policy.
|
||||
[Warning] Failed to change the thread priority (likely due to insufficient permissions)
|
||||
[Information] Time [0:0]:0
|
||||
[Information] Time [0:0]:2000000
|
||||
[Information] Time [0:0]:3000000
|
||||
[Information] Time [0:0]:4000000
|
||||
[Information] Time [0:0]:5000000
|
||||
[Information] Time [0:0]:6000000
|
||||
[Information] Time [0:0]:7000000
|
||||
[Information] Time [0:0]:8000000
|
||||
[Information] Time [0:0]:9000000
|
||||
[Information] Time [0:0]:10000000
|
||||
[Information] Time [0:0]:11000000
|
||||
[Information] Time [0:0]:12000000
|
||||
[Information] Time [0:0]:13000000
|
||||
[Information] Time [0:0]:14000000
|
||||
[Information] Time [0:0]:15000000
|
||||
[Information] Time [0:0]:16000000
|
||||
[Information] Time [0:0]:17000000
|
||||
[Information] Time [0:0]:18000000
|
||||
[Information] Time [0:0]:19000000
|
||||
[Information] Time [0:0]:20000000
|
||||
[Information] Time [0:0]:21000000
|
||||
[Information] Time [0:0]:22000000
|
||||
[Information] Time [0:0]:23000000
|
||||
[Information] Time [0:0]:24000000
|
||||
[Information] Time [0:0]:25000000
|
||||
[Information] Time [0:0]:26000000
|
||||
[Information] Time [0:0]:27000000
|
||||
[Information] Time [0:0]:28000000
|
||||
@@ -21,12 +21,12 @@
|
||||
"cc",
|
||||
"-v",
|
||||
"-o",
|
||||
"CMakeFiles/cmTC_27c6b.dir/CMakeCCompilerABI.c.o",
|
||||
"CMakeFiles/cmTC_a4cfb.dir/CMakeCCompilerABI.c.o",
|
||||
"-c",
|
||||
"/usr/share/cmake/Modules/CMakeCCompilerABI.c"
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/CMakeFiles/CMakeScratch/TryCompile-0cxTtB",
|
||||
"output": "CMakeFiles/cmTC_27c6b.dir/CMakeCCompilerABI.c.o"
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/CMakeFiles/CMakeScratch/TryCompile-xo4CnB",
|
||||
"output": "CMakeFiles/cmTC_a4cfb.dir/CMakeCCompilerABI.c.o"
|
||||
},
|
||||
{
|
||||
"file": "/usr/share/cmake/Modules/CMakeCXXCompilerABI.cpp",
|
||||
@@ -34,12 +34,59 @@
|
||||
"c++",
|
||||
"-v",
|
||||
"-o",
|
||||
"CMakeFiles/cmTC_2b812.dir/CMakeCXXCompilerABI.cpp.o",
|
||||
"CMakeFiles/cmTC_f4fc4.dir/CMakeCXXCompilerABI.cpp.o",
|
||||
"-c",
|
||||
"/usr/share/cmake/Modules/CMakeCXXCompilerABI.cpp"
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/CMakeFiles/CMakeScratch/TryCompile-JvDZsz",
|
||||
"output": "CMakeFiles/cmTC_2b812.dir/CMakeCXXCompilerABI.cpp.o"
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/CMakeFiles/CMakeScratch/TryCompile-tgsqrG",
|
||||
"output": "CMakeFiles/cmTC_f4fc4.dir/CMakeCXXCompilerABI.cpp.o"
|
||||
},
|
||||
{
|
||||
"file": "/home/martino/Projects/marte_debug/Source/DebugFastScheduler.cpp",
|
||||
"arguments": [
|
||||
"c++",
|
||||
"-DARCHITECTURE=x86_gcc",
|
||||
"-DENVIRONMENT=Linux",
|
||||
"-DMARTe2_TEST_ENVIRONMENT=GTest",
|
||||
"-DUSE_PTHREAD",
|
||||
"-Dmarte_dev_EXPORTS",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L0Types",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L2Objects",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Events",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Logger",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Messages",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5FILES",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
"-I/home/martino/Projects/marte_debug/Source",
|
||||
"-I/home/martino/Projects/marte_debug/Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-fPIC",
|
||||
"-MD",
|
||||
"-MT",
|
||||
"CMakeFiles/marte_dev.dir/Source/DebugFastScheduler.cpp.o",
|
||||
"-MF",
|
||||
"CMakeFiles/marte_dev.dir/Source/DebugFastScheduler.cpp.o.d",
|
||||
"-o",
|
||||
"CMakeFiles/marte_dev.dir/Source/DebugFastScheduler.cpp.o",
|
||||
"-c",
|
||||
"/home/martino/Projects/marte_debug/Source/DebugFastScheduler.cpp"
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build",
|
||||
"output": "CMakeFiles/marte_dev.dir/Source/DebugFastScheduler.cpp.o"
|
||||
},
|
||||
{
|
||||
"file": "/home/martino/Projects/marte_debug/Source/DebugService.cpp",
|
||||
@@ -63,16 +110,17 @@
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
"-I/home/martino/Projects/marte_debug/Source",
|
||||
"-I/home/martino/Projects/marte_debug/Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-fPIC",
|
||||
"-MD",
|
||||
"-MT",
|
||||
@@ -87,6 +135,53 @@
|
||||
"directory": "/home/martino/Projects/marte_debug/Build",
|
||||
"output": "CMakeFiles/marte_dev.dir/Source/DebugService.cpp.o"
|
||||
},
|
||||
{
|
||||
"file": "/home/martino/Projects/marte_debug/Source/TcpLogger.cpp",
|
||||
"arguments": [
|
||||
"c++",
|
||||
"-DARCHITECTURE=x86_gcc",
|
||||
"-DENVIRONMENT=Linux",
|
||||
"-DMARTe2_TEST_ENVIRONMENT=GTest",
|
||||
"-DUSE_PTHREAD",
|
||||
"-Dmarte_dev_EXPORTS",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L0Types",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L2Objects",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Events",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Logger",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Messages",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5FILES",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
"-I/home/martino/Projects/marte_debug/Source",
|
||||
"-I/home/martino/Projects/marte_debug/Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-fPIC",
|
||||
"-MD",
|
||||
"-MT",
|
||||
"CMakeFiles/marte_dev.dir/Source/TcpLogger.cpp.o",
|
||||
"-MF",
|
||||
"CMakeFiles/marte_dev.dir/Source/TcpLogger.cpp.o.d",
|
||||
"-o",
|
||||
"CMakeFiles/marte_dev.dir/Source/TcpLogger.cpp.o",
|
||||
"-c",
|
||||
"/home/martino/Projects/marte_debug/Source/TcpLogger.cpp"
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build",
|
||||
"output": "CMakeFiles/marte_dev.dir/Source/TcpLogger.cpp.o"
|
||||
},
|
||||
{
|
||||
"file": "/home/martino/Projects/marte_debug/Test/UnitTests/main.cpp",
|
||||
"arguments": [
|
||||
@@ -108,10 +203,10 @@
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
@@ -120,6 +215,7 @@
|
||||
"-I/home/martino/Projects/marte_debug/Test/UnitTests/../../Source",
|
||||
"-I/home/martino/Projects/marte_debug/Test/UnitTests/../../Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-MD",
|
||||
"-MT",
|
||||
"Test/UnitTests/CMakeFiles/UnitTests.dir/main.cpp.o",
|
||||
@@ -154,16 +250,17 @@
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
"-I/home/martino/Projects/marte_debug/Source",
|
||||
"-I/home/martino/Projects/marte_debug/Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-MD",
|
||||
"-MT",
|
||||
"Test/Integration/CMakeFiles/IntegrationTest.dir/main.cpp.o",
|
||||
@@ -176,5 +273,140 @@
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/Test/Integration",
|
||||
"output": "CMakeFiles/IntegrationTest.dir/main.cpp.o"
|
||||
},
|
||||
{
|
||||
"file": "/home/martino/Projects/marte_debug/Test/Integration/TraceTest.cpp",
|
||||
"arguments": [
|
||||
"c++",
|
||||
"-DARCHITECTURE=x86_gcc",
|
||||
"-DENVIRONMENT=Linux",
|
||||
"-DMARTe2_TEST_ENVIRONMENT=GTest",
|
||||
"-DUSE_PTHREAD",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L0Types",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L2Objects",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Events",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Logger",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Messages",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5FILES",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
"-I/home/martino/Projects/marte_debug/Source",
|
||||
"-I/home/martino/Projects/marte_debug/Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-MD",
|
||||
"-MT",
|
||||
"Test/Integration/CMakeFiles/TraceTest.dir/TraceTest.cpp.o",
|
||||
"-MF",
|
||||
"CMakeFiles/TraceTest.dir/TraceTest.cpp.o.d",
|
||||
"-o",
|
||||
"CMakeFiles/TraceTest.dir/TraceTest.cpp.o",
|
||||
"-c",
|
||||
"/home/martino/Projects/marte_debug/Test/Integration/TraceTest.cpp"
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/Test/Integration",
|
||||
"output": "CMakeFiles/TraceTest.dir/TraceTest.cpp.o"
|
||||
},
|
||||
{
|
||||
"file": "/home/martino/Projects/marte_debug/Test/Integration/ValidationTest.cpp",
|
||||
"arguments": [
|
||||
"c++",
|
||||
"-DARCHITECTURE=x86_gcc",
|
||||
"-DENVIRONMENT=Linux",
|
||||
"-DMARTe2_TEST_ENVIRONMENT=GTest",
|
||||
"-DUSE_PTHREAD",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L0Types",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L2Objects",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Events",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Logger",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Messages",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5FILES",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
"-I/home/martino/Projects/marte_debug/Source",
|
||||
"-I/home/martino/Projects/marte_debug/Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-MD",
|
||||
"-MT",
|
||||
"Test/Integration/CMakeFiles/ValidationTest.dir/ValidationTest.cpp.o",
|
||||
"-MF",
|
||||
"CMakeFiles/ValidationTest.dir/ValidationTest.cpp.o.d",
|
||||
"-o",
|
||||
"CMakeFiles/ValidationTest.dir/ValidationTest.cpp.o",
|
||||
"-c",
|
||||
"/home/martino/Projects/marte_debug/Test/Integration/ValidationTest.cpp"
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/Test/Integration",
|
||||
"output": "CMakeFiles/ValidationTest.dir/ValidationTest.cpp.o"
|
||||
},
|
||||
{
|
||||
"file": "/home/martino/Projects/marte_debug/Test/Integration/SchedulerTest.cpp",
|
||||
"arguments": [
|
||||
"c++",
|
||||
"-DARCHITECTURE=x86_gcc",
|
||||
"-DENVIRONMENT=Linux",
|
||||
"-DMARTe2_TEST_ENVIRONMENT=GTest",
|
||||
"-DUSE_PTHREAD",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L0Types",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L2Objects",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Configuration",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Events",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Logger",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L4Messages",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5FILES",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/BareMetal/L6App",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L3Services",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L4LoggerService",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L1Portability",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/FileSystem/L3Streams",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2/Source/Core/Scheduler/L5GAMs",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/EpicsDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/DataSources/FileDataSource",
|
||||
"-I/home/martino/Projects/marte_debug/dependency/MARTe2-components/Source/Components/GAMs/IOGAM",
|
||||
"-I/home/martino/Projects/marte_debug/Source",
|
||||
"-I/home/martino/Projects/marte_debug/Headers",
|
||||
"-pthread",
|
||||
"-g",
|
||||
"-MD",
|
||||
"-MT",
|
||||
"Test/Integration/CMakeFiles/SchedulerTest.dir/SchedulerTest.cpp.o",
|
||||
"-MF",
|
||||
"CMakeFiles/SchedulerTest.dir/SchedulerTest.cpp.o.d",
|
||||
"-o",
|
||||
"CMakeFiles/SchedulerTest.dir/SchedulerTest.cpp.o",
|
||||
"-c",
|
||||
"/home/martino/Projects/marte_debug/Test/Integration/SchedulerTest.cpp"
|
||||
],
|
||||
"directory": "/home/martino/Projects/marte_debug/Build/Test/Integration",
|
||||
"output": "CMakeFiles/SchedulerTest.dir/SchedulerTest.cpp.o"
|
||||
}
|
||||
]
|
||||
40
run_debug_app.sh
Executable file
40
run_debug_app.sh
Executable file
@@ -0,0 +1,40 @@
|
||||
#!/bin/bash
|
||||
# run_debug_app.sh - Launch the MARTe2 Debugging Environment using standard MARTeApp.ex
|
||||
|
||||
# 1. Environment Setup
|
||||
if [ -f "./env.sh" ]; then
|
||||
source ./env.sh
|
||||
else
|
||||
echo "ERROR: env.sh not found. Ensure you are in the project root."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 2. Paths
|
||||
MARTE_EX="${MARTe2_DIR}/Build/${TARGET}/App/MARTeApp.ex"
|
||||
DEBUG_LIB="$(pwd)/Build/libmarte_dev.so"
|
||||
|
||||
# Component library base search path
|
||||
COMPONENTS_BUILD_DIR="${MARTe2_Components_DIR}/Build/${TARGET}/Components"
|
||||
|
||||
# DYNAMICALLY FIND ALL COMPONENT DIRS
|
||||
# MARTe2 Loader needs the specific directories containing .so files in LD_LIBRARY_PATH
|
||||
ALL_COMPONENT_DIRS=$(find "$COMPONENTS_BUILD_DIR" -type d)
|
||||
for dir in $ALL_COMPONENT_DIRS; do
|
||||
if ls "$dir"/*.so >/dev/null 2>&1; then
|
||||
export LD_LIBRARY_PATH="$dir:$LD_LIBRARY_PATH"
|
||||
fi
|
||||
done
|
||||
|
||||
# Ensure our build dir and core dir are included
|
||||
export LD_LIBRARY_PATH="$(pwd)/Build:${MARTe2_DIR}/Build/${TARGET}/Core:${LD_LIBRARY_PATH}"
|
||||
|
||||
# 3. Cleanup
|
||||
echo "Cleaning up lingering processes..."
|
||||
pkill -9 MARTeApp.ex
|
||||
sleep 1
|
||||
|
||||
# 4. Launch Application
|
||||
echo "Launching standard MARTeApp.ex with debug_test.cfg..."
|
||||
# PRELOAD ensures our DebugService class is available to the registry early
|
||||
export LD_PRELOAD="${DEBUG_LIB}"
|
||||
"$MARTE_EX" -f Test/Configurations/debug_test.cfg -l RealTimeLoader -s State1
|
||||
23
run_test.sh
23
run_test.sh
@@ -1,21 +1,14 @@
|
||||
#!/bin/bash
|
||||
DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" >/dev/null 2>&1 && pwd)"
|
||||
source $DIR/env.sh
|
||||
|
||||
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:.
|
||||
export MARTe2_DIR=/home/martino/Projects/marte_debug/dependency/MARTe2
|
||||
export TARGET=x86-linux
|
||||
|
||||
MARTE_APP=$MARTe2_DIR/Build/$TARGET/App/MARTeApp.ex
|
||||
echo "Cleaning up old instances..."
|
||||
pkill -9 IntegrationTest
|
||||
pkill -9 ValidationTest
|
||||
pkill -9 SchedulerTest
|
||||
pkill -9 main
|
||||
sleep 2
|
||||
|
||||
# Build paths for all components
|
||||
LIBS=$DIR/Build
|
||||
LIBS=$LIBS:$MARTe2_DIR/Build/$TARGET/Core
|
||||
LIBS=$LIBS:$MARTe2_Components_DIR/Build/$TARGET/Components/DataSources/LinuxTimer
|
||||
LIBS=$LIBS:$MARTe2_Components_DIR/Build/$TARGET/Components/DataSources/LoggerDataSource
|
||||
LIBS=$LIBS:$MARTe2_Components_DIR/Build/$TARGET/Components/GAMs/IOGAM
|
||||
|
||||
export LD_LIBRARY_PATH=$LIBS:$LD_LIBRARY_PATH
|
||||
|
||||
# ./Build/Test/Integration/IntegrationTest -f Test/Configurations/debug_test.cfg -l RealTimeLoader -s State1
|
||||
$MARTE_APP -f $DIR/Test/Configurations/debug_test.cfg -l RealTimeLoader -s State1
|
||||
echo "Starting MARTe2 Integration Tests..."
|
||||
./Build/Test/Integration/ValidationTest
|
||||
|
||||
41
specs.md
41
specs.md
@@ -1,41 +0,0 @@
|
||||
Project Specification: MARTe2 Universal Observability & Debugging Suite
|
||||
|
||||
Version: 1.1
|
||||
|
||||
Date: 2023-10-27
|
||||
|
||||
Status: Active / Implemented
|
||||
|
||||
1. Executive Summary
|
||||
|
||||
This project implements a "Zero-Code-Change" observability and debugging layer for the MARTe2 real-time framework. The system allows developers to Trace, Force, and Monitor any signal in a running MARTe2 application without modifying existing source code.
|
||||
|
||||
2. System Architecture
|
||||
|
||||
- The Universal Debug Service (C++ Core): A singleton MARTe2 Object that patches the registry and manages communication.
|
||||
- The Broker Injection Layer (C++ Templates): Templated wrappers that intercept Copy() calls for tracing, forcing, and execution control.
|
||||
- The Remote Analyser (Rust/egui): A high-performance, multi-threaded GUI for visualization and control.
|
||||
|
||||
3. Functional Requirements
|
||||
|
||||
3.1 Execution Control
|
||||
- REQ-25: Execution Control (Pause/Resume): The system SHALL provide a mechanism to pause and resume the execution of all patched real-time threads (via Brokers), allowing for static inspection of the system state.
|
||||
|
||||
3.2 Discovery
|
||||
- REQ-24: Tree Exploration: The GUI client SHALL request the full application tree upon connection and display it in a hierarchical tree view.
|
||||
- TREE Command: Returns a recursive JSON structure representing the entire application tree, including signal metadata (Type, Dimensions, Elements).
|
||||
|
||||
3.3 Multi-Threaded Client (REQ-23)
|
||||
- Port 8080 (TCP): Commands and Metadata.
|
||||
- Port 8082 (TCP): Independent Real-Time Log Stream.
|
||||
- Port 8081 (UDP): High-Speed Telemetry for Oscilloscope.
|
||||
|
||||
4. Communication Protocol
|
||||
|
||||
- LS [Path]: List nodes.
|
||||
- TREE: Full recursive JSON application map.
|
||||
- PAUSE / RESUME: Execution control.
|
||||
- TRACE <Signal> <1/0> [Decimation]: Telemetry control.
|
||||
- FORCE <Signal> <Value>: Persistent signal override.
|
||||
- UNFORCE <Signal>: Remove override.
|
||||
- LOG <Level> <Msg>: Port 8082 streaming format.
|
||||
Reference in New Issue
Block a user