tutorial/45mr-updater/README.md
Go to the documentation of this file.
1 How to update 45MR-Modules {#updater}
2 ----
3 @brief Tutorial to update the firmware of 45MR-Modules.
4 
5 # 45MR-Updater {#updater-45mr-updater}
6 
7 > **Table of Contents**
8 >
9 > [Introduction](#updater-introduction)
10 >
11 > [Method 1: Update 45MR-Modules with specify 45MR-Firmware](#updater-method-1)
12 >
13 > [Method 2: Update 45MR-Modules with default 45MR-Firmware](#updater-method-2)
14 >
15 > [Appendix: Usage of moxa-45mr-updater](#updater-appendix)
16 
17 ## Introduction {#updater-introduction}
18 
19 45MR-Updater is a tool that use for update the firmware of 45MR-Modules.
20 
21 45MR-Firmware is a firmware file of 45MR-Modules.
22 
23 There are two ways to update the firmware of 45MR-Modules:
24 
25 1. Update 45MR-Modules with specify 45MR-Firmware that download from MOXA official website
26 
27 2. Update 45MR-Modules with default 45MR-Firmware that is contained in the ioThinx
28 
29 ## Method 1 {#updater-method-1}
30 
31 > Update 45MR-Modules with specify 45MR-Firmware
32 
33 1. Setup a network connection to allow device able to access the network.
34 
35 2. Download "45MR-Firmware" from MOXA official website and put it to device.
36 ```
37  moxa@Moxa:~$ ls
38  FWR_45MR_V1.1.0_Build19041210_STD.hfm
39 ```
40 
41 3. Update 45MR-Modules.
42 ```
43  moxa@Moxa:~$ sudo moxa-45mr-updater FWR_45MR_V1.1.0_Build19041210_STD.hfm
44  [sudo] password for moxa:
45  Firmware: FWR_45MR_V1.1.0_Build19041210_STD.hfm
46 
47  This step will update all modules and reboot the system
48 
49  Do you want to continue ? [y/N] y
50 
51  ------------INTEGRITY-CHECK------------
52 
53  FWR_45MR_V1.1.0_Build19041210_STD.hfm
54  Firmware[#########################]100%
55 
56  ---------------NEGOTIATE---------------
57 
58  Protocol[#########################]100%
59  Total Module Slot = 10
60 
61  -------------MODULE-UPDATE-------------
62 
63  Module: 45MR-1600 [1.1.0.1]
64  Slot[01][#########################]100%
65 
66  Module: 45MR-1601 [1.1.0.1]
67  Slot[02][#########################]100%
68 
69  Module: 45MR-2404 [1.1.0.1]
70  Slot[03][#########################]100%
71 
72  Module: 45MR-2600 [1.1.0.0]
73  Slot[04][#########################]100%
74 
75  Module: 45MR-2601 [1.1.0.0]
76  Slot[05][#########################]100%
77 
78  Module: 45MR-2606 [1.1.0.1]
79  Slot[06][#########################]100%
80 
81  Module: 45MR-3800 [1.1.0.0]
82  Slot[07][#########################]100%
83 
84  Module: 45MR-3810 [1.1.0.0]
85  Slot[08][#########################]100%
86 
87  Module: 45MR-6600 [1.1.0.0]
88  Slot[09][#########################]100%
89 
90  Module: 45MR-6810 [1.1.0.0]
91  Slot[10][#########################]100%
92 
93  System Rebooting ...
94 ```
95 
96 4. Check 45MR-Modules firmware version.
97 ```
98  moxa@Moxa:~$ kversion -a
99  ioThinx 4533-LX version 1.1 Build 19061213
100 
101  Master Infomation:
102  45MR Module Scan Time: 4 ms
103 
104  Slot 1 Module Information:
105  Model Name: 45MR-1600, Serial Number: MOXA89191230
106  Firmware Version: 1.1.0.1 Build 19041210
107 
108  Slot 2 Module Information:
109  Model Name: 45MR-1601, Serial Number: MOXA89191230
110  Firmware Version: 1.1.0.1 Build 19041210
111 
112  Slot 3 Module Information:
113  Model Name: 45MR-2404, Serial Number: MOXA89191230
114  Firmware Version: 1.1.0.1 Build 19041210
115 
116  Slot 4 Module Information:
117  Model Name: 45MR-2600, Serial Number: TAHLB1031597
118  Firmware Version: 1.1.0.0 Build 18121915
119 
120  Slot 5 Module Information:
121  Model Name: 45MR-2601, Serial Number: MOXA89191230
122  Firmware Version: 1.1.0.0 Build 18121915
123 
124  Slot 6 Module Information:
125  Model Name: 45MR-2606, Serial Number: MOXA89191230
126  Firmware Version: 1.1.0.1 Build 19041210
127 
128  Slot 7 Module Information:
129  Model Name: 45MR-3800, Serial Number: MOXA89191230
130  Firmware Version: 1.1.0.0 Build 18122117
131 
132  Slot 8 Module Information:
133  Model Name: 45MR-3810, Serial Number: MOXA89191230
134  Firmware Version: 1.1.0.0 Build 18122117
135 
136  Slot 9 Module Information:
137  Model Name: 45MR-6600, Serial Number: MOXA89191230
138  Firmware Version: 1.1.0.0 Build 18122117
139 
140  Slot 10 Module Information:
141  Model Name: 45MR-6810, Serial Number: MOXA89191230
142  Firmware Version: 1.1.0.0 Build 18122117
143 ```
144 
145 ## Method 2 {#updater-method-2}
146 
147 > Update 45MR-Modules with default 45MR-Firmware
148 
149 1. Update 45MR-Modules.
150 ```
151  moxa@Moxa:~$ sudo moxa-45mr-updater --default
152  [sudo] password for moxa:
153  Firmware: FWR_45MR_V1.1.0_Build19041210_STD.hfm
154 
155  This step will update all modules and reboot the system
156 
157  Do you want to continue ? [y/N] y
158 
159  ------------INTEGRITY-CHECK------------
160 
161  FWR_45MR_V1.1.0_Build19041210_STD.hfm
162  Firmware[#########################]100%
163 
164  ---------------NEGOTIATE---------------
165 
166  Protocol[#########################]100%
167  Total Module Slot = 10
168 
169  -------------MODULE-UPDATE-------------
170 
171  Module: 45MR-1600 [1.1.0.1]
172  Slot[01][#########################]100%
173 
174  Module: 45MR-1601 [1.1.0.1]
175  Slot[02][#########################]100%
176 
177  Module: 45MR-2404 [1.1.0.1]
178  Slot[03][#########################]100%
179 
180  Module: 45MR-2600 [1.1.0.0]
181  Slot[04][#########################]100%
182 
183  Module: 45MR-2601 [1.1.0.0]
184  Slot[05][#########################]100%
185 
186  Module: 45MR-2606 [1.1.0.1]
187  Slot[06][#########################]100%
188 
189  Module: 45MR-3800 [1.1.0.0]
190  Slot[07][#########################]100%
191 
192  Module: 45MR-3810 [1.1.0.0]
193  Slot[08][#########################]100%
194 
195  Module: 45MR-6600 [1.1.0.0]
196  Slot[09][#########################]100%
197 
198  Module: 45MR-6810 [1.1.0.0]
199  Slot[10][#########################]100%
200 
201  System Rebooting ...
202 ```
203 
204 2. Check 45MR-Modules firmware version.
205 ```
206  moxa@Moxa:~$ kversion -a
207  ioThinx 4533-LX version 1.1 Build 19061213
208 
209  Master Infomation:
210  45MR Module Scan Time: 4 ms
211 
212  Slot 1 Module Information:
213  Model Name: 45MR-1600, Serial Number: MOXA89191230
214  Firmware Version: 1.1.0.1 Build 19041210
215 
216  Slot 2 Module Information:
217  Model Name: 45MR-1601, Serial Number: MOXA89191230
218  Firmware Version: 1.1.0.1 Build 19041210
219 
220  Slot 3 Module Information:
221  Model Name: 45MR-2404, Serial Number: MOXA89191230
222  Firmware Version: 1.1.0.1 Build 19041210
223 
224  Slot 4 Module Information:
225  Model Name: 45MR-2600, Serial Number: TAHLB1031597
226  Firmware Version: 1.1.0.0 Build 18121915
227 
228  Slot 5 Module Information:
229  Model Name: 45MR-2601, Serial Number: MOXA89191230
230  Firmware Version: 1.1.0.0 Build 18121915
231 
232  Slot 6 Module Information:
233  Model Name: 45MR-2606, Serial Number: MOXA89191230
234  Firmware Version: 1.1.0.1 Build 19041210
235 
236  Slot 7 Module Information:
237  Model Name: 45MR-3800, Serial Number: MOXA89191230
238  Firmware Version: 1.1.0.0 Build 18122117
239 
240  Slot 8 Module Information:
241  Model Name: 45MR-3810, Serial Number: MOXA89191230
242  Firmware Version: 1.1.0.0 Build 18122117
243 
244  Slot 9 Module Information:
245  Model Name: 45MR-6600, Serial Number: MOXA89191230
246  Firmware Version: 1.1.0.0 Build 18122117
247 
248  Slot 10 Module Information:
249  Model Name: 45MR-6810, Serial Number: MOXA89191230
250  Firmware Version: 1.1.0.0 Build 18122117
251 ```
252 
253 ## Appendix {#updater-appendix}
254 
255 > Usage of moxa-45mr-updater
256 ```
257 moxa@Moxa:~$ sudo moxa-45mr-updater --help
258 [sudo] password for moxa:
259 Usage: moxa-45mr-updater [options] firmware
260 
261 Options:
262  -d, --default Update modules with default firmware
263  -v, --version Show version
264  -h, --help Show help
265  -y, --yes Assume "yes" to all prompts
266 
267 Example:
268  moxa-45mr-updater firmware Update modules with specify firmware
269  moxa-45mr-updater --default Update modules with default firmware
270  moxa-45mr-updater --help Show help
271 ```