AEK-Rev-1-Hardware-Support-19a+

MATLAB and Simulink support for hardware components used in the Arduino Engineering Kit Rev 1

NOTE: This version of the file exchange is applicable to MATLAB release starting from R2019a.

• For MATLAB 2018b, use the file here - https://www.mathworks.com/matlabcentral/fileexchange/68620-arduino_engineering_kit_hardware_support_18b

• For MATLAB 2018a, use the file here - https://www.mathworks.com/matlabcentral/fileexchange/66568-arduino_engineering_kit_hardware_support

This package includes MATLAB and files that allow you to control and communicate with the sensors and actuators used in the Arduino Engineering Kit. The sensors and actuators are connected through the MKR Motor Carrier. The supported peripherals include:

• DC motor – control up to 4 DC motors simultaneously
• Servo motor – control up to 8 servo motors simultaneously
• Encoder – read up to 2 encoders simultaneously
• LiPo Battery – read the battery voltage

The project files for the Arduino Engineering Kit are included here –
• For AEK Rev 1: https://www.mathworks.com/matlabcentral/fileexchange/66569-arduino_engineering_kit_project_files
• For AEK Rev 2: https://www.mathworks.com/matlabcentral/fileexchange/80419-arduino_engineering_kit_project_files_rev_2

Learn more about the Arduino Engineering Kit at www.mathworks.com/arduino-kit

Important Notes:

1. The File Exchange submission can either be downloaded as a toolbox or a zip file.

a. If you choose to download the toolbox, complete its installation in MATLAB.

b. If you choose to download the AEK-Rev-1-Hardware-Support-19a+.zip file, extract the contents of this package to a local folder, and add it to the MATLAB path. To add the folder to the path in MATLAB, right-click the folder and select "Add to Path" > "Selected Folders and Subfolders" option.

For the hardware support package to work, an additional 3rd-party library “MKRMotorCarrier” (version 1.0.1) from Arduino is required along with the file exchange file.

If you are using MATLAB R2020a and above, the “MKRMotorCarrier” library is included in the MATLAB Support Package for Arduino Hardware. See step 6 for further instructions. If you are using MATLAB R2019a or R2019b, continue with steps 2 and 3.

2. Download the Arduino 3rd-party library zip file, for MKRMotorCarrier, from this link: https://github.com/arduino-libraries/MKRMotorCarrier/archive/1.0.1.zip

3. Extract this zip file into a local directory and rename the folder to "MKRMotorCarrier".

If you are using MATLAB R2019b, skip to step 5. If you are using MATLAB R2019a, then follow step 4.

4. Move the "MKRMotorCarrier" folder into the "libraries" folder inside your Arduino sketchbook folder.

a. On Windows, the default path is "Documents\Arduino\libraries\"
b. On Mac, the default path is "~/Documents/Arduino/libraries/"
c. On Linux, the default path is "/home/<username>/Arduino/libraries"

Once you move the libraries, the folder structure should be similar to:

d. On Windows "\Documents\Arduino\libraries\MKRMotorCarrier\src"
e. On Mac, "~/Documents/Arduino/libraries/MKRMotorCarrier/src"
f. On Linux, "/home/<username>/Arduino/libraries/MKRMotorCarrier/src"

If you are using MATLAB R2019a, skip to step 6.

5. Move the "MKRMotorCarrier" folder into the "libraries" folder inside your Arduino sketchbook folder:

a. On Windows, the default path is "<arduinoio.IDERoot>\portable\sketchbook\libraries\"
b. On Mac, the default path is "~/Documents/Arduino/libraries/"
c. On Linux, the default path is "<arduinoio.IDERoot>/portable/sketchbook/libraries/"

NOTE: "arduinoio.IDERoot" is a MATLAB command. Executing this command in the MATLAB Command Window returns the location of the Arduino IDE directory on your system.

Once you move the libraries, the folder structure should be similar to:

d. On Windows, "<arduinoio.IDERoot>\portable\sketchbook\libraries\MKRMotorCarrier\src"
e. On Mac, "~/Documents/Arduino/libraries/MKRMotorCarrier/src"
f. On Linux, "<arduinoio.IDERoot>/portable/sketchbook/libraries/MKRMotorCarrier/src"

For all releases of MATLAB.

6. Type "listArduinoLibraries" in the MATLAB Command Window. The resulting cell array should display {'Arduino/MKRMotorCarrier'} among others. If the MKRMotorCarrier library does not appear in the cell array, ensure the steps 4 and 5 are executed correctly.

NOTE: You can find these instructions in the "ArduinoKitHardwareSupportReadMe.txt" file. After installing the toolbox or extracting the contents of the AEK-Rev-1-Hardware-Support-19a+.zip file, type the following command in MATLAB to open the readme file:

>> edit ArduinoKitHardwareSupportReadMe.txt