Platform Porting

typedef /* platform-specific */ ecod_socket_t;  // Socket handle
typedef /* platform-specific */ ecod_mutex_t;   // Mutex primitive
typedef struct {
    /* platform-specific fields for a waitable event */
} ecod_event_t;

// Called once at startup. Initialize platform resources (e.g., signal handling, log files).
EC_SDK_STATUS ecod_platform_init(void);

// Return current time in milliseconds (must be monotonic / always increasing)
u32 ecod_platform_get_tick_ms(void);

// Blocking delay for the given number of milliseconds
void ecod_platform_delay(u32 delay_ms);

// printf-style log output, filtered by level and tagged with module name
void ecod_log(EC_LOG_LEVEL level, const char* module, const char* format, ...);

// Set the maximum log level that will be output
void ecod_set_log_level(EC_LOG_LEVEL max_level);

// Log a data buffer as hex (useful for protocol debugging)
void ecod_log_buf(EC_LOG_LEVEL level, const char* module, const char* msg,
                  u8* data, u32 data_len);

void* ecod_malloc(u32 size);
void  ecod_free(void* ptr);

EC_SDK_STATUS ecod_mutex_init(ecod_mutex_t* out_mutex);
void          ecod_mutex_lock(ecod_mutex_t* p_mutex);
void          ecod_mutex_unlock(ecod_mutex_t* p_mutex);

EC_SDK_STATUS ecod_event_init(ecod_event_t* out_event);
EC_SDK_STATUS ecod_event_clear(ecod_event_t* p_event);
EC_SDK_STATUS ecod_event_wait(ecod_event_t* p_event, u32 timeout_ms);  // 0xFFFFFFFF = infinite
EC_SDK_STATUS ecod_event_signal(ecod_event_t* p_event);

// Open and configure the serial port (UART or HID). Called once.
bool ecod_serial_init(void);

// Synchronous send. Returns number of bytes actually sent.
u32 ecod_serial_send(u8* data, u32 length);

// Receive up to max_length bytes, waiting up to timeout_ms. Returns bytes received.
u32 ecod_serial_receive(u8* data, u32 max_length, u32 timeout_ms);

EC_SDK_STATUS ecod_network_init(void);
void          ecod_network_cleanup(void);
bool          ecod_network_is_ready(void);

EC_SDK_STATUS ecod_socket_connect(char* host, u16 port, u16 timeout_sec,
                                   ecod_socket_t* out_socket);
EC_SDK_STATUS ecod_socket_close(ecod_socket_t socket);
EC_SDK_STATUS ecod_socket_send(ecod_socket_t socket, u8* data, u32 data_len,
                                bool last_part, u32* out_sent_data_len);
EC_SDK_STATUS ecod_socket_recv(ecod_socket_t socket, u8* out_data, u32 max_size,
                                u32* out_received_size);

# In ecod_sdk/Makefile.am
if TARGET_MY_PLATFORM
libecodsdk_a_SOURCES += platform/my_platform/ecod_platform_my_platform.c
endif

./demo/ecodSdkDemo