Abbott Analytical Products



Contents of Page

This web page contains working assumptions, detail discussion concerning software preparations, a collection of helpful images with comments, and an endnote detailing changes required to accommodate substitution of the Uno Arduino board.

Working Assumptions

At this point in the project we assume

1> That the user already has the speed gun hardware assembled with a USB connection to a PC (Ubuntu, Windows, Mac).
2> That the user has sufficient skill to search the Internet and download content.



Software Preparations

Ultrasonic Speed Gun Software Aspect of Project
There are at least two software approaches for this project. Both approaches use programs called IDE(integrated development environment). In the author's opinion there is the hard-way "Arduino IDE" and the not-so-hard-way "Sloeber: Arduino-Eclipse-Plugin". Below are two sets of links for obtaining the Arduino IDE and and one for the Sloeber IDE.


Suggested Integrated Development Environment (IDE):
--- Standard (Not Recommended by Author) ---
Basic Arduino IDE {Select Operating System}: https://www.arduino.cc/en/main/OldSoftwareReleases
Arduino Web Getting Started With Arduino: https://create.arduino.cc/projecthub/Arduino_Genu...

--- OR (Recommended) ---
Sloeber {Install Stable by Operating System}: http://eclipse.baeyens.it/installAdvice.shtml.
Sloeber Quick Start: https://eclipse.baeyens.it/how_to.shtml

Skill Necessary to Continue:
The Big Software Assumption is that the user can locate, download, install, and use the selected IDE. The user should practice a bit with the selected IDE by creating throw-away projects until the user is comfortable with the IDE. A user should not move forward with this project until the user has progressed pass the on-board LED blink stage. {See https://create.arduino.cc/projecthub/rafu/internal-led-blink-c7ec4b for a basic blinking on-board LED skill demonstration.}

Once that point has been reached the likelihood of successfully completing the project increase greatly.

On a Global Project Level
The user should now perform the tasks listed below. The details for performing these tasks are provided in the remainded of this page.
Create a new Project (also called a Arduino sketch project container within the
selected IDE.
Acquire, install, include/add the libraries as identified further below to the
IDE and project as described further below.
Acquire the source files bundle, a031_speed_gun_004-master.zip
(*.ino, *.h) and add those entities to the project as described further below.


Common Software Entities for Either Approach:
Both approaches rely upon a collection of libraries, source files, and critical USB-Arduino board setup values. The source files are commonly called header files and sketch files.

Libraries Common to Both Approaches:
A collection of libraries is required to execute this project. The each required libraries (or suitable substitutes) must be must be available from within the selected IDE before the project will successfully execute.

Next install the Required Libraries as library components from the zip file or download them from the Internet. The user will need to create an appropriate new Project or Arduino sketch project container. The user will then need to create the linkage between the required libraries suitable for the users environment.

A list of required libraries and links to their suggested download sources is given further below. The exact sequence of actions required to install is the same for both IDE-s. These required libraries need to be placed in the ..../Arduino/libraries folder. That folder location will vary from user to user depending the installation of Arduino employed by the user. But the typical locations are provided further below along with a tutorial from SparkFun regarding installation for Windows and Mac environments. Finally the the further assistance for including the required libraries in the project is also given further below.


List of Required Libraries and Suggested Download Sources:
Grove_LCD_Backlight:
https://github.com/Seeed-Studio/Grove_LCD_RGB_Backlight/archive/master.zip
SoftwareSerial
https://www.arduino.cc/en/Reference/softwareSerial
Note this library is called NewSoftwareSerial but loads as #include SoftwareSerial
TimeFreeTone_V1.5.zip Arduino library
https://bitbucket.org/teckel12/arduino-timer-free-tone/wiki/Home
Wire
https://www.arduino.cc/en/reference/libraries
Wire library is bundled with Arduino AVR Boards.
aapMbot
https://github.com/trooker/aapMbot

Typical Arduino Library Folder Location:

Helpful How-to for Installing Libraries:
https://learn.sparkfun.com/tutorials/installing-an...


Making the Libraries Available to Our Project:

Just when you think it is safe to go into the water, there is another step needed to make the libraries available to Ultrasonic Speed Gun project (formally called a031_speed_gun_004). For the Arduino IDE the task is call "including". For the Sloeber IDE the task is call "adding".

Including Libraries Arduino IDE
https://www.arduino.cc/en/guide/libraries
Adding libraries to Sloeber projects.
https://eclipse.baeyens.it/how_to.shtml#/lib

Source Files Common to Both Approaches:
The source files are commonly called header files and sketch files. The source files associated with this Instructable can be downloaded from the GITHUB: https://github.com/trooker/a031_speed_gun_004. The source files will arrive as a zip package a031_speed_gun_004-master.zip. Once the content of this bundle has been extracted they can be directly file copied into the project folder. Then the project needs to be refreshed or restarted depending upon the IDE selected to have sources file reflected in the project.

Registering Critical Values Common to Approaches:

Both approaches also demand that a specific set of values be registered with the IDE of choice, Arduino IDE or Sloeber IDE. That set of values insures proper USB connectivity to user's Arduino board.

Serial Port Connection (such as /dev/ttyACM0 or /dev/ttyUSB0)
Baud Rate of the Connection (typically 9600)
Arduino board type (Mega256 or Uno)


Helpful Images

Link Comment
Fresh Sloeber workbench A newly created Sloeber IDE workspace awaiting the user's inputs.
Create New Project Image displays annotation for creating a new project/sketch.
Board type and port Sloeber IDE Both the Sloeber IDE and Arduino IDE require that the board type and USB port be defined in the project properties.
Board type Arduino IDE Arduino IDE board type definition.
Port specification Arduino IDE Arduino IDE USB port definition.
Adding Software Components The project software components copied from the project code bundle.
Detail: Create project resource files Create a container for the new project resource file.
Detail: Rename file Provide the proper *.ino or *.h file name for the project component.
Required Libraries Libraries necessary to compile the project as shown from the Sloeber IDE. These must be loaded to the project after downloading.

For Sloeber IDE
Adding libraries
First two
Last three
For Arduino IDE
Including libraries
Set Libraries to select
Download and install library to system Arduino folder.
Then "add" for the Sloeber IDE project.



-OR-
Then "include" for the Arduino IDE project.
Project Components Loaded to Sloeber Various software components loaded to the project and ready for verification/uploading. Observe that the a031_speed_gun_004.ino file content is displayed with the comment section compressed and early definitions displayed.
Open Serial Communication Sloeber IDE Prior to uploading the program to the Arduino board, solid USB communication must be established between the IDE and the board. For Sloeber this is done by adding a new connection while in the "Serial monitor view" tabsheet.
Open Serial Communication Ardurino IDE To start the Serial Monitor select it from the Tools menu.
Common buttons Both IDE's have a verify and an upload button.
Successful verify operation A successful verify results in a notification that the build finished with zero errors.
Upload program to Arduino board Given that the USB connection has been setup, a proper upload should result in a message that the avrdude is done.
Upload begins a cycle If the upload is successful and the "serial monitor view" is active then that tab should reflect message similar as shown. It it fails the message will not show






Page End Notes:

1> Substituing Uno Arduino Board
The default Arduino board type for this project is Mega256. If the Arduino Uno board type is used two changes will be required. First the aapMbot.aapBase.h will need to have the Arduino board type change in this header file. The second place will be in the Arduino IDE or the Sloeber IDE. Both the Arduino IDE and Sloeber IDE require this change in the project specification phase.
Link Comment
For Uno Arduino boards Shows the two significant changes that must be made to the aapBase.h header file. Then the default board type must be changed for the project within the IDE from mega256 to Uno.
2> Substituting Trigger and Echo Pins Ultrasonic Sensors
The default ultrasonic sensor type for this project is a sensor which has one pin for both the trigger and echo signal. The a031_speed_gun_004.ino will need to be changed to use a sensor with separate pins for triggering and echo signals.
Link Comment
Single Signal Pin Typical trigger/echo single pin Ultrasonic sensor
Separate Signal Pins Typical Ultrasonic sensor with separate trigger and echo pins.
Separate Pins/Signals Definitons Switch the trigPin identifier to 2 and uncomment the echoPin identifier line.
Separate Pins/Signal Pin Modes The pin mode and duration for the echo signal must be uncommented. The trigger durration must be commented-out.










NOTICE: This site was fabricated for best viewing using Netscape 4.x, or a functionally equivalent browser.


Please send comments or questions using e-mail, voice telephone at 919-846-7705. (Last update: Feb 25, 2020 tar)