MC Technologies MC 100 SW, User Manual

Page 1: ...es GmbH Kabelkamp 2 30179 Hannover Germany Tel 49511 67 69 99 0 Fax 49511 67 69 99 150 Website Shop www mc technologies net Email info mc technologies net 1 User Manual MC100 Terminal MC100 Gateway MC100 GPIO MC100 SensT2 MC100 WMBUS Version v1 0 1 ...

Page 2: ...SPECIFICATIONS 9 6 1 TECHNICAL DATA 9 Physical properties 9 6 1 1 Technological mobile network features 9 6 1 2 7 CHECK MODEM VERSION 10 8 PORTS AND DISPLAY 11 9 INSTALLATION 13 9 1 ANTENNA 13 9 2 INSERTING THE SIM CARD 13 9 3 POWER SUPPLY 13 9 4 CONFIGURATION VIA WEB INTERFACE 13 9 5 SETTING UP THE SIM AND ESTABLISHING A CONNECTION 14 9 6 ONLINE TEST 16 9 7 INTERNET ACCESS 16 9 8 ACCESS VIA SSH 1...

Page 3: ...1 5 3 Current inputs 0 20mA 29 11 5 4 PWM 30 11 5 5 11 6 MC100 SENST2 31 Digital Inputs 31 11 6 1 Digital Outputs 32 11 6 2 Voltage inputs 0 10V 33 11 6 3 Current inputs 0 20mA 33 11 6 4 Current outputs 0 20mA 34 11 6 5 PT100 PT1000 Inputs 35 11 6 6 11 7 LEDS 36 12 OPENVPN 37 12 1 CLIENT CONFIGURATION 37 12 2 SERVER CONFIGURATION 39 13 WMBUS 41 13 1 GENERAL INFORMATION 41 13 2 INSTALLING COMMAND L...

Page 4: ...be_bus 51 read 51 write 52 reset 52 Select device 52 16 1 3 16 2 FOR V1 0 5 FUTURE RELEASE 53 Using OWFS file system 53 16 2 1 OWhttpd 53 16 2 2 17 UPDATING MC100 1 0 3RC10 TO1 0 4 54 17 1 USING COMMAND LINE 54 17 2 USING LUCI WEB INTERFACE 55 Update Feeds 55 17 2 1 Installing Certificates 55 17 2 2 Updating the system 55 17 2 3 18 FACTORY RESET 56 19 MAINTENANCE REPAIR AND TROUBLESHOOTING 57 19 1...

Page 5: ... the applicable publications and certificates must be observed and followed The basic safety instructions must be strictly maintained when operating the product In addition to the basic safety instructions the individual sections of the documentation contain descriptions of procedures and operating instructions with specific safety information Furthermore the local guidelines for the prevention of...

Page 6: ...ocks during transport and storage e g by using air cushioned packaging Before installing the product check it for possible damage that may have been caused by improper transport or storage Damage in transit must be noted on the shipping documents All claims for damages must be made immediately and before installation to the carrier company responsible for storage 2 5 Labels on the product The type...

Page 7: ...phone antennas and people can affect their health Please note that the mobile phone antenna must be at least 20 cm away from persons during operation 3 Use of open source software 3 1 General This product includes among other things so called open source software which was produced by third parties and published for free use by everyone The open source software is subject to special open source so...

Page 8: ...ase of our product is based This applies in particular to any use of the open source software programs outside of our product For the use of the open source software beyond the purpose of the contract the warranty and liability provisions provided for in the applicable open source software license for the corresponding open source software as listed below shall apply In particular we shall not be ...

Page 9: ...ately 6 1 Technical Data Physical properties 6 1 1 Physical characteristics Value Supply Voltage 8 V 30 V DC Dimensions W x H x D 120 x 75 x 35mm Operation temperature 20 C to 70 C Housing Plastic Mounting Wall mounting DIN rail adapter optional The extended temperature range allows temporary operation at increased temperatures This may result in functional restrictions especially during data tran...

Page 10: ...il info mc technologies net 10 7 Check Modem Version To check the firmware version of your MC100 1 Login to Luci web interface using your device IP address default 192 168 2 1 2 On the main page scroll down to MC info Tab 3 Under Modem Revision you can read the firmware version of your MC100 Model Chip a As of release 1 0 4 the latest firmware for the model chip is AR06A03 ...

Page 11: ...nts Port Description POW Power supply GPIO I O Interfaces RS485 Serial RS485 interface no galvanic isolation CAN CAN Port Port Description RS232 Serial RS232 Interface USB USB Port USB 2 0 Host ETH Ethernet Port RJ45 10 100 BT Port Description A1 LTE Antenna SMA socket main connection A2 LTE Diversity Antenna SMA socket MIMO GPS GPS antenna SMA socket LED Description LED 1 Green Power supply LED 2...

Page 12: ...puts 8 digital outputs solid state relay 0 10V 2 analog inputs 0 to 10V 0 20mA 2 analog inputs 0 to 20mA PWM 1 PWM Pulse With Modulation outputs Port Description Isolated RS485 1 serial RS485 interface with galvanic isolation Isolated Inputs 8 digital inputs Isolated Outputs 2 digital outputs solid state relay PT100 PT1000 4 PT100 PT1000 inputs 4 20mA Outputs 2 analog 4 20mA outputs 0 10V 2 analog...

Page 13: ...ight until it clicks into place 9 3 Power supply The MC100 is operated with a supply voltage of 10 30V DC Please connect an external DC power supply with an output voltage of 10 30V DC to the power supply socket POW e g 12V 1 2A or 24V 600mA Please connect the power supply unit to the power supply or switch on the power supply A green Power LED will light up see transparent bottom shell on the sid...

Page 14: ...nnection Click on Network in the left menu and then on Interfaces Click on the EDIT button at the MOBILE interface Setting APN 1 Change Protocol to UMTS GPRS EV DO Supports LTE connection 2 Click on SWITCH PROTOCOL 3 Change Modem device to dev ttyUSB2 4 Enter the access data APN user and password for data transmission in your mobile network 5 Enter the PIN number of your SIM card Leave the entry f...

Page 15: ...eb interface again Navigate to the menu item Network and Interfaces In the MOBILE area the transmission values in MB for RX and TX should now appear The quality of the connection can be in Luci under Status Overview MCInfo RSRP 70 dBm to 79 dBm Very good signal Telecommunication and Internet operate without any disturbance 80 dBm to 89 dBm Good solid signal Telecommunication and Internet operate w...

Page 16: ...he browser on your PC and enter a URL known to you in the address field e g www mc technologies net 9 8 Access via SSH To access the Linux system of the MC100 you must connect to the same IP address default 192 168 2 1 as the web interface The following access data are required User root Password In delivery state no password is necessary here To secure your MC100 change the password by entering p...

Page 17: ...ing address 5 If the MC100 is to go online via a router the line option gateway aaa bbb ccc ddd can be added with the IP address of the router 6 Then press Escape to save the file and then type wq and press Enter 7 Finally type service network reload and press Enter Restart the network services with the new settings After a few seconds the MC100 has the new IP address If necessary the network conn...

Page 18: ... the Node RED web interface with the same IP address as the standard web interface and the specification of the port e g 1880 Example with default address http 192 168 2 1 1880 Note Using https will not work Enable the Node Red installed in MC100 9 11 1 Click on System in the left menu and then on Startup Search for Initscript node red and Click the Enable Disable button Install extra modules 9 11...

Page 19: ...ogies net 19 Add a debug node 9 11 4 The debug node displays the payload of the message or the entire message object It can be renamed from its setting by double clicking on it Wire the nodes 9 11 5 After adding all the wanted nodes wire them together by dragging between the outputs of one to the input of the other Deploy 9 11 6 Now click on the Deploy button to deploy the flow to the server ...

Page 20: ... Add voltage input current input node 3 Add Debug node 4 Wire and Deploy Digital Inputs 10 1 2 1 Add the inject node 2 Add the digital inputs node 3 Double click on MC100 GPIO digital input node to open the settings menu and choose a Digital input 4 Add Debug node change name if wanted 5 Wire and Deploy Digital Outputs 10 1 3 1 Add the Inject node 2 Add the Digital output node 3 Double click on MC...

Page 21: ...chnologies net 21 Dashboard 10 1 4 1 Use Menu Manage palette to search for node red dashboard and click on install 2 Restart Node RED dashboard tab should appear in the right side panel 3 From dashboard tab add the wanted nodes e g gauge and wire them 4 Double click on the nodes to change their Properties as wanted 5 In a new tab open http localhost 1880 ui e i http 192 168 2 1 1880 ui ...

Page 22: ...ent input node 3 Add Debug node 4 Wire as shown in picture and Deploy Write Analog Inputs 10 2 2 1 Add Inject node double click on it and change the payload to Numbers and give the analog Value Current in 0 20 mA 1000 2 Add MC100 SensT2 current output node 3 Wire and Deploy PT100 1000 10 2 3 1 Add the Inject node 2 Add MC100 SensT2 RTD 3 Double click on MC100 SensT2 RTD node to open the settings m...

Page 23: ... inputs and outputs of the MC100 products can be controlled or read out by commands via command line interface using SSH access or from programming tools The corresponding commands are shown below with examples 11 1 MC100 Circuit Inputs Galvanically isolated inputs with respect to ground High detection from 5VDC max 30VDC Outputs Galvanically isolated OptoMOS outputs against ground Open drain circ...

Page 24: ...00nF against GND 5 No function Internal 100nF against GND 6 RD Receive minus 7 nc 8 Shield Internal shielding LED yellow SPEED 1 Blinks Led Blinks once 10Base link 2 Blinks Led Blinks twice 100Base link LED green ENWAYEN ON Network link has been established Blinking Network activity has been detected 11 3 Power supply all Connection to an AC power supply must be made by using a suitable power supp...

Page 25: ...andard GND of the device Digital inputs 11 4 1 The MC100 Gateway has two digital inputs The inputs are high active Function Read in the digital inputs I1 and I2 Port Parameter Read Write Path I1 1 0 x cat sys mc100_gpios IN1 I2 1 0 x cat sys mc100_gpios IN2 Example Reading Input I1 Command cat sys mc100_gpios IN1 Response 1 or 0 Digital Outputs 11 4 2 The MC100 Gateway has two digital outputs The ...

Page 26: ...ace is not galvanically isolated The RS485 interface can be addressed as dev ttymxc4 from the console Example picocom b 115200 dev ttymxc4 Now it is possible to communicate with the RS485 port RX TX is switched automatically Finally terminate picocom with Ctrl a x CAN Interface 11 4 4 Port Description CH CAN High CL CAN Low GND Ground Earth RS232 Interface 11 4 5 Port Signal Description 1 nc Not c...

Page 27: ... not connect a signal DGND2 Digital Ground 2 electrically isolated to all D GND I1 bis I4 Digital inputs Input voltage 0 to 30V Switching threshold approx 4V All input voltages with DGND2 as ground VPU2 Not supported please do not connect a signal Function Reading the digital inputs I1 to I8 v1 0 4 and older Port Parameter Read Write Path I1 1 0 x sys gpio_board_IO inputs input0 value I2 1 0 x sys...

Page 28: ...witch OxB the second pin All outputs are galvanically isolated The maximum switching current is 300mA The maximum applied voltage must not exceed 30V Function Switching the digital outputs v1 0 4 or older Port Parameter Read Write Path O1A O1B 1 0 X sys gpio_board_IO outputs output0 value O2A O2B 1 0 X sys gpio_board_IO outputs output1 value O3A O3B 1 0 X sys gpio_board_IO outputs output2 value O4...

Page 29: ...oltage must not exceed 10V Function Reading the voltage inputs v1 0 4 or older Port Parameter Read Write Path A1 A1 Value x sys gpio_board_ADC voltage volt0 value A2 A2 Value x sys gpio_board_ADC voltage volt1 value Example Read voltage at ADC input A1 A1 Command cat sys gpio_board_ADC voltage volt0 value Response e g 6400 Function Reading the voltage inputs v1 0 5 or later Port Parameter Read Wri...

Page 30: ... Function Reading the current inputs v1 0 5 and later Port Parameter Read Write Path A3 A3 Value x sys gpio_board current_in 1 A4 A4 Value x sys gpio_board current_in 2 Example Read current at ADC input A3 A3 Command cat sys gpio_board current_in1 value Response e g 2000 Note Converting to mA Formula Current in mA Value 200 Example Value 2000 corresponds to 10mA PWM 11 5 5 Port Description GND Gro...

Page 31: ... voltage 0 to 30V Switching threshold approx 4V All input voltages with DGND1 as ground VPU1 Not supported please do not connect a signal DGND2 Digital Ground 2 electrically isolated to all D GND I1 bis I4 Digital inputs Input voltage 0 to 30V Switching threshold approx 4V All input voltages with DGND2 as ground VPU2 Not supported please do not connect a signal Function Reading the digital inputs ...

Page 32: ...tputs have an identical behaviour The description here is only for one output x 1 and 2 MC100 SensT2 All switching outputs are represented by solid state relays OxA occupies one pin of the switch OxB the second pin All outputs are galvanically isolated The maximum switching current is 300mA The maximum applied voltage must not exceed 30V Function Switching the digital outputs v1 0 4 and older Port...

Page 33: ... voltage volt0 value A2 A2 Value x sys senst2_ADC voltage volt1 value Example Read voltage at ADC input A1 A1 Command cat sys senst2_ADC voltage volt0 value Response e g 6400 Function Reading the voltage inputs v1 0 5 and later Port Parameter Read Write Path A1 A1 Value x sys senst2_board voltage_in 1 A2 A2 Value x sys senst2_board voltage_in 2 Example Read voltage at ADC input A1 A1 Command cat s...

Page 34: ... the sensor to A3 and A3 or A4 and A4 Port Description A3 Positive connection output 3 sensor supply approx 12V to 14V A3 Negative connection Input 3 A4 Positive connection output 4 sensor supply approx 12V to 14V A4 Negative connection Input 4 Function Reading the current inputs v1 0 4 and older Port Parameter Read Write Path A3 A3 Value x sys senst2_ADC ampere amp0 value A4 A4 Value x sys senst2...

Page 35: ... x sys senst2_rtd rtd0 value RTD2 Value x sys senst2_rtd rtd1 value RTD3 Value x sys senst2_rtd rtd2 value RTD4 Value x sys senst2_rtd rtd3 value Example Read the value at RTD1 Command cat sys senst2_rtd rtd0 value Response e i 100000 Function Reading a resistance temperature value v1 0 5 and later Port Parameter Read Write Path RTD1 Value x sys senst2_board rtd 1 RTD2 Value x sys senst2_board rtd...

Page 36: ...100 echo off sys mc100_leds led2 mode Flash mode root MC100 echo flash sys mc100_leds led2 mode Blink mode root MC100 echo 50 sys mc100_leds led2 blinkPeriod Note 50 is the time between each blinking in ms can be set to any value 2 LED 3 Turn ON root MC100 echo on sys mc100_leds led1 mode Turn OFF root MC100 echo off sys mc100_leds led1 mode Flash mode root MC100 echo flash sys mc100_leds led1 mod...

Page 37: ...s You will need Certificate Authority ca crt Server certificate server crt and server key server key Client certificate client crt and client key client key 12 1 Client Configuration 1 After logging to MC100 Luci interface using the IP address default 192 168 2 1 click on OpenVPN under VPN tab 2 Click on EDIT at sample_client tab 3 Click on Switch to advanced configuration 4 Edit the settings as t...

Page 38: ...king change every setting as same as given in the conf file 3 Same for VPN section 4 Under Cryptography a Change the cipher type to the one given in the conf file b In the path ETC LUCI UPLOADS upload the Certificate authority ca file CRT local certificate cert CRT and the local private key key key 5 Click on SAVE APPLY and then BACK TO OVERVIEW 6 Enable the configured instance then click on SAVE ...

Page 39: ...hnologies net 39 12 2 Server Configuration 1 After logging to MC100 Luci interface using the IP address default 192 168 2 1 click on OpenVPN under VPN tab 2 Click on EDIT at sample_server tab 3 Click on Switch to advanced configuration 4 Edit the settings as the one in the server conf file you have Example 1 Under Service Change verb verbosity same as given in the conf file here it is 3 ...

Page 40: ...setting as same as given in the conf file 3 Same for VPN section 4 Under Cryptography a Change the cipher type to the one given in the conf file b In the path ETC LUCI UPLOADS upload the Certificate authority ca file CRT Diffie Hellman parameters dh PEM local certificate cert CRT and the local private key key key 5 Click on SAVE APPLY and then BACK TO OVERVIEW 6 Enable the configured instance and ...

Page 41: ...ch can be individually set for each output channel URL FILE Command line hex 13 4 1 Hex produces the message in hexadecimal One message per line Example on hex Output Usage mcwmbus options Copyright C 2020 MC Technologies GmbH Options h Show this help message and exit V Show version information and exit v Print verbose debug information d DEVICE tty device default dev ttymxc2 b BAUD Baud rate for ...

Page 42: ...umber 152 Status 00 Signature 0000 DataRecords id 0 Function Instantaneous value StorageNumber 0 VIF 102 VIFE 0 Unit External temperature 1e 1 deg C Value 232 Timestamp 2020 06 09T07 51 08Z id 1 Function Instantaneous value StorageNumber 0 VIF 102 VIFE 0 Unit External temperature 1e 1 deg C Value 233 Timestamp 2020 06 09T07 51 08Z RawMessage 1644AF4C02000041011B7A980000000266E8000266E900 json 13 4...

Page 43: ...n 13 6 Writing on disk When writing data to disk it is possible to make parts of the path dynamic by using the special characters M Manufacturer ID D Device Type Medium U Ident Nr V Version xml version 1 0 encoding ISO 8859 1 MBusData SlaveInformation Id 41000002 Id Manufacturer SEO Manufacturer Version 1 Version ProductName Sensoco Wireless M Bus 2 NTC Temperature Sensor ProductName Medium Ambien...

Page 44: ...us the nice opportunity of preselecting manufacturer and device Example file tree for mcwmbus f wmbus_messages M U json 13 7 View live information in Node RED To view live information in Node RED we can create a flow that has a rest server and displays the information using the dashboard plugin for node red The output might look like this The Node Red flow for example wmbus_messages 18c4 17949 jso...

Page 45: ...MC100 mcwmbus u http localhost 1880 wmbus c C json 13 8 Combine data for 1h 6h 1day and send via FTP SCP Collect messages for the whole day as interpreted json but only send messages from manufacturer SEO to a server at the end of the day in a zip file while true do mcwmbus F json f wmbus_messages M json sleep 86400 60 60 24 24 hours killall mcwmbus zip SEO zip wmbus_messages 4caf json scp SEO zip...

Page 46: ...ebsite Shop www mc technologies net Email info mc technologies net 46 13 9 Support Please execute mcwmbus vV and sent the output together with your error description and any error message to support mc technologies net It will be helpful if you run the command that produced the error with vvvvvv to turn on the maximal debug information ...

Page 47: ...bus directory to usr lib node node red node_modules Then restart node red via etc init d node red restart Do not try to install the node red contrib modbus package from within Node RED This will fail and leave you with an inconsistent state Use our method to get a working version Creating a first flow 14 1 1 1 Open Node Red in your browser 2 Add Debug node 3 Add Modbus read node 4 Wire them 5 Doub...

Page 48: ...t button near Server to configure the Modbus device 8 Change Type to Serial Expert 9 Change Serial port to dev ttymxc4 10 Make sure that the Serial Type is RTU BUFFERED and not RTU 11 Deploy By clicking on Debug messages fetched from the device should be seen 14 2 Modbus command line tool Installation 14 2 1 To install the modbus command line tool you have to install the mcmodbus ipk from the MC T...

Page 49: ... mcmodbus vv a 0 Show help message mcmodbus mcmodbus h Read register 0 on slave 17 mcmodbus s 17 Set the output of slave 17 for the I O Pins 4 5 6 to 1 0 1 mcmodbus o wb a 4 s 17 1 0 1 Use another device with a baud rate of 115200 mcmodbus d dev ttyUSB10 b 115200 Setting digital output at address 0x34 to ON mcmodbus o wib a 0x34 1 mcmodbus o wib a 064 1 mcmodbus o wib a 52 1 Reading analog input a...

Page 50: ...Configuration 8 data bits no parity 1 stop bit For MBUS the PMIC must activate the power supply of the M Bus module This is done at start up by the script in etc rc d s90pmic The most common source of error for a non functioning M BUS is the lack of this script 15 2 Using libmbus On the MC100 libmbus and certain programs for communication with Mbus are installed Those are mbus serial request data ...

Page 51: ...r has been loaded the user functions are located in the following folder sys class 1w To enter the folder using Command prompt use the command root MC100 cat sys class 1w There are the following files which act as interface for the user probe_bus read write reset Function files 16 1 2 probe_bus This scans the 1 wire bus and registers all detected 1 wire devices The following command executes the s...

Page 52: ...d command Example root MC100 echo 9 be sys class 1w write root MC100 reset This file rests the bus Example root MC100 echo 1 sys class 1w reset root MC100 Select device 16 1 3 A separate folder is created for each device detected during scanning Example root MC100 ls sys class 1w 100702A30308004e 105B94A303080036 probe_bus read reset write For selecting a specific device the user has to write to t...

Page 53: ...e root MC100 ls mnt owfs 10 0702A3030800 temperature 24 5625 OWhttpd 16 2 2 OWFS provides a small webserver that shows the Dallas Maxim 1 Wire bus attached to a serial port The main page shows the devices found you can then navigate to individual devices and view change their properties This can be enabled using the following steps 1 Type the following command and press print root MC100 vi etc con...

Page 54: ...ur system and make it unusable root MC100 opkg list upgradable cut f 1 d grep v base root MC100 files update packages txt root MC100 cat update packages txt xargs n 1 opkg u pgrade src gz openwrt_core https downloads mctechnologies net MC100 v2 4 1 0 4 targets imx6 generic packages src gz openwrt_base https downloads mctechnologies net MC100 v2 4 1 0 4 packages arm_cortex a9_neon base src gz openw...

Page 55: ...00 all into Download and install package 3 Click on install 4 Click on Updates 5 Install all except base files 6 Restart your device to get full effect We recommend installing the mc100 all package as it will install all newly developed features for the mc100 src gz openwrt_core https downloads mctechnologies net MC100 v2 4 1 0 4 targets imx6 generic packages src gz openwrt_base https downloads mc...

Page 56: ...ocate the Reset button on the back of your MC100 device Use the pointed end of a paperclip or similar object to press and hold the Reset button Then while still holding the button connect the power After approximately 5 seconds the red LED will start flashing and only the green LED 5 will be lit After 2 3 minutes the red light will flash and then the green LED 5 will lit again Wait for the device ...

Page 57: ...pair Send defective products with a detailed error description to MC Technologies GmbH Kabelkamp 2 30179 Hannover Before shipping the device Call our support team and ask for an RMA Return to Manufacturer Authorisation number Remove possibly inserted SIM cards Back up the configurations on the device and any other data stored on it Back up any applications running on the device It is not permitted...