redundancy_multi_site.c File Reference

Multi-Site Redundancy Implementation. More...

#include <stdio.h>
#include <string.h>
#include <stdint.h>
#include <time.h>
#include "redundancy_multi_site.h"

Include dependency graph for redundancy_multi_site.c:

Go to the source code of this file.

Functions
static uint32_t	crc32 (const uint8_t *data, uint32_t len)
static train_command_t	safe_command (uint32_t train_id)
static int	site_vote (site_context_t *site, const train_command_t *cmd_a, const train_command_t *cmd_b)
int	multi_site_voter_init (multi_site_voter_t *voter, const multi_site_config_t *config)
	Initialize multi-site voter with West online, East standby.
int	multi_site_vote_cycle (multi_site_voter_t *voter, site_id_t site, const train_command_t *cmd_a, const train_command_t *cmd_b)
	Process voting cycle on one site.
site_id_t	multi_site_heartbeat (multi_site_voter_t *voter)
	Check heartbeat between sites and trigger failover if needed.
int	multi_site_failover_request (multi_site_voter_t *voter, site_id_t new_active)
	Trigger manual failover (for maintenance).
int	multi_site_get_active_command (multi_site_voter_t *voter, train_command_t *cmd_out)
	Get voted command from currently active site.
int	multi_site_get_service_output (multi_site_voter_t *voter, char *output_buf, uint32_t buf_size)
	Get service output from active site (for printf, logging).
void	multi_site_print_stats (const multi_site_voter_t *voter)
	Print multi-site statistics for diagnostics.
int	multi_site_voter_shutdown (multi_site_voter_t *voter)
	Shutdown multi-site voter.

Detailed Description

Multi-Site Redundancy Implementation.

Implements 2oo2 voting across two geographic sites with active/standby failover. Each site has independent vital channels (A, B) + service channel (C).

Safety Model:

• ONLINE site: Performs 2oo2 voting, produces commands
• STANDBY site: Mirrors voting (for sync), ready to take over
• On ONLINE failure: STANDBY automatically becomes ONLINE

Definition in file redundancy_multi_site.c.

Function Documentation

crc32()

uint32_t crc32 ( const uint8_t * data, uint32_t len )

static

Definition at line 25 of file redundancy_multi_site.c.

safe_command()

train_command_t safe_command ( uint32_t train_id )

static

Definition at line 44 of file redundancy_multi_site.c.

site_vote()

int site_vote ( site_context_t * site, const train_command_t * cmd_a, const train_command_t * cmd_b )

static

Definition at line 63 of file redundancy_multi_site.c.

multi_site_voter_init()

int multi_site_voter_init	(	multi_site_voter_t *	voter,
		const multi_site_config_t *	config )

Initialize multi-site voter with West online, East standby.

Parameters

voter	Multi-site voter state
config	Configuration

Returns

0 if OK, -1 on error

Definition at line 138 of file redundancy_multi_site.c.

multi_site_vote_cycle()

int multi_site_vote_cycle	(	multi_site_voter_t *	voter,
		site_id_t	site,
		const train_command_t *	cmd_a,
		const train_command_t *	cmd_b )

Process voting cycle on one site.

Each site independently:

1. Receives/computes commands from channels A, B
2. Votes (2oo2 comparison)
3. Outputs result via service channel C

Parameters

voter	Multi-site state
site	Which site (WEST or EAST)
cmd_a	Channel A command
cmd_b	Channel B command

Returns

0 if voting OK, -1 on fatal error

Definition at line 173 of file redundancy_multi_site.c.

multi_site_heartbeat()

site_id_t multi_site_heartbeat

(

multi_site_voter_t *

voter

)

Check heartbeat between sites and trigger failover if needed.

Called periodically to:

• Check if standby site is still responsive
• Detect if active site has failed
• Transition standby to ONLINE if active is down

Parameters

voter

Multi-site state

Returns

SITE_WEST or SITE_EAST (current active site)

Definition at line 195 of file redundancy_multi_site.c.

multi_site_failover_request()

int multi_site_failover_request	(	multi_site_voter_t *	voter,
		site_id_t	new_active )

Trigger manual failover (for maintenance).

Parameters

voter	Multi-site state
new_active	New active site

Returns

0 if OK

Allows graceful switchover without waiting for timeout. Example: "Switch to East for maintenance on West"

Definition at line 254 of file redundancy_multi_site.c.

multi_site_get_active_command()

int multi_site_get_active_command	(	multi_site_voter_t *	voter,
		train_command_t *	cmd_out )

Get voted command from currently active site.

Parameters

voter	Multi-site state
cmd_out	Receives voted command

Returns

0 if OK

Definition at line 285 of file redundancy_multi_site.c.

multi_site_get_service_output()

int multi_site_get_service_output	(	multi_site_voter_t *	voter,
		char *	output_buf,
		uint32_t	buf_size )

Get service output from active site (for printf, logging).

Parameters

voter	Multi-site state
output_buf	Buffer to receive output
buf_size	Size of buffer

Returns

Number of bytes written

Definition at line 303 of file redundancy_multi_site.c.

multi_site_print_stats()

void multi_site_print_stats

(

const multi_site_voter_t *

voter

)

Print multi-site statistics for diagnostics.

Parameters

voter

Multi-site state

Definition at line 324 of file redundancy_multi_site.c.

multi_site_voter_shutdown()

int multi_site_voter_shutdown

(

multi_site_voter_t *

voter

)

Shutdown multi-site voter.

Parameters

voter

Multi-site state

Returns

0 if OK

Definition at line 364 of file redundancy_multi_site.c.