Skip to content

Commit c4d4d89

Browse files
author
jantje
committed
#853 made very clear only the latest product is supported
Also updated the os specific pages.
1 parent f9542cb commit c4d4d89

File tree

5 files changed

+53
-13
lines changed

5 files changed

+53
-13
lines changed

‎website/WebContent/fragments/install_advice/all_os.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
All os'es
22
==
3+
**Do not use spaces in your paths.**
4+
Not in your install path.
5+
Not in your workspace path.
6+
This counts for all os's and is a make limitation (make is the tool cdt uses to build your project).
37

4-
**Wierdly enough all info is for older versions**
8+
**Wierdly enough all other info is for older versions of Sloeber**
59

610
Arduino IDE **1.5.2** beta and **1.5.4** beta are **not supported** due to a change in the library system.
711

‎website/WebContent/fragments/install_advice/intro.md

Lines changed: 29 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,38 @@ DON'T PANIC*
22
========
33
On the right you can see the steps needed to decide on what best fits your needs when running the Arduino Eclipse IDE.
44

5-
But if you panic take the 32 bit product for your platform.
5+
First do this
6+
==
7+
>Realize that only issues that do not exist in the arduino IDE and that can be reproduced in the latest product version are valid Sloeber issues.
68
7-
The first thing to do is decide on V1 versus V2 V3 or V4 (take V4) and plugin versus product.
9+
So take the latest 32/64 bit product version for your platform.
10+
In human language:
11+
* Take the product and not the plugin.
12+
* Take the latest stable version.
13+
* Read your OS specific info linked on thispage at the right.
14+
15+
This way you have something that gives you the best shot at being able to compile and upload to standard Arduino boards. And get support if you fail. Once you have the hang of this you can try to be more adventurous and take more exotic (read less tested) boards.
16+
Once you have all of this in your fingers you could consider to move to more exotic setups (like installing the plugin in a existing eclipse) but note that if you do so you are more on your own.
17+
18+
When you hit a problem we will ask you to
19+
==
20+
* Do the steps in "First do this" if you havn't done that yet.
21+
* Upgrade to the nightly.
22+
23+
We do not advice newcommers to start with the nightly. This because the nightly has not been tested and fluctuates in quality.
24+
However, as developers we have a pretty good idea of the quality and changes of the code of the "current nightly". So in many cases we know issues have been fixed and we test your case before giving the advice to go to the nightly.
25+
So "upgrade to the nightly" is not a general advice. Basically it means: backup your current install and upgrade to the nightly today. Because the nightly tomorrow may be ... well we do not know.
26+
27+
28+
29+
Then as an advanced user you could do this (but we do not advice it)
30+
==
31+
When going for the more exotic installation:
32+
33+
The first thing to do is decide on V1 versus V2 V3 or V4 (take V4 as this is the only one we support) and plugin versus product.
834

935
Then you decide on the actual version of eclipse, Arduino eclipse IDE and Arduino IDE.
1036

11-
Then look at the OS specific info and reevaluate your decision.
37+
1238

1339
>*It is said that despite its many glaring (and occasionally fatal) inaccuracies, the Hitchhiker's Guide to the Galaxy itself has outsold the Encyclopedia Galactica because it is slightly cheaper, and because it has the words "DON'T PANIC" in large, friendly letters on the cover.

‎website/WebContent/fragments/install_advice/linux.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,22 @@
11
Linux
22
===
3-
**Support status**
3+
**Support status**
44
Jantjes development environment used to be a Linux. He still has the machine so it is a good supported OS.
5+
Also the build servers we use (jekins and travis) are linux servers. As part of the build projects are created and compiled.
56

67
**However some tips may come in handy:**
78

8-
If things are not working out for you;
9+
My Linux comes with make in the path. I have not yet heard of someone having the make issue on Linux. If you do experience the make issue on a Linux flavor please contact me.
10+
11+
I never got the Leonardo nor the yun to be recognized on my Linux system. As a result upload issues with these boards have been reported on Linux. The problem seems to be a timing issues in the reset. It seems to work for most people.
12+
If it doesn't you are back to pressing and releasing the reset button for the leonardo.
13+
For the yun use the web upload.
14+
15+
**for older versions**
16+
17+
If things are not working out for you;
918
When using V1 or V2: install the Arduino IDE from arduino.cc and not from your package provider. In the past some package providers have not strictly adhered to the arduino folder layout which is important for the plugin.
1019

1120
V1 suffers from "serial port blindness". See the FAQ [On Linux I have no serial ports available.](http://eclipse.baeyens.it/rlogiacco/faq.shtml#/troubleshooting) on the faq to see how to fix this. This issue has been solved in V2.
1221

13-
My Linux comes with make in the path. I have not yet heard of someone having the make issue on Linux. If you do experience the make issue on a Linux flavor please contact me.
1422

15-
I never got the Leonardo nor the yun to be recognized on my Linux system. As a result upload issues with these boards have been reported on Linux. The problem seems to be a timing issues in the reset. It seems to work for most people.
16-
If it doesn't you are back to pressing and releasing the reset button for the leonardo.
17-
For the yun use the web upload.
18-

‎website/WebContent/fragments/install_advice/mac.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,16 @@ Mac
22
==
33
**Support status**
44
There are some mac fans using Sloeber. Mac support has grown over the years with input of mac users. The latest version should be as Mac like as eclipse can be.
5+
We even have a mac contributor now.[Maarten](https://github.com/mjmeijer)
6+
57

68
**Here are some mac specific issues:**
79

8-
[Mac has implemented some rules for download safety that may affect you. Do not launch from the download location.](http://lapcatsoftware.com/articles/app-translocation.html)
10+
Mac has implemented some rules for download safety that will affect you. [Do not launch from the download location.](http://lapcatsoftware.com/articles/app-translocation.html)
911

12+
**some issues in older versions**
1013

11-
[the error "serial port is in use" when uploading](http://eclipse.baeyens.it/rlogiacco/faq.shtml#/troubleshooting) should no longer exists from version 2.4 (not yet released at the time of writing) onwards.
14+
[the error "serial port is in use" when uploading](http://eclipse.baeyens.it/rlogiacco/faq.shtml#/troubleshooting) should no longer exists from version 2.4 onwards.
1215

1316
In the 1.5 series there has been a change in the folder structure on mac from arduino IDE 1.5.7 onwards. See [this issue](https://github.com/jantje/arduino-eclipse-plugin/pull/180) for more detail.
1417

‎website/WebContent/fragments/install_advice/windows.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
Windows
22
===
3+
**Support status**
4+
Jantjes development machine is a windows machine.
5+
36
**unzip**
47
The down-loaded file for the product is a tar file. On windows you can uncompress and unzip it with 7Zip. You need to use 7zip two times.
58

0 commit comments

Comments
 (0)