diff --git a/README.md b/README.md index 1956e54..05097a6 100644 --- a/README.md +++ b/README.md @@ -39,13 +39,26 @@ > this version of the IDE was released in Dec 2021 and will likely not > see another version bump. -> Click *Install* > *Authenticate*. Once it is done installing, click -> Open. You will be notified that without access to the `dialout` -> group, your user will not be able to control serial devices in order -> to flash Arduino boards, and will give you some instructions for how -> to change that permission, including a reboot step. I am going to -> ignore that for now, but you should take time to follow those steps -> at this point. +> Click *Install* > *Authenticate*. First-time installation will take +> a minute -- it is finished when the "Install" button turns into the +> "Open" button. + +> Once it is done installing, click Open. You will be notified that +> without access to the `dialout` group, your user will not be able to +> control serial devices in order to flash Arduino boards, and will +> give you some instructions for how to change that permission, +> including a reboot step. + +> I am going to ignore that for now, but you should take time to +> follow those steps at this point. If you do not, you will probably +> have trouble interacting with the Arduino board at the heart of +> LiBCM. + +### Transition + +> Next, I am going to show you how to follow the same steps on +> Fedora. Ubuntu users should feel free to skip a few minutes ahead to +> see the LiBCM code-download compilation process. ## Installing the Arduino IDE: Fedora @@ -59,9 +72,10 @@ (Open terminal and show this) -> ... You will encounter a similar prompt as with the Ubuntu -> installation process, instructing you on how you can add your user -> to the dialout secondary group. Do so. +> If you watched the Ubuntu install steps, you will encounter a +> similar prompt as you did on the Ubuntu installation process, +> instructing you on how you can add your user to the dialout +> secondary group. Do so. ## Bonus: Compilation @@ -73,7 +87,7 @@ > instructions for use by the general public. However, since this > video was made in response to difficulties by LiBCM users to use > Linux to install LiBCM firmware updates, I am also going to show you -> how to compile and update LiBCM. +> how to compile (but not update) LiBCM. > To download the code, go to > https://github.com/doppelhub/Honda_Insight_LiBCM. This URL is @@ -107,18 +121,24 @@ > select "Arduino Mega or Mega 2560". > Finally, to test compilation, hit the check-mark in the -> top-left. As compilation proceeds, you may see warnings in the -> output, but you can tell whether the compilation succeeded by -> checking whether the compiler reports the ultimate size of the -> sketch's program storage space and dynamic memory: +> top-left. + +(Resize console window) + +> As compilation proceeds, you may see warnings in the output, but you +> can tell whether the compilation succeeded by checking whether the +> compiler reports the ultimate size of the sketch's program storage +> space and dynamic memory: > "Sketch uses 40062 bytes (15%) of program storage space" ... -> ... and so on. At this point, so long as LiBCM is connected to your -> computer via its black USB cable, connected to the Arduino IDE in -> the Tools > Ports option, and as long as your system user is allowed -> to use `dialout` group resources, firmware installation will -> succeed, unless something has gone seriously wrong with LiBCM. +> ... and so on. Once you reach this point, you are well-prepared to +> install the LiBCM firmware to the board. So long as LiBCM is +> connected to your computer via its black USB cable, linked to the +> Arduino IDE in the Tools > Ports option, and as long as your system +> user is allowed to use `dialout` group resources, firmware +> installation should succeed, unless something has gone seriously +> wrong with LiBCM. ## Future