Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BOUNTY: Docker image for Particle Cloud #32

Open
digistump opened this issue Feb 11, 2016 · 31 comments
Open

BOUNTY: Docker image for Particle Cloud #32

digistump opened this issue Feb 11, 2016 · 31 comments
Labels

Comments

@digistump
Copy link
Collaborator

Skills Required: Intermediate Docker/Linux Skills, some familiarity with PlatformIO a plus
Difficulty: Easy to Moderate

Challenges/Thoughts:

The Particle Web IDE uses compilers in the cloud to build sketches. The compilers run from Docker images for each platform that take an input folder (sketch and libraries) and output a .bin file for the cloud to upload to the device. They also output a log file.

The Particle devices (Photon and Core) use this environment with a custom preprocessor and make files to compile. The Oak uses an Arduino compatible core setup and so it can instead use PlatformIO to do the compiling from the command line and handle preprocessing.

Fork https://github.com/spark/buildpack-hal (or whichever image seems correct for this) and modify so that it:

  • Downloads and installs PlatformIO and ESP8266 support.
  • Downloads the latest OakCore release (its OK if this URL needs to be manually modified in the Docker file when a new release occurs) and installs the core into PlatformIO
  • Takes inputs and include libraries and places output and log files per the Particle specs for this/matching the other Particle Docker files.
  • Test and provide instructions to test.
  • Be available to debug based on feedback from Particle

Bounty

$100 cash or $200 credit or 20 Oaks

If you are sure you can do this, and able to do this quickly - please feel free to respond to this issue and say that you are working on it and when you will complete it, so that others don't waste their time on it. If you are just entertaining the idea/unsure if you can do it, please don't "claim" it until you are sure.

Cash or credit is your choice. Cash to be paid via Paypal. Credit has no expiration but can only be applied to a single order and does not cover shipping (because that is how our shopping cart works, not because we want to be limiting). Oaks reward includes shipping.

You may credit yourself in the files as well, leaving in tact existing licenses and credits.

Legal Stuff: We will choose a winner at our sole discretion. The winner will be the first pull request that submits fully working code meeting the above requirements and following good coding practices, based on the timestamp of the pull request. Bounty will be awarded (or in the case of Oaks, sent) within 48 hours of confirming winner. Cash awards will be made in USD. This is not an offer for hire. All work submitted becomes the property of Digistump LLC to be used at our discretion in compliance with any associated licenses. Void where prohibited by law.

@usmanatron
Copy link
Member

Im pretty sure I can do this so I'm going to have a go. I'm aiming to finish by the end of Wednesday but I'll post an update with how it goes :-)

@paulscott56
Copy link

I'll give it a shot too. Hopefully I will be able to do it over the weekend

@usmanatron
Copy link
Member

Hi guys,
Quick update - I've got PlatformIO installed and I'm DLing the latest OakCore release. I haven't yet installed this into PlatformIO (don't know much about PlatformIO so trying to work it out as I go!)

Still hoping to get it done in the next couple of days :-)

@paulscott56
Copy link

Nice! Let me know if I can help. I wasn't able to get free time to do much
here myself....

-- Paul

On Mon, 15 Feb 2016, 01:36 Usman Iqbal notifications@github.com wrote:

Hi guys,
Quick update - I've got PlatformIO installed and I'm DLing the latest
OakCore release. I haven't yet installed this into PlatformIO (don't know
much about PlatformIO so trying to work it out as I go!)

Still hoping to get it done in the next couple of days :-)


Reply to this email directly or view it on GitHub
#32 (comment).

@usmanatron
Copy link
Member

@paulscott56 , thanks very much for the offer! I'm definitely keen for some help with testing once complete; I haven't used PlatformIO before so it'd be good to confirm it's building something useful!

@digistump , I have a question about the spec. I've installed PlatformIO with ESP8266 support; within that it gives me a number of boards to choose from. Should I be using one of them (which one?) or do I need to create a custom board for the Oak? (I couldn't find anything directly applicable in the latest release code).
If I need to specify my own board and write the config, can you please point me in the direction of the oak specs? Thanks

@digistump
Copy link
Collaborator Author

@usmanatron - the Oak files should be copied in where the ESP8266 files reside, and I think that should allow PlatformIO to support it and show the Oak as a board, its a completely separate core, the reason for installing the ESP files first is to get the support files like the compilers - it may take some tweaking for paths to match and such

@usmanatron
Copy link
Member

@digistump , thanks for the clarification - that makes sense. I'm at the point where I have a container with everything installed, so I can just attach to the container and hack away until the paths agree :-).

I should have loads of time this weekend to get it done, fingers crossed!

@usmanatron
Copy link
Member

Hi guys,

Good news: I think I've got it working! Though not using PlatformIO...
After looking very carefully at he PlatformIO docs and at what you get after installing the espressif \ ESP8266 platform, I'm pretty convinced that this isn't going to just work without chopping and changing loads of things (in such a way as to make it vy. hard to maintain \ brittle).

I can see that the structure of OakCore closely matches that of the esp8266/Arduino repo, so I've used build instructions for that and ended up using make. I'm at the point where I can actually build a binary! (though I haven't tested it actually works on flashing).

My next job is to write this all up into the Dockerfile and commit. After that I'll get my Oak setup and start testing. I hope using this alternative approach isn't a problem :-)

Usman

@digistump
Copy link
Collaborator Author

@usmanatron - that sounds like a much superior approach! thanks for working at this!

@usmanatron
Copy link
Member

@digistump - sorry this has taken so long (work takes up all my time on the weekdays...)

I've managed to put everything together and I have a working prototype! The latest version is available here: https://github.com/usmanatron/buildpack-oak/tree/OakCore-32. When you start the container (see below), it builds the firmware and dumps it into /output with the logs.

At this point, I'd be grateful if you could test the image and the firmware it spits out; I still haven't setup my oak and, more importantly, you'll have a lot more experience using it than me! One important limitation though - the input ino file needs to be named sketch.ino.

I'm planning to fix this along with moving the intermediary files from /output to /cache (Ill possibly do these after this issue is done as they're arguably less of a problem)

Finally, these are the Docker commands I ran to get it working. They'll need updating but otherwise it should "Just Work" (famous last words?!)
Build: docker build --tag=test_auto_wp .
Run: docker run -i -t -v /home/usmanatron/Documents/projects/buildpack-oak-volumes/input:/input -v /home/usmanatron/Documents/projects/buildpack-oak-volumes/output:/output --name test_auto_wp test_auto_wp

If you have any questions \ it doesn't work please let me know!
Usman :-)

@usmanatron
Copy link
Member

Good evening @digistump,
I've done the majority of my testing now; as part of this I removed all of my old Docker images and built the image from scratch - all went fine. I've also run the image using a slightly different command to what I gave above (essentially "-d" instead of "-i -t" and renamed the images):

docker build --tag=oak .
docker run -d -v /home/usmanatron/Documents/projects/buildpack-oak-volumes/input:/input -v /home/usmanatron/Documents/projects/buildpack-oak-volumes/output:/output --name oak_runner

This has given me a firmware file which Im now attempting to flash via the Arduino IDE (which I need to install etc.). I'll get back to you regarding how this goes. In the meantime, I'm happy enough with the status of everything to put up a pull request: digistump/buildpack-oak#1

Note that you need to update the Dockerfile for each successive release (the Url and the folder name). Maybe we can fix this when the dust has settled :-)

If you have any questions with how anything has been implemented, please let me know!
Usman

@digistump
Copy link
Collaborator Author

@usmanatron - This is awesome! I apologize for the delay in getting back to you on this. This setup looks great and I'll test and have Particle test ASAP. Please send me an email at support@digistump.com to claim the bounty (and let me know which form you want it in).

As soon as I test I'll get back to you about any changes, but the requirement to update the dockerfile for new releases is fine as they must be manually pushed to Particle anyway.

@digistump
Copy link
Collaborator Author

Usman - as mentioned in my email, Particle had some feedback about this -

Basically the key thing is - they aren't using the buildpacks for their build farm right now, not sure how I came to understand they are, but basically they haven't implemented docker within their build farm yet to run images like this. This of course led me to make sure I understand how the build farm works right now vs how it is documented to work and here is what I found:

Their build servers can be 32 or 64 bit Ubuntu - they do the following:

Run the pre-processor
Check out the firmware repo - for Particle this is: github.com/spark/firmware
Set the environment vars the makefile uses for where things are
Run the makefile
Copy the output bin file and upload it to the device
The GCC toolchain for their products is already on the servers

So what the Oak needs to have is -

A repo with a Makefile that uses the same environment vars as theirs (except where it relates to toolchain, which could be hardcoded) and takes input and outputs to the same places as theirs.
A init script that installs the right toolchain in the right place, and anything else needed for said makefile to work.

I think mostly this means unpackaging your work here and repackaging it into these parts - and probably tweaking the makefile a bit.

Is this something you'd be interested in doing/helping with?

I apologize I so profoundly misunderstood what they needed for their build farm, not sure where the wires got crossed other than their github certainly suggesting the docker way was the current way.

Thanks again for your work on this, if you'd like to continue to help with this I'd be happy to offer you more free stuff, and if not no problem I'm sure I can personally shape it into what it needs to be or offer it up as another bounty.

Thanks,
Erik

@usmanatron
Copy link
Member

Hi @digistump,

Thanks for the feedback and explanation. That's unfortunate, but at least it sounds like everything we've done so far has been directly useful :-)

I'm more than happy to get involved again and re-package the components to fit the new setup. In order to do this efficiently though, it would be good to get more information on their setup (e.g. what exactly their toolchain looks like, what env. variables they use etc.). Ideally, Id like to get a VM image of one of their build servers so I can see where things are \ how it's currently setup and get it right the first time! Do you think that's possible? (Feel free to pass my details along to Particle if that helps)

Thanks
Usman

@digistump
Copy link
Collaborator Author

Usman,

I've asked Particle for as much of info as they can give us, or an image, I'll let you know when I hear back - thanks for being willing to get involved again!

Thanks,
Erik

@sacbhale
Copy link

sacbhale commented Apr 6, 2016

@digistump
Is there progress on this?
I bought the oak because of the promise of being able to use particle cloud. And that includes their dev tools.
I am not a kickstarter backer. But i keep an eye on the comments section and I see You have been very silent since the release of 1.0 firmware. I know that was step 0 but what about the rest.
Updates and ETA (even if you end up pushing it out) would be good here.

@digistump
Copy link
Collaborator Author

No real update or ETA - we are entirely waiting on Particle at this point
to tell us the environment variables that are set for the Oak makefile to
know how to interact with the filesystem of their build farm. I wish that
wasn't the case, and I continue to check in with them for progress on
giving us even a little documentation so that we can try to finish this,
but that is all I can do right now. Certainly had we not been left to
believe that the docker system was already in use we would have pursued
this much earlier on, I'll continue to pursue it with them until it happens.

On Wed, Apr 6, 2016 at 1:25 PM, sacbhale notifications@github.com wrote:

@digistump https://github.com/digistump
Is there progress on this?
I bought the oak because of the promise of being able to use particle
cloud. And that includes their dev tools.
I am not a kickstarter backer. But i keep an eye on the comments section
and I see You have been very silent since the release of 1.0 firmware. I
know that was step 0 but what about the rest.
Updates and ETA (even if you end up pushing it out) would be good here.


You are receiving this because you were mentioned.
Reply to this email directly or view it on GitHub
#32 (comment)

@usmanatron
Copy link
Member

Hi @digistump
Any news? As noted before, I'm happy to pick up liaising with Particle if that will help; just let me know :-)

Cheers
Usman

@digistump
Copy link
Collaborator Author

Particle has said they will have clear instructions to set it all up by May
13th - as soon as they have those I will pass them along, and if needed
connect you with them via Slack.

Thanks for still being willing to work on this!
Erik

On Sat, Apr 30, 2016 at 6:12 AM, Usman Iqbal notifications@github.com
wrote:

Hi @digistump https://github.com/digistump
Any news? As noted before, I'm happy to pick up liaising with Particle if
that will help; just let me know :-)

Cheers
Usman


You are receiving this because you were mentioned.
Reply to this email directly or view it on GitHub
#32 (comment)

@usmanatron
Copy link
Member

Hi @digistump
I received your latest Kickstarter update yesterday. From that, it sounds like we don't need to rewrite this after all?
I just wanted to confirm that's the case. Do let me know if the deadlines change as well; I'm going to try and make myself available over early July to help with anything.

Thanks
Usman

@digistump
Copy link
Collaborator Author

Yes that is correct - Particle has decided to move forward with the Docker
based build farm and use the Oak as the first platform on it, so if
everything goes well nothing will need to be rewritten. I'm sure they might
request a few tweaks - so I appreciate you still being willing to work on
it! I will let you know if they change the deadline, but I double confirmed
it with their team before the last update, and so far they were on track to
hit it.

Thanks!
Erik

On Fri, Jun 10, 2016 at 4:53 AM, Usman Iqbal notifications@github.com
wrote:

Hi @digistump https://github.com/digistump
I received your latest Kickstarter update yesterday. From that, it sounds
like we don't need to rewrite this after all?
I just wanted to confirm that's the case. Do let me know if the deadlines
change as well; I'm going to try and make myself available over early July
to help with anything.

Thanks
Usman


You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
#32 (comment),
or mute the thread
https://github.com/notifications/unsubscribe/ABcbTxouFG09tvY8eHX1C7O4hLL8Nd4nks5qKVBAgaJpZM4HXyzi
.

@sacbhale
Copy link

Has this been implemented?

@sacbhale
Copy link

bump

@emardee
Copy link

emardee commented Sep 29, 2016

@usmanatron @digistump Apparently Particle recently fixed a problem at their end with the Particle IDE stuff and are ready to work with you guys on getting Oaks working for online IDE flashing.

Currently it appears that Particle IDE is actually offering to flash Oak devices online with firmware v1.0.5 (which sounded promising), but those who have tested it report that it bricks the Oak causing it to need a serial restore.

Reading back through this thread I see that there was previously a requirement on the docker build system developed by @usmanatron that required the input sketch to be named sketch.ino and wondered if that was still a requirement and could be the cause of the problems? Equally it could be something much more complex at fault.

It sounds like things are getting really close though, and I'm getting very excited by the Oaks getting Particle Build IDE. Hoping you guys can liaise with Particle and make some dreams come true.

@usmanatron
Copy link
Member

Hi @emardee ,
Thanks for the link :-). We're currently in discussion with Particle and we have some actions on our side to do some more testing ( @digistump has made some changes which hopefully fix it). Finding time is hard (we both work Mon - Fri) but we definitely haven't forgotten!

With any luck I'll have a chance to try this over the weekend. I'll try to keep this thread updated with progress.
Usman

@pfeerick
Copy link
Contributor

pfeerick commented Sep 29, 2016

@usmanatron Thanks for the update. Glad to hear you guys are on the case... hopefully not much further to go! @emardee Looks like we were both thinking the same thing... I just hopped on to post a comment also! :D

@emardee
Copy link

emardee commented Sep 29, 2016

@usmanatron Glad to hear the news.... if you need anyone to rest it, I'm sure @pfeerick could be useful... as I understand it, he's bricked and serial-restored his Oak devices so many times, he can do it in his sleep! So he might be a fearless tester to have on your side.... (me less so unfortunately, but I can make encouraging noises from the sideline!)

Hope you find some time soon.

Thanks for all the hard work.

@pfeerick
Copy link
Contributor

lol... so much so that I decided to try this was as good a reason as any to learn how to use docker, so built and ran the docker config from https://github.com/digistump/buildpack-oak. I set it up for 1.0.5, but it seems to be making firmware files about 25k bigger than the equivalent arduino install is on windows, so I'll have to compare it with the linux install to see if that is a anomaly or not. I bricked the test subject again though... so I suppose that's something?

@emardee
Copy link

emardee commented Oct 7, 2016

Don't forget to ask if you need any help... or encouragement... or both!

@haakonnessjoen
Copy link

Ok,

So if I flash my Oak from the Particle Build interface. It works great now. Does that mean that it uses the Docker image?

If so, it works great, except: it doesn't seem to include a -Ilib/ in the compile options, because if I try to include libraries, it says:
image

So it seems like the library is put in lib/, but that the compiler doesn't search lib/ for headers.

@pfeerick
Copy link
Contributor

Yeah, I'm pretty sure that is the case... it took a while but particle finally rolled it out. There is a possibility that this broke because they changed a load of stuff recent in relation to library include and management... but there has always been an issue with library includes on this docker image... some libraries worked just fine... but not others.

I get that same output if I add the HttpClient library to a simple sketch like the led blinky view the Particle Build library manager (and basically the same message if I just add the include line without 'installing' the library). Interestingly enough, I get an completely different error if I add it on the Arduino IDE and compile for the Oak - xtensa-lx106-elf-gcc: error: libraries\Bridge\Bridge.a: No such file or directory. Then again, this dufus didn't have the HttpClient library installed, so the poor arduino builder was trying to use the wrong library (probably for the Yun), and it was failing big time. Installed the library, compiled fine on the Arduino IDE for Oak when merely 'included'. Have to dig deeper into the docker image.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

6 participants