@@ -6,63 +6,67 @@ Use this tool to update the firmware and/or add SSL certificates for any WINC, N
6
6
7
7
You can download the Firmware/Certificates updater here:
8
8
9
- https://github.com/arduino/FirmwareUpdater /releases/latest
9
+ https://github.com/arduino/FirmwareUploader /releases/latest
10
10
11
11
## Usage
12
12
13
13
Extract the zip file and run (for example, NINA -> WiFi1010)
14
14
15
15
```
16
- ./$your_os/updater -flasher firmwares/NINA/FirmwareUpdater.mkrwifi1010.ino.bin -firmware firmwares/NINA/1.2.1/NINA_W102.bin -port /dev/ttyACM0 -address arduino.cc:443 -restore_binary /tmp/arduino_build_619137/WiFiSSLClient.ino.bin -programmer {runtime.tools.bossac}/bossac
16
+ ./FirmwareUploader -flasher firmwares/NINA/FirmwareUpdater.mkrwifi1010.ino.bin -firmware firmwares/NINA/1.2.1/NINA_W102.bin -port /dev/ttyACM0 -address arduino.cc:443 -restore_binary /tmp/arduino_build_619137/WiFiSSLClient.ino.bin -programmer {runtime.tools.bossac}/bossac
17
17
```
18
18
19
19
To flash a MKR1000:
20
20
21
21
```
22
- ./$your_os/updater -flasher firmwares/WINC1500/FirmwareUpdater.mkr1000.ino.bin -firmware firmwares/WINC1500/19.5.4/m2m_aio_3a0.bin -port /dev/ttyACM0 -address arduino.cc:443 -restore_binary /tmp/arduino_build_619137/WiFiSSLClient.ino.bin -programmer {runtime.tools.bossac}/bossac
22
+ ./FirmwareUploader -flasher firmwares/WINC1500/FirmwareUpdater.mkr1000.ino.bin -firmware firmwares/WINC1500/19.5.4/m2m_aio_3a0.bin -port /dev/ttyACM0 -address arduino.cc:443 -restore_binary /tmp/arduino_build_619137/WiFiSSLClient.ino.bin -programmer {runtime.tools.bossac}/bossac
23
23
```
24
24
25
25
To update a MKRNB1500:
26
26
27
27
```
28
- ./$your_os/updater -flasher firmwares/SARA/SerialSARAPassthrough.ino.bin -firmware firmwares/SARA/5.6A2.00-to-5.6A2.01.pkg -port /dev/ttyACM0 -restore_binary firmwares/SARA/SerialSARAPassthrough.ino.bin -programmer {runtime.tools.bossac}/bossac
28
+ ./FirmwareUploader -flasher firmwares/SARA/SerialSARAPassthrough.ino.bin -firmware firmwares/SARA/5.6A2.00-to-5.6A2.01.pkg -port /dev/ttyACM0 -restore_binary firmwares/SARA/SerialSARAPassthrough.ino.bin -programmer {runtime.tools.bossac}/bossac
29
29
```
30
30
31
31
### Command line options
32
32
33
- The full list of command line options can be obtained with the ` -h ` option: ` ./updater -h `
33
+ The full list of command line options can be obtained with the ` -h ` option: ` ./FirmwareUploader -h `
34
34
35
35
```
36
- Usage of ./distrib/linux64/updater :
36
+ Usage of ./FirmwareUploader :
37
37
-address value
38
38
address (host:port) to fetch and flash root certificate for, multiple values allowed
39
39
-certs string
40
40
root certificate directory
41
41
-firmware string
42
42
firmware file to flash
43
43
-flasher string
44
- firmware upload binary (precompiled for the right target) -> if not provided it will expect FirmwareUpdater sketch to be already flashed on the board
44
+ firmware upload binary (precompiled for the right target)
45
+ -get_available_for string
46
+ Ask for available firmwares matching a given board
45
47
-model string
46
- module model (winc or nina )
48
+ module model (winc, nina or sara )
47
49
-port string
48
50
serial port to use for flashing
49
51
-programmer string
50
52
path of programmer in use (avrdude/bossac)
51
53
-read
52
54
read all firmware and output to stdout
53
55
-restore_binary string
54
- firmware upload binary (precompiled for the right target) -> if not provided it will try to restore the original firmware
56
+ firmware upload binary (precompiled for the right target)
55
57
```
56
58
57
59
## How to build the tools from source file
58
60
59
- From the sources root directory run:
61
+ To build we use [ task ] ( https://taskfile.dev/ ) for simplicity. From the sources root directory run:
60
62
61
63
```
62
- go build -o updater
64
+ task dist:<OS>_<ARCH>
63
65
```
64
66
65
- This will create the ` updater ` executable.
67
+ Where <OS > could be one of: ` macOS ` ,` Windows ` ,` Linux ` . And <ARCH >: ` 32bit ` , ` 64bit ` , ` ARM ` or ` ARM64 `
68
+
69
+ This will create the ` FirmwareUploader ` executable.
66
70
67
71
## Security
68
72
@@ -86,4 +90,4 @@ details.
86
90
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the
87
91
Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
88
92
89
- [ security-policy ] : https://github.com/arduino/FirmwareUpdater /security/policy
93
+ [ security-policy ] : https://github.com/arduino/FirmwareUploader /security/policy
0 commit comments