How to upload a .hex to the Arduboy?

Pharap · 2017-09-21 20:46:05 UTC

In anticipation of everyone receiving their copy of Arduventure and suddenly realising they don’t know how to upload a .hex file to the Arduboy, I’m here to ask now:

Just how do you upload a .hex file to the Arduboy?

Summary of options:

Team ARG’s Arduboy Game Loader (Windows only, created by @TEAMarg, suggested by @Botisaurus)
Crait’s Arduboy Manager 2.0 (Windows only, created by @crait, suggested by @filmote)
avrdude + avr8 burn-o-mat (Windows, Mac & Linux (Java required), suggested by @mwm)
Eried’s Arduboy Uploader (Windows only, created by @eried, suggested by @eried)
avrdude (Windows, Mac & Linux, suggested by @mwm/@MLXXXp)
avrdude + Pharap’s batch scripts (Windows only, created by @Pharap)

Botisaurus · 2017-09-21 21:00:03 UTC

With the Arduboy Game Loader:
http://www.team-arg.com/agl-tool.html

Sadly, there is still no mac version

filmote · 2017-09-22 00:53:07 UTC

Yes … when is the Mac version coming along? I have clicked the Mac button on @crait’s page many times and although I find the popup funny, I really want to see a Mac version.

Pharap · 2017-09-22 01:07:42 UTC

Different program, that’s Team ARG’s thing rather than crait’s thing, but they both have the same problem - neither have a Mac or Linux version.

filmote · 2017-09-22 01:09:16 UTC

Right … I was thinking of Arduboy Manager which can also upload .hex files.

Pharap · 2017-09-22 01:15:20 UTC

Good suggestions so far, hopefully more will come (maybe someone knows of some Mac and Linux options).

I’ve decided to list them up top in case the list gets particularly long, so people don’t have to scroll through all the comments.

JO3RI · 2017-09-22 07:31:10 UTC

We’ll a provide .arduboy file not a .hex file. 95% will be windows, so those people can use a Game Loader. Mac (like myself) and Linux users. can upload on command line (and we’ll explain how to extract the .hex file). We’ll provide a step by step how to.

BUT we’re also still working on a macOS version of the Game Loader with mixed results. My team working on it isn’t used to develop for macOS, so it’s a long search (especially on serial connections).

And once and for all, after all backers have received their “paid for” version, we’ll release the source too.

mwm · 2017-09-22 15:37:52 UTC

Well, you can use avrdude on the mac. Or Windows, Linux, etc. The hard part is getting all the settings right, and recent versions understand “arduino” a a programmer type for programming arduinos, though the Arduino API doesn’t seem to leverage that. So getting the partno right (it’s atmega32u4) should do the trick.

There are also GUI front ends available for it that run on the Mac & Linux for those who are uncomfortable with the command line, The easiest to install seems to be Burn-O-Mat, as the others are Java or Mono zip files that require the appropriate incantations.

filmote · 2017-09-23 07:27:07 UTC

Thanks @mwm, I was unaware you could load a .hex file using avrdude. Is this something you use and if so could you document the process for the community?

Pharap · 2017-09-23 08:46:18 UTC

As @filmote said, do you have any idea what the right settings are?

I’ve attempted to use avrdude in the past with something along the lines of avrdude -p m32u4 -c arduino -P COM# -U flash:w:"file.hex":i but with no success (the command line just locked up, it would not even accept ctrl+z to cancel).

eried · 2017-09-23 09:01:14 UTC

Yes, in fact all uploaders use avrdude internally.

I always go to github and download the zip with the source, then wait few minutes for arduino, compile and fiddle around selecting the right port and… just kidding I always use my uploader of course

Pharap · 2017-09-23 09:14:37 UTC

Is it Windows only or does it do Mac & Linux too?

(Knowing you, I’m guessing it’s written in C# and thus needs Wine to run on Linux.)

eried · 2017-09-23 09:28:21 UTC

Yes, only Windows. And does not work on mono nor wine because depends on avrdude.exe, so no Linux/Mac

filmote · 2017-09-23 09:29:13 UTC

Makes sense … just never made the connection.

MLXXXp · 2017-09-23 11:05:30 UTC

If you upload a sketch using the Arduino IDE and set checkbox Show verbose output during: upload in the IDE preferences, somewhere in that output will be the avrdude command it uses, including the switches and options.

Pharap · 2017-09-23 13:39:19 UTC

avrdude works on Linux and Mac, so it’s possible it might work with mono/wine if they support whichever function you’re using to start avrdude.

I assume you’re using System.Diagnostics.Process.Start to run it?

Pharap · 2017-09-23 15:29:44 UTC

It seems it’s not quite that simple.

Aside from pulling both the avrdude executable and config file from %APPDATA%, it seems that before calling avrdude the IDE does something significant to the COM port that severs the Arduboy’s connection to that port and moves it along to the next free port in preparation for the avrdude upload.

Forcing reset using 1200bps open/close on port COM4
PORTS {COM4, } / {} => {}
PORTS {} / {COM5, } => {COM5, }
Found upload port: COM5

Attemping to use the same command the IDE claims to be using yields

avrdude: ser_open(): can’t open device “\.\COM5”: The system cannot find the file specified.

And attempting to replace COM5 with COM4 yields many

Connecting to programmer: .avrdude: butterfly_recv(): programmer is not responding

messages, until it eventually gives up.

eried · 2017-09-23 15:35:49 UTC

Maybe… never tried. All the steps are very clear in my uploader source. I am pretty sure most of them work in mono, but there is stuff that I do not know, for example how to handle the “arduboy:” links in other platforms

github.com

eried/ArduboyUploader/blob/master/src/ArduLoader/FormMain.cs#L112


        // Not a zip file
    }


    // Check the hex file (maximum size and extension just to be sure)
    if (!File.Exists(input) || Path.GetExtension(input).ToLower() != ".hex" ||
        Path.GetFileName(input).Contains(Settings.Default.PreventUploadIfFilenameContains) ||
        new FileInfo(input).Length > Settings.Default.MaximumHexFilesizeKB * 1024 ||
        !string.IsNullOrEmpty(Settings.Default.PreventUploadIfFileContains) && 
        Regex.IsMatch(File.ReadAllText(input),Settings.Default.PreventUploadIfFileContains))
        throw new Exception("Invalid hex file");


    hex = input;
}
catch (Exception)
{
    backgroundWorkerUploader.ReportProgress((int) UploadStatus.ErrorFile);
    return;
}


var s = Stopwatch.StartNew();

Pharap · 2017-09-23 15:50:11 UTC

Oh, you’re providing avrdude yourself?

github.com

eried/ArduboyUploader/blob/master/src/ArduLoader/FormMain.cs#L195


        Thread.Sleep(Resources.WaitSuccessMs);
        _cancelNow = true;
    }
    catch (Exception ex)
    {
        LogError("General error: " + ex.Message);
        backgroundWorkerUploader.ReportProgress((int) UploadStatus.ErrorTransfering);
    }
}


/// <summary>
///     Check and prepares AvrDude from embedded resources. Also sets Environment.CurrentDirectory
/// </summary>
private static void ExtractAvrDudeFromResources()
{
    var appPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
        Application.ProductName, Resources.ParamAvrDudeFolder);


    if (!Directory.Exists(appPath))
        Directory.CreateDirectory(appPath);

In that case you’d have to be able to detect the OS and provide the correct copy if you’re providing the executable.

If are allowing the user to provide the avrdude path rather than letting the program provide the executable then it should work (assuming wine/mono are implementing Process correctly).

Oh, but the ManagementObjectSearcher code won’t work…

Yeah, it would need to be changed to run with mono/wine.
It’s a shame, but it’s probably not worth the effort.

eried · 2017-09-23 15:57:13 UTC

Well, it is a resource just for convenience of having a single exe. For a mono version, avrdude could be required as a prerequisite.

But it just drills down to the low interest I have in mac stuff in general.