Introduction
NET+OS Programmer is a tool to allow you to load your custom application onto a NET+OS device for the first time.
A NET+OS device, as shipped in the development kit, has an EOS that supports only NAFTP and ADDP.
This document assumes that no changes have been made to the default EOS image that was on the device when shipped.
This program allows you to:
- Discover the device on a network.
- Configure an IP address.
- Upload your firmware image to the device.
NOTE: NET+OS Programmer is intended for the FIRST load of your application. Once your image has been written into
flash and the unit has been rebooted, NET+OS Programmer will no longer be able to discover your device. In order to be
able to perform field updates, you will need to either include the RAM-Based FTP Server code (naftpapp_connect.c) or
implement your own web-based solution.
Discover the device
To discover your device on a network, type the command netosprog /discover.
NET+OS Programmer will list the MAC address and IP address of each device that it finds on the network.
Configure an IP address
To configure the IP address for a device, use the /set option:
Parameters for /set
/mac={MAC address | auto}
The MAC address of the target device. Alternatively, specify auto to configure the first device found.
/ip={IP address | dhcp}
The static IP address to use. Or use dhcp to enable DHCP.
/subnet={subnet mask}
The subnet mask. Valid only when configuring a static IP address.
/gateway={gateway address}
The gateway address. Valid only when configuring a static IP address.
/username={name}
The username for login to the device. The default is "root".
/password={password for username}
Username's password for login to the device. The defaults used by NET+OS Programmer
are "Netsilicon" and "password".
Examples
netosprog /set /mac=00409d254074 /ip=192.168.1.1 /subnet=255.255.255.0 /gateway=192.168.1.200
Assigns a static IP address to the device with 00:40:9D:25:40:74 as its MAC address.
netosprog /set /mac=auto /ip=dhcp
Enables DHCP on the first detected device.
Upload your firmware image to the device
Use the /upload option to load upload a firmware image to the device. Once the firmware has been successfully flashed to the device, the device will reboot.
Parameters for /upload
/mac={MAC address|auto}
The MAC address of the target device. Alternatively, specify auto to upload the image to the first device found.
/ip={IP address}
The current IP address of the device. Required only if the MAC address parameter is not used.
/firmware={filename}
The filename of the firmware (EOS) to upload to the device.
/username={name}
The username for login to the device. The default is "root".
/password={password for username}
Username's password for login to the device. The defaults used by NET+OS Programmer
are "Netsilicon" and "password".
Examples
netosprog /upload /ip=192.168.1.1 /firmware=c:\myfirmware.bin
Uploads the myfirmware.bin file to the device with IP address 192.168.1.1.
netosprog /upload /mac=auto /firmware=c:\myfirmware.bin
Uploads the firmware to the first device found.
Known Limitations
NET+OS Programmer uses UDP multicast to discover devices. This means
there are cases where devices won't be detected. Examples include:
- Having a firewall between (or on) your PC and the target device.
- Having a router between your PC and the target device.
- Running over a VPN or dial up connection that does not support
multicast.
|