dlt-sys 0.2.0

FFI bindings to libdlt
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

/*
 * Copyright (c) 2025 The Contributors to Eclipse OpenSOVD (see CONTRIBUTORS)
 *
 * See the NOTICE file(s) distributed with this work for additional
 * information regarding copyright ownership.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Apache License Version 2.0 which is available at
 * https://www.apache.org/licenses/LICENSE-2.0
 *
 * SPDX-License-Identifier: Apache-2.0
 */

#ifndef DLT_WRAPPER_H
#define DLT_WRAPPER_H

// Requires system DLT headers - set DLT_INCLUDE_DIR environment variable
#include <dlt/dlt.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

// Application management
DltReturnValue registerApplication(const char *appId, const char *appDescription);
DltReturnValue unregisterApplicationFlushBufferedLogs(void);
DltReturnValue dltFree(void);

// Context management
DltContext *createContext(void);
void freeContext(DltContext *context);
DltReturnValue registerContext(const char *contextId, const char *contextDescription, DltContext* context);
DltReturnValue unregisterContext(DltContext *context);
DltReturnValue getContextId(DltContext *context, char context_id[DLT_ID_SIZE]);
DltReturnValue getContextLogLevel(DltContext *context, int32_t *log_level);
DltReturnValue getContextTraceStatus(DltContext *context, int32_t *trace_status);

// Logging functions
DltReturnValue logDlt(DltContext *context, DltLogLevelType logLevel, const char *message);
DltReturnValue logDltString(DltContext *context, DltLogLevelType logLevel, const char *message);
DltReturnValue logDltUint(DltContext *context, DltLogLevelType logLevel, uint32_t value);
DltReturnValue logDltInt(DltContext *context, DltLogLevelType logLevel, int32_t value);

// Log write API (for structured logging)
DltContextData *createContextData(void);
void freeContextData(DltContextData *log);
DltReturnValue dltUserLogWriteStart(DltContext *context, DltContextData *log, DltLogLevelType logLevel);
DltReturnValue dltUserLogWriteFinish(DltContextData *log);
DltReturnValue setContextDataUserTimestamp(DltContextData *log, uint32_t timestamp);
DltReturnValue dltUserLogWriteString(DltContextData *log, const char *text);
DltReturnValue dltUserLogWriteUint(DltContextData *log, uint32_t data);
DltReturnValue dltUserLogWriteInt(DltContextData *log, int32_t data);
DltReturnValue dltUserLogWriteUint64(DltContextData *log, uint64_t data);
DltReturnValue dltUserLogWriteInt64(DltContextData *log, int64_t data);
DltReturnValue dltUserLogWriteFloat32(DltContextData *log, float data);
DltReturnValue dltUserLogWriteFloat64(DltContextData *log, double data);
DltReturnValue dltUserLogWriteBool(DltContextData *log, uint8_t data);

// Callback for log level changes
DltReturnValue registerLogLevelChangedCallback(
    DltContext *handle,
    void (*callback)(char context_id[DLT_ID_SIZE], uint8_t log_level, uint8_t trace_status)
);

#ifdef __cplusplus
}
#endif

#endif // DLT_WRAPPER_H