--tlhackque

I tried using upslug2, and it didn't work for me. Upslug couldn't find the slug. I had the two machines connected directly via the ethernet port (no hub or router), and the slug was flashing red/green.

--bcrowell

UpSlug has been verified to work with the NAS200, but you will have to use a NAS200 image of course, and you will have to use the -f option because NAS200 images don't have the SerComm signature (if you make a mistake, you can always do it again because the Redboot area in memory will not be overwritten as long as you use -u, not -U). This is great if you flashed the NAS200 with a bad image but you can still access Redboot through the serial port or via Telnet. Unfortunately it will not save you if you bricked your NAS200 by typing "flash" at the command prompt.

UpSlug has been verified to work with the NAS200, but you will have to use a NAS200 image of course, and you will have to use the -f option because NAS200 images don't have the SerComm signature. This is great if you flashed the NAS200 with a bad image but you can still access Redboot through the serial port or via Telnet. Unfortunately it will not save you if you bricked your NAS200 by typing "flash" at the command prompt.

UseTheResetButtonToEnterUpgradeMode

• 10 Aug 2007; while uploading di-nslu2.bin (Debian 4.0), upslug2 (v11-1) would repeatedly time out at:
  * 5bd87f+0005c0 ...UUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU*------------------

Switching from a wireless NIC to a wired one fixed it. (dharple)

(jbowler: these changes, plus others, are in upslug 1.14)

For upslug -r to work, the download process must be running. /etc/rc.d/rc.1 should start it, but - at least in my environment - this is commented out. I did this a long time ago because I don't like the idea of an unsecured service that will reboot (and reflash) hardware. I think this is also true in the current release. In any case, if upslug reports

Finding Slugs... 0 found upslug: no slugs found, turkey problems?

and you have routes and cables properly configured, telnet into the slug and do a ps | grep download. If it's not running, ru /sbin/download to start it.

--tlhackque

UpSlug is a (Linux / MacOS? X / but not Windows - Windows users use SercommFirmwareUpdater) tool to flash your NSLU2 from an external computer on the same subnet (direct Ethernet access is needed; it won't work if you have routers or NAT devices between you and the NSLU2, though WiFi? via a wireless router is OK).

UpSlug is a (Linux / MacOS? X / but not Windows) tool to flash your NSLU2 from an external computer on the same subnet (direct Ethernet access is needed; it won't work if you have routers or NAT devices between you and the NSLU2, though WiFi? via a wireless router is OK).

UpSlug must be run as root or with the sudo command.

Switch the nslu2 into Upgrade mode

If you want to upgrade your slug without letting your NSLU2 reach the "running" state, you need to enter RedBoot upgrade mode. There are two ways to do this. First, you can interrupt RedBoot in the normal way described here and then type upgrade at the RedBoot prompt. If this fails (it can be difficult to get the timing right):

UpSlug is a tool to flash your NSLU2 from an external computer on the same subnet (direct Ethernet access is needed; it won't work if you have routers or NAT devices between you and the NSLU2, though WiFi? via a wireless router is OK).

The release at the time this page was last updated is 1.17 (of upslug.c).

Verification of the flash image is non-functional in this version, however this is fixed in 1.17 and later.

1.16 (and later) also fixes a problem on heavily loaded networks when responses from the NSLU2 may get dropped.

Even in 1.17 there are probably still errors in the protocol handling. UpSlug2 should fix all of these since the protocol return codes are verified correctly.

If NSLU2 response packets are duplicated (resulting in an out of sequence response) upslug will output a + character and continue looking for the expected response packet (changed in 1.16).

The following entries refer to problems with upslug which should now all be fixed. Please report any occurence of these problems with the latest (1.17) version, as well as any new problems!

[jbowler: UpSlug2 does this by checking the hardware ID - this comes out of the tail of the RedBoot partition when it is written by LinkSys?. This may cause UpSlug2 to fail to recognise some slugs, if they have a different ID.]

UpSlug2 is a completely rewritten version of this tool which is more robust and flexible, though it still requires an ethernet connection to the NSLU2.

UpSlug is a tool to flash your NSLU2 from an external computer on the same subnet (direct Ethernet access is needed, it doesn't work if you have anything between you and the NSLU2 like routers or NAT devices)

If you want to upgrade your slug without letting your NSLU2 reach "running" state first. You need to enter RedBoot upgrade mode. There are two ways to do this. First, you can interrupt RedBoot in the normal way described here and then type upgrade at the RedBoot prompt. If this fails (it can be difficult to get the timing right):

1. UpSlug hangs (the download stops) in the presence of high levels of network activity.

With the current OpenSlug, new (> v4.20 beta) Unslung versions the NSLU2 must be in upgrade mode before UpSlug can see it. This is because OpenSlug does not currently listen for the packets used in the upgrade protocol.

1. Maybe by product ID (though that wont for for me since I stuffed mine up a while back)
2. By MAC Address 00:04:5a:xx:yy:zz

I decided to fix it myself since my NSLU2 is not bootable anyway. I made some changes and it worked. upslug restored the firmware without any trouble. The major change is to ignore the error and let it continue to write.

I hacked upslug.c a little bit, below are the changes:

• Change strcmp to strcasecmp so it can identify Mac address in upper case

I compiled upslug under Redhat 7.2 and used it to flash firmware for my NSLU2 and it worked. I tar and gzip binary and source files to http://ctsai.erinna.com/upslug.tar.gz. Would someone merge my changes to the source!

UpSlug is a tool to flash your NSLU2 from an external computer on the same subnet (direct Ethernet access is needed, it doesn't work if between you and the NSLU2 are routers or NAT devices).

The release at the time this page was last updated is 1.14 (of upslug.c).

If you want to upgrade your slug without letting your NSLU2 reach "running" state first. You need to enter redboot upgrade mode. There are two ways to do this. First, you can interrupt redboot in the normal way described here and then type upgrade at the redboot prompt. If this fails (it can be difficult to get the timing right):

1. Power off the slug.
2. Hold the reset button in (the button is behind the small hole in the back of the case.)
3. Press and release the power button to turn the slug on (while still holding the reset button on.)
4. Wait about 10 seconds until the ready/status LED turns from amber to red, immediately release the reset button.

After these steps the slug will be in upgrade mode - the ready/status LED will flash alternately red and green. This continues until the slug is reset by the upload software.

UpSlug status and problems

The changes in release 1.14 of upslug.c are believed to fix the following problems:

1. upslug hangs (the download stops) in the presence of high levels of network activity.
2. Some upslug commands could get ignored by the NSLU2 because the network packet containing the command is lost and upslug was not checking for successful receipt.
3. Some error conditions were not detected.

Verification of the flash image seems to be non-functional, however the download command has never been seen to produce a bad image if it succeeds.

Upslug output

During download upslug outputs a progress indicator every 128KBytes. The indicator is a hexadecimal digit, thus the indicator goes through 4 cycles 0 to f for the 8MByte flash image.

The data is transmitted in 512 byte packets. If the NSLU2 does not acknowledge receipt of a packet it is retransmitted and a single * character is output.

Because the erase takes a long time a number of * characters are output initially (while upslug waits for response to the first write packet), then upslug outputs the message Writing flash and starts outputting progress digits.

The importance of upgrade mode

With the current OpenSlug and possibly with LinkSys? software the NSLU2 must be in upgrade mode before upslug can see it. This is because OpenSlug does not currently listen for the packets used in the upgrade protocol.

Problems with upslug

The following entries refer to problems with upslug which should now all be fixed. Please report any occurence of these problems with the latest (1.14) version, as well as any new problems!

(jbowler: these changes, plus others, are in upslug 1.14)

Even I used version 1.13 I still got Erasing Flash...upslug: Resource temporarily unavailable

• Change strcmp to strcasecmp so it can idetify Mac address in upper case
• Change all &pkt to pkt. I am wondering why it works for others because from a standard C point of view, memset(&pkt, 0, ...) seems not right.
• Ignore recvfrom() error in write_image

Got upslug to work

Even I used version 1.13 I still got "Erasing Flash...upslug: Resource temporarily unavailable" I decided to fix it myself since my NSLU2 is not bootable anyway. I made some changes and it worked. upslug restored the firmware without any trouble. The major change is to ignore the error and let it continue to write. I hacked upslug.c a little bit, below are changes: 1) change strcmp to strcasecmp so it can idetify Mac address in upper case 2) change all &pkt to pkt. I am wondering why it works for others because from a standard C point of view, memset(&pkt, 0, ...) seems not right. 3) Ignore recvfrom() error in write_image I compiled upslug under Redhat 7.2 and used it to flash firmware for my NSLU2 and it worked. I tar and gzip binary and source files to ctsai.erinna.com/upslug.tar.gz. Would someone merge my changes to the source!

• 8 May 2005: upslug suddenly stopped detecting my nslu2 even though I could still arping it. With access to the RedBoot prompt, putting RedBoot into upgrade mode with "upgrade" allowed upslug to detect the nslu2 and proceed with the upload. Thanks jbowler for the tip. (corys)

The code can be found in the upslug module of the nslu.sf.net CVS repository

I'm not sure how we can do that... 1) maybe by product ID (though that wont for for me since I stuffed mine up a while back) 2) By MAC Address 00:04:5a:xx:yy:zz

http://cvs.sourceforge.net/viewcvs.py/nslu/upslug/upslug.c?view=markup (this is the "upslug" module in the nslu.sf.net CVS repository).

This issue has been resolved in version 1.13.

but I don't know beans about Unix socket programming so I stopped there.
This issue has been resolved.

• 13 Jan 2005: mikeb reports a bug on his system: upslug dies with an error (upslug version:1.12, from CVS. Gentoo Linux, kernel v2.6.9-r1, gcc v3.3.4) Here's a section of the output:

• 13 Jan 2005: mikeb reports a bug on his system: upslug dies with an error (Gentoo Linux, kernel v2.6.9-r1, gcc v3.3.4) Here's a section of the output:

 Do you really want to upgrade the slug(y/n)? y
 Requesting upgrade...comfirmed
 Erasing Flash...upslug: Resource temporarily unavailable

I tracked this message down to the first call to recvfrom() in the write_image() routine, but I don't know beans about Unix socket programming so I stopped there.

My slug was hosed after upslug crashed (blinking red light; I presume it was waiting for more data) but after spending a couple minutes emerging TFTP and fiddling with ifconfig (to move my server to the 192.168.0.* subnet where it was visible to the slug) I got unslung installed using the HowTo.RecoverFromABadFlash TFTP instructions?. My thanks to all of you for figuring out all these methods! (mikeb)

• eall implementation (done needs tested)
• Windows version (in progress slowly...)

Works for me (devil26)

The image being loaded is built by oe.
This should be fixed now, please test.

verify_file_contents() is not properly initialised to 0.
Thank you for catching this. I will fix it ASAP.

Thank you for catching this. I will fix it ASAP

FIX --> This is because variable "counted_blocks" in function verify_file_contents() is not properly initialised to 0.

• It might be nice to have upslug only talk to slugs. Right now it detects other stuff on my net like print server. (dyoung)

 I'm not sure how we can do that...
 1) maybe by product ID (though that wont for for me since I stuffed mine up a while back)
 2) By MAC Address 00:04:5a:xx:yy:zz

Instructions to build are found UpSlugBuildInstructions here?

Instructions to build are found http://nslu2-linux.org/wiki/Main/UpSlug/UpSlugBuildInstructions here

If you want to upgrade your slug without letting your NSLU2 reach "running" state first. You need to enter redboot upgrade mode. There are two ways to do this. First, you can interrupt redboot in the normal way described HowTo.TelnetIntoRedBoot here? and then type upgrade at the redboot prompt. Secondly, it is reported that holding the reset button in when turning on the slug will put it in upgrade mode though I have not done this personally.

JTAG support before testing this.||

TAG support before testing this.||

• partial erases/writes (might not be possible)

• Process for easy 3.x upgrades (in progress...)
• a reset function that works more reliably (may not be possible)
• Windows version (in progress slowly

Planned Implementations (Christopher's TODO list)

• partial erases/writes
• eall implementation (for complete redboot included upgrades)
• Process for easy 3.x upgrades
• clean-up code
• make it so that options can be used in any order
• add a --help option that summarizes commands
• a reset function that works more reliably

• Windows version

• Add a -i option for interface name (which defaults to eth0 if not specifice). Then I can upslug on eth1 without recompiling :)

• I must use the --upload force option always. (dyoung)

 (messages)
 Verifying File Contents...
 Counted Blocks:1073851176
 Needed Blocks:16384
 Error: File not large enough, use --upload-force to override

The image being loaded is built by oe.

• There has been a report of file size being reported wrongly, please post here and with a bug report if you have a similar issue or any other issue.

UpSlug must be run as root or with the sudo command.
If you want to upgrade your slug without letting your NSLU2 reach "running" state first. You need to enter redboot upgrade mode. There are two ways to do this. First, you can interrupt redboot in the normal way described HowTo.TelnetIntoRedBoot here? and then type upgrade at the redboot prompt. Secondly, it is reported that holding the power button in when turning on the slug will put it in upgrade mode though I have not done this personally.

UpSlug is a tool to flash your NSLU2 from an external computer on the same subnet.

UpSlug is a tool to flash your NSLU2 from an external computer running linux on the same subnet.

UpSlug is a tool to flash your NSLU2 from a PC running linux on the same subnet.

Upslug is a tool to flash your NSLU2 from within the running linux environment on the NSLU2.

The UpSlug firmware upload tool is now in alpha phase.

UpSlug must be run as root or with the sudo command.

• UpSlug now has support for multiple slugs

Upslug must be run as root or with the sudo command.

• Upslug now has support for multiple slugs

• Sometimes the slug ignores the reset command even though it has been received. If upslug says it is done and the slug does not reboot within a couple of minutes then you must manually reset the slug. Do not try to reflash the slug if this occurs as it will not flash correctly. Upslug can recover from this but it is better to just reset and try again.

Planned Implementations

Please post any issues that you have with this tool here

Feature Requests

• Sometimes the slug ignores the reset command even though it receives it -- please manually reset if upslug says that it is done and your system does not reboot in a couple of minutes. Do not reflash your slug if this occurs as it appears to flash incorrectly if you do not reboot first. Upslug can recover from this condition, but it would be better not to have it in the first place.

Skips the slug selection prompt, looks for the slug Id given and then attempts to perform the command on that slug\\

--slugid 00:11:22:33:44:55 --some_command Skips the sluf selection prompt, looks for the slug Id given and then attempts to perform the command on that slug\\

• Ability to tell it which unit to talk to at command line, ie

 upslug --slugid 001122334455 --upload foo.img

• Ability to tell it which unit to talk to at command line, ie

 upslug --slugid 001122334455 --upload foo.img

--reset
resets the slug
--upload image_name.img\\ uploads the firmware image to the slug, verifies the upload and then resets the slug.
--upload-force image_name.img
uploads the firmware without checking for the Sercomm signature or propwer length.

---------------------------------

(Currently upslug must be run as root or with the sudo command) --reset

--upload image_name.img

--upload-force image_name.img

--reset resets the slug
--upload image_name.img uploads the firmware image to the slug, verifies the upload and then resets the slug.
--upload-force image_name.img uploads the firmware without checking for the Sercomm signature or propwer length.\\

• Upslug now has support for multiple slugs

• Windows version (depends on interest level)

--reset resets the slug

--upload-force image_name.img uploads the firmware without checking for the Sercomm signature or propwer length.

--upload-force image_name.img@ uploads the firmware without checking for the Sercomm signature or propwer length.

This tool has worked consistently for several people. The support for multiple slugs seems to work as well.

• Upslug now has support for multiple slug

Upslug is a tool to flash your NSLU2 from within the running linux environemt on the NSLU2.

• Sometimes the slug ignores the reset command even though it receives it please manually reset if upslug says that it is done and your system does not reboot in a couple of minutes. Do not reflash your slug if this occurs as it appears to flash incorrectly if you do not reboot first. Upslug can recover fromt this condition, but it would be better not to have it in the first place.

• Upslug now has support for multiple slugs (appears to be working for dyoung)

(Currently upslug must be run as root or with the sudo command)\\

• Upslug now has support for multiple slugs (appears to be working for rwhitby and dyoung)

• Sometimes the slug ignores the reset command even though it receives it. Do not reflash your slug if this occurs as it appears to flash incorrectly. Upslug can recover fromt this condition, but it would be better not to have it in the first place.

• Upslug now has support for multiple slugs (not tested)

• Better verification of proper parameters

Planned Implementations

• Support for multiple Slugs

As far as testing goes, I have succesfully uploaded Unslung 2.12 and 2.14 twice each using this tool. This should mean that it will work for most images, though there may be problems for people with custom redboots. This may not be the case though more testing will help to determine the completeness of the tools functionality.

As far as testing goes, I have succesfully uploaded Unslung 2.12 and 2.14 twice each using this tool. This should mean that it will work for most images, though there may be problems for people with custom redboots. This may not be the case though more testing will help to determine the completeness of the tools functionallity.

Feature Request:

Upslug download tool is now in alpha phase.

--reset resets the slug
--upload image_name.img uploads the firmware image to the slug, verifies the upload and then resets the slug.

Command Line Options:
--reset resets the slug
--upload image_name.img uploads the firmware image to the slug, verifies the upload and then resets the slug.

Upslug download tool is not in alpha phase.

--reset Will reset the box
--upload image_name.img Will upload that firmware to the box, verify the upload and then reset the box.

I will add more information here over the next couple of days.

Please post any issues that you have with this tool here:

--reset resets the slug
--upload image_name.img uploads the firmware image to the slug, verifies the upload and then resets the slug.

Upslug download tool is now in alpha phase.

--reset resets the box
--upload image_name.img uploads the firware specified to the slug, verifies the upload and then resets the slug.

--reset Will reset the box\\

Upslug download tool is not in alpha phase. The code can be found here:

http://cvs.sourceforge.net/viewcvs.py/nslu/upslug/upslug.c?view=markup

--reset Will reset the box --upload image_name.img Will upload that firmware to the box, verify the upload and then reset the box.

I will add more information here over the next couple of days.

The Upslug download tool is in a very early experimental development stage.

The current prototype can be found at:

http://cvs.sourceforge.net/viewcvs.py/nslu/upslug/upslug.c?view=markup

Please do not ask any questions about this tool. It is not even ready for alpha testing yet. Be patient.

http://cvs.sourceforge.net/viewcvs.py/nslu/upslug/upslug.c?view=markup