1

/* File generated by Beremiz (PlugGenerate_C method of modbus Plugin instance) */

     2

     3

/*

     4

 * Copyright (c) 2016 Mario de Sousa (msousa@fe.up.pt)

     5

 *

     6

 * This file is part of the Modbus library for Beremiz and matiec.

     7

 *

     8

 * This Modbus library is free software: you can redistribute it and/or modify

     9

 * it under the terms of the GNU Lesser General Public License as published by

    10

 * the Free Software Foundation, either version 2 of the License, or

    11

 * (at your option) any later version.

    12

 *

    13

 * This program is distributed in the hope that it will be useful, but

    14

 * WITHOUT ANY WARRANTY; without even the implied warranty of

    15

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser 

    16

 * General Public License for more details.

    17

 *

    18

 * You should have received a copy of the GNU Lesser General Public License

    19

 * along with this Modbus library.  If not, see <http://www.gnu.org/licenses/>.

    20

 *

    21

 * This code is made available on the understanding that it will not be

    22

 * used in safety-critical situations without a full and competent review.

    23

 */

    24

    25

#include "mb_addr.h"

    26

#include "mb_tcp_private.h"

    27

#include "mb_master_private.h"

    28

    29

    30

    31

#define DEF_REQ_SEND_RETRIES 0

    32

    33

    34

#define MODBUS_PARAM_STRING_SIZE 64

    35

    36

    37

  // Used by the Modbus server node

    38

#define MEM_AREA_SIZE 65536

    39

typedef struct{

    40

	    u16		ro_bits [MEM_AREA_SIZE];

    41

	    u16		rw_bits [MEM_AREA_SIZE];

    42

	    u16		ro_words[MEM_AREA_SIZE];

    43

	    u16		rw_words[MEM_AREA_SIZE];

    44

	} server_mem_t;

    45

    46

    47

/*

    48

 * Beremiz has a program to run on the PLC (Beremiz_service.py)

    49

 * to handle downloading of compiled programs, start/stop of PLC, etc.

    50

 * (see runtime/PLCObject.py for start/stop, loading, ...)

    51

 * 

    52

 * This service also includes a web server to access PLC state (start/stop)

    53

 * and to change some basic confiuration parameters.

    54

 * (see runtime/NevowServer.py for the web server)

    55

 * 

    56

 * The web server allows for extensions, where additional configuration

    57

 * parameters may be changed on the running/downloaded PLC.

    58

 * Modbus plugin also comes with an extension to the web server, through

    59

 * which the basic Modbus plugin configuration parameters may be changed

    60

 *

    61

 * This means that most values in the server_node_t and client_node_t

    62

 * may be changed after the co,piled code (.so file) is loaded into 

    63

 * memory, and before the code starts executing.

    64

 * Since the we will also want to change the host and port (TCP) and the

    65

 * serial device (RTU) at this time, it is best if we allocate memory for

    66

 * these strings that may be overwritten by the web server (i.e., do not use

    67

 * const strings) in the server_node_t and client_node_t structures.

    68

 *

    69

 * The following structure members

    70

 *    - node_addr_t.addr.tcp.host

    71

 *    - node_addr_t.addr.tcp.service  (i.e. the port)

    72

 *    - node_addr_t.addr.rtu.device

    73

 * are all char *, and do not allocate memory for the strings.

    74

 * 

    75

 * We therefore include two generic char arrays, str1 and str2,

    76

 * that will store the above strings, and the C code will initiliaze

    77

 * the node_addre_t.addr string pointers to these strings.

    78

 * i.e., either addr.rtu.device will point to str1,

    79

 *          or

    80

 *        addr.tcp.host and addr.tcp.service 

    81

 *        will point to str1 and str2 respectively

    82

 */

    83

typedef struct{

    84

	    const char *location;

    85

        const char *config_name;

    86

              char  str1[MODBUS_PARAM_STRING_SIZE];

    87

              char  str2[MODBUS_PARAM_STRING_SIZE]; 

    88

	    u8		slave_id;

    89

	    node_addr_t	node_address;

    90

	    int		mb_nd;      // modbus library node used for this server 

    91

	    int		init_state; // store how far along the server's initialization has progressed

    92

	    pthread_t	thread_id;  // thread handling this server

    93

	    server_mem_t	mem_area;

    94

	} server_node_t;

    95

    96

    97

  // Used by the Modbus client node

    98

typedef struct{

    99

	    const char *location;

   100

        const char *config_name;

   101

              char  str1[MODBUS_PARAM_STRING_SIZE];

   102

              char  str2[MODBUS_PARAM_STRING_SIZE]; 

   103

	    node_addr_t	node_address;

   104

	    int		mb_nd;      // modbus library node used for this client

   105

	    int		init_state; // store how far along the client's initialization has progressed

   106

	    u64		comm_period;// period to use when periodically sending requests to remote server

   107

	    int		prev_error; // error code of the last printed error message (0 when no error) 

   108

	    pthread_t   thread_id;  // thread handling all communication for this client node

   109

	    pthread_t	timer_thread_id;  // thread handling periodical timer for this client node

   110

	    pthread_mutex_t mutex;  // mutex to be used with the following condition variable

   111

        pthread_cond_t  condv;  // used to signal the client thread when to start new modbus transactions

   112

        int       execute_req;  /* used, in association with condition variable,  

   113

                                 *   to signal when to send the modbus request to the server

   114

                                 * Note that we cannot simply rely on the condition variable to signal

   115

                                 *   when to activate the client thread, as the call to 

   116

                                 *   pthread_cond_wait() may return without having been signaled!

   117

                                 *   From the manual:

   118

                                 *      Spurious  wakeups  from  the

   119

                                 *      pthread_cond_timedwait() or pthread_cond_wait()  functions  may  occur.

   120

                                 *      Since  the  return from pthread_cond_timedwait() or pthread_cond_wait()

   121

                                 *      does not imply anything about the value of this predicate,  the  predi-

   122

                                 *      cate should be re-evaluated upon such return.

   123

                                 */

   124

        int      periodic_act;  /* (boolen) flag will be set when the client node's thread was activated 

   125

                                 * (by signaling the above condition variable) by the periodic timer.

   126

                                 * Note that this same thread may also be activated (condition variable is signaled)

   127

                                 * by other sources, such as when the user program requests that a specific 

   128

                                 * client MB transation be executed (flag_exec_req in client_request_t)

   129

                                 */

   130

	} client_node_t;

   131

   132

   133

  // Used by the Modbus client plugin

   134

typedef enum {

   135

	    req_input,

   136

	    req_output,

   137

	    no_request		/* just for tests to quickly disable a request */

   138

	} iotype_t;

   139

   140

#define REQ_BUF_SIZE 2000

   141

typedef struct{

   142

	    const char *location;

   143

	    int		client_node_id;

   144

	    u8		slave_id;

   145

	    iotype_t	req_type;

   146

	    u8		mb_function;

   147

	    u16		address;

   148

	    u16		count;

   149

	    int		retries;

   150

	    u8		mb_error_code; // modbus      error code (if any) of last executed request

   151

	    u8		tn_error_code; // transaction error code (if any) of last executed request

   152

	    int		prev_error; // error code of the last printed error message (0 when no error) 

   153

	    struct timespec resp_timeout;

   154

	    u8		write_on_change; // boolean flag. If true => execute MB request when data to send changes

   155

	      // buffer used to store located PLC variables

   156

	    u16		plcv_buffer[REQ_BUF_SIZE];

   157

	      // buffer used to store data coming from / going to server

   158

	    u16		coms_buffer[REQ_BUF_SIZE]; 

   159

	    pthread_mutex_t coms_buf_mutex; // mutex to access coms_buffer[]

   160

          /* boolean flag that will be mapped onto a (BOOL) located variable 

   161

           * (u8 because IEC 61131-3 BOOL are mapped onto u8 in C code! )

   162

           *    -> allow PLC program to request when to start the MB transaction

   163

           *    -> will be reset once the MB transaction has completed

   164

           */

   165

        u8     flag_exec_req;  

   166

          /* flag that works in conjunction with flag_exec_req

   167

           * (does not really need to be u8 as it is not mapped onto a located variable. )

   168

           *    -> used by internal logic to indicate that the client thread 

   169

           *       that will be executing the MB transaction

   170

           *       requested by flag exec_req has already been activated.

   171

           *    -> will be reset once the MB transaction has completed

   172

           */

   173

        u8     flag_exec_started;  

   174

          /* flag that will be mapped onto a (BYTE) located variable 

   175

           * (u8 because the flag is a BYTE! )

   176

           *    -> will store the result of the last executed MB transaction

   177

           *         1 -> error accessing IP network, or serial interface

   178

           *         2 -> reply received from server was an invalid frame

   179

           *         3 -> server did not reply before timeout expired

   180

           *         4 -> server returned a valid Modbus error frame

   181

           *    -> will be reset (set to 0) once this MB transaction has completed sucesfully

   182

           * 

   183

           * In other words, this variable is a copy of tn_error_code, reset after each request attempt completes.

   184

           * We map this copy (instead of tn_error_code) onto a located variable in case the user program decides

   185

           * to overwrite its value and mess up the plugin logic.

   186

           */

   187

        u8      flag_tn_error_code;  

   188

          /* flag that will be mapped onto a (BYTE) located variable 

   189

           * (u8 because the flag is a BYTE! )

   190

           *    -> if flag_tn_error_code is 4, this flag will store the MB error code returned by the MB server in a MB error frame

   191

           *    -> will be reset (set to 0) once this MB transaction has completed succesfully

   192

           * 

   193

           * In other words, this variable is a copy of mb_error_code, reset after each request attempt completes.

   194

           * We map this copy (instead of mb_error_code) onto a located variable in case the user program decides

   195

           * to overwrite its value and mess up the plugin logic.

   196

           */

   197

        u8      flag_mb_error_code;  

   198

	} client_request_t;

   199

   200

   201

/* The total number of nodes, needed to support _all_ instances of the modbus plugin */

   202

#define TOTAL_TCPNODE_COUNT       %(total_tcpnode_count)s

   203

#define TOTAL_RTUNODE_COUNT       %(total_rtunode_count)s

   204

#define TOTAL_ASCNODE_COUNT       %(total_ascnode_count)s

   205

   206

/* Values for instance %(locstr)s of the modbus plugin */

   207

#define MAX_NUMBER_OF_TCPCLIENTS  %(max_remote_tcpclient)s

   208

   209

#define NUMBER_OF_TCPSERVER_NODES %(tcpserver_node_count)s

   210

#define NUMBER_OF_TCPCLIENT_NODES %(tcpclient_node_count)s

   211

#define NUMBER_OF_TCPCLIENT_REQTS %(tcpclient_reqs_count)s

   212

   213

#define NUMBER_OF_RTUSERVER_NODES %(rtuserver_node_count)s

   214

#define NUMBER_OF_RTUCLIENT_NODES %(rtuclient_node_count)s

   215

#define NUMBER_OF_RTUCLIENT_REQTS %(rtuclient_reqs_count)s

   216

   217

#define NUMBER_OF_ASCIISERVER_NODES %(ascserver_node_count)s

   218

#define NUMBER_OF_ASCIICLIENT_NODES %(ascclient_node_count)s

   219

#define NUMBER_OF_ASCIICLIENT_REQTS %(ascclient_reqs_count)s

   220

   221

#define NUMBER_OF_SERVER_NODES (NUMBER_OF_TCPSERVER_NODES + \

   222

                                NUMBER_OF_RTUSERVER_NODES + \

   223

                                NUMBER_OF_ASCIISERVER_NODES)

   224

   225

#define NUMBER_OF_CLIENT_NODES (NUMBER_OF_TCPCLIENT_NODES + \

   226

                                NUMBER_OF_RTUCLIENT_NODES + \

   227

                                NUMBER_OF_ASCIICLIENT_NODES)

   228

   229

#define NUMBER_OF_CLIENT_REQTS (NUMBER_OF_TCPCLIENT_REQTS + \

   230

                                NUMBER_OF_RTUCLIENT_REQTS + \

   231

                                NUMBER_OF_ASCIICLIENT_REQTS)

   232

   233

   234

/*initialization following all parameters given by user in application*/

   235

   236

static client_node_t		client_nodes[NUMBER_OF_CLIENT_NODES] = {

   237

%(client_nodes_params)s

   238

};

   239

   240

   241

static client_request_t	client_requests[NUMBER_OF_CLIENT_REQTS] = {

   242

%(client_req_params)s

   243

};

   244

   245

   246

static server_node_t		server_nodes[NUMBER_OF_SERVER_NODES] = {

   247

%(server_nodes_params)s

   248

}

   249

;

   250

   251

/*******************/

   252

/*located variables*/

   253

/*******************/

   254

   255

%(loc_vars)s

   256