From 91c4683826d7e43e5131f29d635d7eabb3aab670 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Max=20Br=C3=BCggemann?= <mail@maxbrueggemann.de>
Date: Wed, 18 Oct 2017 00:35:03 +0200
Subject: [PATCH] Changed comments.

---
 yaMBSiavr.c | 29 ++++++++++++++++++++++++++---
 yaMBSiavr.h | 16 +++++++++++++++-
 2 files changed, 41 insertions(+), 4 deletions(-)

diff --git a/yaMBSiavr.c b/yaMBSiavr.c
index 9422034..b341fb8 100644
--- a/yaMBSiavr.c
+++ b/yaMBSiavr.c
@@ -12,7 +12,7 @@ License:  BSD-3-Clause
                     
 LICENSE:
 
-Copyright 2017 Max Brueggemann
+Copyright 2017 Max Brueggemann, www.maxbrueggemann.de
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:
@@ -214,8 +214,8 @@ ISR(UART_TRANSMIT_COMPLETE_INTERRUPT)
 
 void modbusInit(void)
 {
-	UBRRH = (unsigned char)(UBRR>>8);
-	UBRRL = (unsigned char)UBRR;
+	UBRRH = (unsigned char)((UBRR) >> 8);
+	UBRRL = (unsigned char) UBRR;
 	UART_STATUS = (1<<U2X); //double speed mode.
 #ifdef URSEL   // if UBRRH and UCSRC share the same I/O location , e.g. ATmega8
 	UCSRC = (1<<URSEL)|(3<<UCSZ0); //Frame Size
@@ -404,3 +404,26 @@ uint8_t modbusExchangeBits(volatile uint8_t *ptrToInArray, uint16_t startAddress
 		return 0;
 	}
 }
+
+/* @brief: Handles function code "report slave id".
+*
+*		  Arguments: - in: MUST BE NULL-TERMINATED and shorter than MaxFrameIndex-4
+*						   (without NULL-Byte, the NULL-Byte is not transmitted).
+*						   Pointer to the user's data array containing user specific
+*					       information, typically a string (hence the null termination).
+*						   The last byte should (according to spec) contain the 'run indication"
+*						   (running: 0xFF, not running: 0x00). This seems to be originating
+*						   from PLC terminology and is often omitted nowadays.
+*
+*  @example: char myDeviceDescription[] = {"modbus capable device that is always running V1.0\0xFF\0x00"}
+*			 modbusSendSlaveID(myDeviceDescription);
+*/
+void modbusSendSlaveID(char *in) {
+	uint8_t c = 0;
+	for (;(c<(MaxFrameIndex-2)) && in[c]!=0;c++)
+	{
+		rxbuffer[c+3]=in[c];
+	}
+	rxbuffer[2]=c+1; //byte count
+	modbusSendMessage(c+2);
+}
\ No newline at end of file
diff --git a/yaMBSiavr.h b/yaMBSiavr.h
index 9c92321..ec57a00 100644
--- a/yaMBSiavr.h
+++ b/yaMBSiavr.h
@@ -9,7 +9,7 @@ License:  BSD-3-Clause
 
 LICENSE:
 
-Copyright 2017 Max Brueggemann
+Copyright 2017 Max Brueggemann, www.maxbrueggemann.de
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:
@@ -332,3 +332,17 @@ extern uint8_t modbusExchangeBits(volatile uint8_t *ptrToInArray, uint16_t start
 */
 extern uint8_t modbusExchangeRegisters(volatile uint16_t *ptrToInArray, uint16_t startAddress, uint16_t size);
 
+/* @brief: Handles function code "report slave id".
+*
+*		  Arguments: - in: MUST BE NULL-TERMINATED and shorter than MaxFrameIndex-4
+*						   (without NULL-Byte, the NULL-Byte is not transmitted).
+*						   Pointer to the user's data array containing user specific
+*					       information, typically a string (hence the null termination).
+*						   The last byte should (according to spec) contain the 'run indication"
+*						   (running: 0xFF, not running: 0x00). This seems to be originating
+*						   from PLC terminology and is often omitted nowadays.
+*
+*  @example: char myDeviceDescription[] = {"modbus capable device that is always running V1.0\0xFF\0x00"}
+*			 modbusSendSlaveID(myDeviceDescription);
+*/
+extern void modbusSendSlaveID(char *in);
\ No newline at end of file