src/lss.c
author oremeq
Sat, 20 May 2006 00:16:29 +0200
changeset 21 8737e6224393
parent 0 4472ee7c6c3e
child 89 11dda1450e09
permissions -rw-r--r--
Some documentation correction
/*
This file is part of CanFestival, a library implementing CanOpen Stack.

 Author: CANopen Canada (canfestival@canopencanada.ca)

See COPYING file for copyrights details.

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

#include <applicfg.h>
#include <def.h>

#include <can.h>
#include <data.h>
#include <objdictdef.h>
#include <objacces.h>
#include "can_driver.h"

#ifdef LED_ENABLE
#include "led.h"
#else
#define led_set_state(a,b)
#endif

#include "lss.h"



/*
	NOTES

	1. since in the LSS protocol all LSS Slave use the same COB, only 1 Slave
	must be allowed to communicate with the Master

	2. the Master always take the iniative. the Slave is only allowed to transmit
	within a confirmed service

	3. requesting message (from the Master) using COB-ID 2021 and response messages
	(from the Slave) using COB-ID 2020
*/

/*
	0 = this slave is not talking to the master
	1 = this slave is talking to the master (this slave has been selected via )
*/
int	slave_selector;

int	current_mode;

int	lss_table_selector, lss_table_index;


/* slave storing the information sent by the master */
UNS32 lss_buffer[10];
/*
	how this buffer is used

	for a SLAVE 
	[0..3]  used to store the LSS Address
	[4..9]  use by LSS Identify Remort Slave

	for the MASTER
	[0..3] hold the answer from the slave regarding its ID
*/


void lss_copy(UNS8 *data, UNS32 value)
/* transfert 32 bits value into uns8 data vector */
{
	data[0] = value & 0xff;
	data[1] = (value>>8) & 0xff;
	data[2] = (value>>16) & 0xff;
	data[3] = (value>>24) & 0xff;
}


UNS32 lss_get_value(UNS8 *data)
/* build a 'UNS32' value from a 'unsigned char' vector */
{
	return data[0] + (data[1]<<8) + (data[2]<<16) + (data[3]<<24);
}


void lss_init_msg(Message *msg)
{
	msg->cob_id.w = 0;
	msg->rtr = 0;
	msg->len = 0;
	msg->data[0] = 0;
	msg->data[1] = 0;
	msg->data[2] = 0;
	msg->data[3] = 0;
	msg->data[4] = 0;
	msg->data[5] = 0;
	msg->data[6] = 0;
	msg->data[7] = 0;
}


void lss_SwitchModeGlobal(CO_Data *d, UNS32 mode)
/*
	this service is used to switch all LSS slaves in the network between operation
	mode and configuration mode.
*/
{	
	Message msg;
	lss_init_msg(&msg);

	/* 
		sending a COB-ID 2021
		[0] = 4 (for switch mode global)
		[1] = 0 for operation mode, = 1 for configuration mode
		[2..7] = 0 reserved
	*/
	
	if (!(d->iam_a_slave))
	{
		msg.cob_id.w = 0x07E5 /* 2021 */;

		msg.len = 2;
		msg.data[0] = 4;
		msg.data[1] = (UNS8)mode;
	
		/* transmit */
		(*d->canSend)(&msg);
	}
	else
	{
		/* set mode global */
		current_mode = mode;
	}
}


void lss_SwitchModeSelective_master(CO_Data *d, UNS32 *LSSaddr)
/*
	LSS address : <vendor-id> <product-code> <revision-number> <serial-number>
	vendor-id : provided by CiA
	identical to the CANopen identity object

	select the slave corresponding to this ADDRESS
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (d->iam_a_slave) /* not the master */
		return; 

	msg.cob_id.w = 0x07E5 /* 2021 */;
	msg.len=5;

	msg.data[0] = 64;
	lss_copy(msg.data+1, LSSaddr[0]); 
	/* transmit */
	(*d->canSend)(&msg);

	msg.data[0] = 65;
	lss_copy(msg.data+1, LSSaddr[1]); 
	/* transmit */
	(*d->canSend)(&msg);

	msg.data[0] = 66;
	lss_copy(msg.data+1, LSSaddr[2]); 
	/* transmit */
	(*d->canSend)(&msg);

	msg.data[0] = 67;
	lss_copy(msg.data+1, LSSaddr[3]); 
	/* transmit */
	(*d->canSend)(&msg);
}


UNS32 lss_validate_address(CO_Data* d)
{
#if 0 
	extern s_identity obj1018;

	/* maybe we should go throught getODentry but those
	data are 1) RO and 2) the proper ID of this device */
#else
	UNS32  r, vendor_id, product_code, revision_number, serial_number;
	UNS8   sz = sizeof(UNS32), dt = int32;

	r = getODentry(d, 0x1018, 1, (void *)&vendor_id, &sz, &dt, 0);
	r = getODentry(d, 0x1018, 2, (void *)&product_code, &sz, &dt, 0);
	r = getODentry(d, 0x1018, 3, (void *)&revision_number, &sz, &dt, 0);
	r = getODentry(d, 0x1018, 4, (void *)&serial_number, &sz, &dt, 0);

#endif
	/*
		if
		lss_buffer[0] == vendor-id
		lss_buffer[1] == product code
		lss_buffer[2] == revision
		lss_buffer[3] == serial

		then return 1
		else return 0;
	*/

	if (lss_buffer[0] == vendor_id  &&
	    lss_buffer[1] == product_code &&
	    lss_buffer[2] == revision_number &&
	    lss_buffer[3] == serial_number)
	{
		return 1;
	}

	return 0;
}


void lss_SwitchModeSelective_slave(CO_Data *d)
/* 
	SwitchModeSelective for the SLAVE
	received the frames from the master and start building 
	the lss address 
*/
{
	Message msg;
	lss_init_msg(&msg);

	/*
		the master broadcast the address of a particular slave
		for 64,65 and 66 store the partial address
		when 67 arrive process the call and asknowledge if necessary
	*/

	if (lss_validate_address(d))
	{
		/* slave should transmit cob_id 2020  */
		msg.cob_id.w = 0x07E4 /* 2020 */;

		msg.len = 2;
		msg.data[0] = 68;
		msg.data[1] = (UNS8)current_mode;

		/* transmit */
		(*d->canSend)(&msg);
	}

	/* reset the address */
	lss_buffer[0] = 0;
	lss_buffer[1] = 0;
	lss_buffer[2] = 0;
	lss_buffer[3] = 0;
}


void lss_ConfigureNode_ID(CO_Data *d, UNS32 node_id)
/*
	through this service the LSS Master configures the NMT-address
	parameter of a LSS slave.
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (!(d->iam_a_slave))
	{
		msg.cob_id.w = 0x07E5 /* 2021 */;

		msg.len = 2;
		msg.data[0] = 17;
		msg.data[1] = (UNS8)node_id;

		/* transmit */
		(*d->canSend)(&msg);
	}
	else
	{
		/*
			receiving NODE ID from the master
		*/

		/*
			error code 
			0 = success
			1 = node id out of range
			2..254 = reserved
			255 = implementation specific error occured
				spec error = mode detailed error
		*/
		msg.cob_id.w = 0x07E4 /* 2020 */;

		msg.len = 3;
		msg.data[0] = 17;
		/* msg.data[1] = error code */
		/* msg.data[2] = spec error */

		/* transmit */
		(*d->canSend)(&msg);
	}
}


void lss_ConfigureBitTimingParameters(CO_Data *d, 
                                      UNS32 table_selector,
                                      UNS32 table_index)
/*
	this service allows all LSS slaves in configuration mode.
	must be followed by an Activate Bit Timing Parameters
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (!(d->iam_a_slave))
	{
		msg.cob_id.w = 0x07E5 /* 2021 */;

		msg.len = 3;
		msg.data[0] = 19;
		msg.data[1] = (UNS8)table_selector;
		msg.data[2] = (UNS8)table_index;

		/* transmit */
		(*d->canSend)(&msg);
	}
	else
	{
		UNS8 error_code;

		/* validate if this baudrate is possible */
		if (table_selector == 0  &&  baudrate_valid(table_index) == 1)
		{
			lss_table_selector = table_selector;
			lss_table_index = table_index;
		}
		else
			error_code = 1; /* bit timing not supported */

		msg.cob_id.w = 0x07E4 /* 2020 */;

		msg.len = 3;
		msg.data[0] = 19;
		msg.data[1] = error_code;
		msg.data[2] = 0;

		/* transmit */
		(*d->canSend)(&msg);
	}

	led_set_state(d, LED_AUTOBITRATE);
}


void lss_ActivateBitTimingParameters_master(CO_Data *d, unsigned short switch_delay)
/*
	switch_delay in ms

	switch_delay has to be longer than the longest timeof any node
	in the network to avoid that a node already switches while another
	stills transmist the old bit timing parameters
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (d->iam_a_slave)
		return;
	
	msg.cob_id.w = 0x07E5 /* 2021 */;

	msg.len = 3;
	msg.data[0] = 21;
	msg.data[1] = (UNS8)(switch_delay &  0xff);
	msg.data[2] = (UNS8)((switch_delay >> 8) & 0xff);

#ifdef LED_ENABLE
	led_set_state(LED_AUTOBITRATE);		
#endif
	/* transmit */
	(*d->canSend)(&msg);
}


void lss_ActivateBitTimingParameters_slave(UNS8 byte_low, UNS8 byte_high)
{
	/* rebuild the delay value (short) from the 2 (UNS8) data */
	unsigned short switch_delay = byte_low + (((UNS16)byte_high)<<8);

	/* set the baudrate to the value proposed by the master */
	if (lss_table_selector == 0)
		baudrate_set(lss_table_index);

	/* wait for switch_delay ms before continuing */
}


void lss_StoreConfiguredParameters(CO_Data *d)
/*
	store configured parameters into non-volatile storage
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (!(d->iam_a_slave))
	{
		msg.cob_id.w = 0x07E5 /* 2021 */;

		msg.len = 1;
		msg.data[0] = 23;

		/* transmit */
		(*d->canSend)(&msg);
	}
	else
	{
		msg.cob_id.w = 0x07E4 /* 2020 */;

		msg.data[0] = 23;
		/* msg.data[1] = error code; */
		/* msg.data[2] = spec err */
		
		/* transmit */
		(*d->canSend)(&msg);
	}
}


void lss_InquireLSSAddress_master(CO_Data *d, int flag)
/*
	this service allows to determine the LSS-address parameters of a LSS-slave in
	configuration mode

	request 1 single item of the LSS address
	0 = request vendor-id
	1 = request product-id
	2 = request revision
	3 = request serial
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (!(d->iam_a_slave))
	{
		msg.cob_id.w = 0x07E5 /* 2021 */;

		msg.len = 1;
		msg.data[0] = 90 + flag;
	
		/* transmit */
		(*d->canSend)(&msg);
	}
}


int lss_InquireLSSAddress_slave(CO_Data *d, int cs)
{
	Message msg;
	lss_init_msg(&msg);

	if (!(d->iam_a_slave)) /* not a slave */
		return -1;

	UNS32 value = 0;

	switch(cs)
	{
		case 90:
			value = 0; /* = vendor id */
			break;
		case 91:
			value = 0; /* = product code */
			break;
		case 92:
			value = 0; /* = revision */
			break;
		case 93:
			value = 0; /* = serial */
			break;
	}

	if (value > 0)
	{
		msg.cob_id.w = 0x07E4 /* 2020 */;
	
		msg.len=5;
		msg.data[0] = cs;
		lss_copy(msg.data+1, value);
		
		/* transmit */
		(*d->canSend)(&msg);

		return 0;
	}

	return -1;
}


void lss_IdentifyRemoteSlaves(CO_Data *d, 
                              UNS32 vendor_id,
                              UNS32 product_code,
                              UNS32 rev_low,
                              UNS32 rev_high,
                              UNS32 serial_low,
                              UNS32 serial_high)
/*
	throught this service, the LSS Master requests all LSS slave whose LSS address
	meets the LSSaddr_sel to idenfity themselves through LSS Identify Slave
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (!(d->iam_a_slave))
	{
		/*
			request answers from all slaves corresponding
			to the revision and serial range of values
		*/

		msg.cob_id.w = 0x07E5 /* 2021 */;
		msg.len=5;

		msg.data[0] = 70;
		lss_copy(msg.data+1, vendor_id);
		/* transmit */
		(*d->canSend)(&msg);

		msg.data[0] = 71;
		lss_copy(msg.data+1, product_code); 
		/* transmit */
		(*d->canSend)(&msg);
	
		msg.data[0] = 72; /* revision number low */
		lss_copy(msg.data+1, rev_low);
		/* transmit */
		(*d->canSend)(&msg);

		msg.data[0] = 73; /* revision number high */
		lss_copy(msg.data+1, rev_high);
		/* transmit */
		(*d->canSend)(&msg);
	
		msg.data[0] = 74; /* serial number low */
		lss_copy(msg.data+1, serial_low);
		/* transmit */
		(*d->canSend)(&msg);

		msg.data[0] = 75; /* serial number high */
		lss_copy(msg.data+1, serial_high);
		/* transmit */
		(*d->canSend)(&msg);
	}
}


int lss_validate_range_addr(CO_Data *d)
{
	/*
		if 

		lss_buffer[4] == vendor_id
		lss_buffer[5] == product code
		lss_buffer[6] <= revision <= lss_buffer[7]
		lss_buffer[8] <= serial <= lss_buffer[9]

		then return 1
		else return 0
	*/

	UNS32  r, vendor_id, product_code, revision_number, serial_number;
	UNS8   sz = sizeof(UNS32), dt = int32;

	r = getODentry(d, 0x1018, 1, (void *)&vendor_id, &sz, &dt, 0);
	r = getODentry(d, 0x1018, 2, (void *)&product_code, &sz, &dt, 0);
	r = getODentry(d, 0x1018, 3, (void *)&revision_number, &sz, &dt, 0);
	r = getODentry(d, 0x1018, 4, (void *)&serial_number, &sz, &dt, 0);

	if (lss_buffer[4] == vendor_id  &&
	    lss_buffer[5] == product_code &&
	    lss_buffer[6] <= revision_number &&
	    revision_number <= lss_buffer[7] &&
	    lss_buffer[8] <= serial_number &&
	    serial_number <= lss_buffer[9])
	{
		return 1;
	}

	return 0;
}


void lss_IdentifySlave(CO_Data *d)
/*
	through this service, an LSS slave indicates that it is a slave
	with LSS address within the LSSaddr_sel
*/
{
	Message msg;
	lss_init_msg(&msg);

	if (lss_validate_range_addr(d))
	{
		msg.cob_id.w = 0x07E4 /* 2020 */;

		msg.len = 1;
		msg.data[0] = 79;

		/* transmit */
		(*d->canSend)(&msg);
	}

	/* reset */
	lss_buffer[4] = 0;
	lss_buffer[5] = 0;
	lss_buffer[6] = 0;
	lss_buffer[7] = 0;
	lss_buffer[8] = 0;
	lss_buffer[9] = 0;
}


int lss_process_msg(CO_Data *d, Message *msg)
{
	/* process the incoming message */
	if (msg->cob_id.w == 0x07E4 /* 2020 */)
	{
		// should be the master
		// a slave just answered
		switch(msg->data[0])
		{
			/* slave acknowledging the SwitchModeSelective call */
			case 68: 
				/* msg->data[1] contains the 'mode global' value from the slave*/
				break;

			/* a slave had acknowledged the call from LSS Identify Remote Slave */
			case 79:
				break;

			/* the slave acknowledged and sent the requested data */
			case 90:
				lss_buffer[0] = lss_get_value(msg->data+1);
				/* action ? */
				break;
			case 91:
				lss_buffer[1] = lss_get_value(msg->data+1);
				/* action ? */
				break;
			case 92:
				lss_buffer[2] = lss_get_value(msg->data+1);
				/* action ? */
				break;
			case 93:
				lss_buffer[3] = lss_get_value(msg->data+1);
				/* action ? */
				break;
		}
	}

	else if (msg->cob_id.w == 0x07E5 /* 2021 */)
	{
		// should be a slave
		// the master sent a request
		switch(msg->data[0])
		{
			case 4:
				lss_SwitchModeGlobal(d, msg->data[1]);
				break;

			case 17:
				lss_ConfigureNode_ID(d, msg->data[1]);
				break;

			case 19:
				lss_ConfigureBitTimingParameters(d, msg->data[1], msg->data[2]);
				break;
			case 21:
				lss_ActivateBitTimingParameters_slave(msg->data[1], msg->data[2]);
				break;

			/* Switch Mode Selective */
			case 64:
				lss_buffer[0] = lss_get_value(msg->data+1);
				break;
			case 65:
				lss_buffer[1] = lss_get_value(msg->data+1);
				break;
			case 66:
				lss_buffer[2] = lss_get_value(msg->data+1);
				break;
			case 67:
				lss_buffer[3] = lss_get_value(msg->data+1);
				lss_SwitchModeSelective_slave(d);
				break;

			/* Identify Remote Slave */
			case 70:
				lss_buffer[4] = lss_get_value(msg->data+1);
				break;
			case 71:
				lss_buffer[5] = lss_get_value(msg->data+1);
				break;
			case 72:
				lss_buffer[6] = lss_get_value(msg->data+1);
				break;
			case 73:
				lss_buffer[7] = lss_get_value(msg->data+1);
				break;
			case 74:
				lss_buffer[8] = lss_get_value(msg->data+1);
				break;
			case 75:
				lss_buffer[9] = lss_get_value(msg->data+1);
				lss_IdentifySlave(d);
				break;

			/* Inquire Identify of Slave */
			case 90:
			case 91:
			case 92:
			case 93:
				lss_InquireLSSAddress_slave(d, msg->data[0]);
				break;
		}
	}

	return 0;
}