Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
dmc-60c:getting-started [2018/06/29 19:01]
Thomas Kappenman
dmc-60c:getting-started [2019/01/07 20:29] (current)
Thomas Kappenman [5. Running the example project]
Line 1: Line 1:
-====== ​Setting up FRC Driver Station ​======+====== ​Getting Started with the DMC60C ​======
  
-This guide will provide a step by step guide of setting up the FRC Driver Station environment ​for use in FRC Competitions.+This guide will provide a step by step guide of setting up the DMC60C API and configuration utility, as well as the FRC Driver Station environment.
  
 ----- -----
Line 11: Line 11:
     * USB Cable or Ethernet cable to plug it in.     * USB Cable or Ethernet cable to plug it in.
   * **DMC60C**   * **DMC60C**
-  * **USB Gamepad** (Optional)+  * **USB Gamepad** (For example projects)
  
 ===Software=== ===Software===
-  * **Labview FRC 2017**  +  * **Labview ​2019 FRC Edition** (if using Labview) 
-    * [[http://www.ni.com/download/​labview-for-frc-17.0/​7185/​en/​]] +    * [[https://wpilib.screenstepslive.com/s/​currentCS/​m/labview/​l/​1027501-installing-labview-for-frc-2019-labview-only|Follow Tutorial Here]] 
-  * **Labview ​FRC Update Suite** +  * **FRC Update Suite** 
-    * [[http://www.ni.com/download/first-robotics-software-2017/7183/en/]] +    * [[https://wpilib.screenstepslive.com/s/currentCS/m/cpp/l/​1027499-installing-the-frc-update-suite-all-languages|Follow Tutorial Here]] 
-  * **Eclipse** for C++ and Java development +  * **WPILIB Suite with VS Code installed** 
-    * [[https://wpilib.screenstepslive.com/s/currentCS/m/​cpp/​l/​145002-installing-eclipse-c-java|Follow this tutorial]]+    * [[https://github.com/wpilibsuite/allwpilib/releases]]
   * **DMC60C API**   * **DMC60C API**
-    * [[https://git.digilentinc.com/tom21091/DMC60C_API]]+    * [[https://github.com/Digilent/dmc60c-frc-api]]
  
 ----- -----
Line 33: Line 33:
 >1.1) Power up the roboRIO and plug it into your network via ethernet cable, or into the computer via USB. >1.1) Power up the roboRIO and plug it into your network via ethernet cable, or into the computer via USB.
  
->​1.2) ​**Open** ​Labview 2017 and click **Utilities>​roboRIO Imaging Tool 2018**. **Find** the roboRIO in the roboRIO Targets box. **Take note of the IP address**.+>1.2) Open **roboRIO Imaging Tool**. **Find** the roboRIO in the roboRIO Targets box.
 > >
->​{{:​dmc-60c:​roborioimage.jpg?600|}}+>​{{:​dmc-60c:​roborioimage2019.jpg?direct&600|}}
 >NOTE: If the roboRIO does not appear on the list, make sure that it is connected to the same network as the computer running the Imaging tool. >NOTE: If the roboRIO does not appear on the list, make sure that it is connected to the same network as the computer running the Imaging tool.
 > >
Line 45: Line 45:
  
 ====2. Installing DMC60C Library files ==== ====2. Installing DMC60C Library files ====
->2.1) Run **Copy files to wpilib ​and roboRIO.bat** ​and enter the IP address of the roboRIOThis batch file will copy the DMC60C ​Library files to the WPILib directory, and to the roboRIO's /​usr/​local/​frc/​lib directory.+>2.1) Run **Install DMC60C libraries ​and config utility.bat**. This is the install script for the DMC60C APIIt will also install ​the DMC60C ​Config Utility server onto the roboRIO.
 > >
->2.2) You may get the following message describing a potential security breach. You may disregard this message and press '​y'​.+>{{:​dmc-60c:​installer.jpg?​direct&​800|}}
 > >
->{{:dmc-60c:securitybreach.jpg?800|}}+>2.2) Selecting 1 or 2 will copy the DMC60C config server to the roboRIO. The username and password can be left blank unless it was changed on the roboRIO. It will also install the DMC60C Library files to the WPILib directory. Selecting 3 will only copy the API files to the WPILIB directory. 
 +
 +>2.3)The DMC60C config server is hosted at "​**roboRIO-[team number]-FRC.local:8000**"​. The roboRIO IP address can also be used "​**[roboRIO IP address]:​8000**"​ to reach the server. This server is automatically started after installation.
  
-====3. Opening an example project ==== +====3. Configuring your DMC60C ==== 
->3.1) Open Eclipse IDE.+>3.1) Open an internet browser and type "​roborio-[teamnumber]-frc.local:​8000",​ replacing [teamnumber] with your team number. The roboRIO'​s IP address will also work and may respond faster. For example: 192.168.1.104:​8000 
 +
 +>3.2) If the DMC60C configuration utility was successfully set up, it will show up in the browser. Make sure to change the device ID from 0 to any number between 1 and 65 before continuing. You may also configure any other options here as well. 
 +
 +>​{{:​dmc-60c:​97239993.png?​direct&​800|}} 
 + 
 +====4. Opening an example project ​(C++/​Java) ​==== 
 +>4.1) Open FRC VS Code 2019. 
 +
 +>4.2) Click **File>​Open Folder**. 
 +
 +>4.3) Navigate to the **dmc60c-frc-api\Examples** folder. Select the folder containing the example project and click **Select folder**. 
 +
 +>​{{:​dmc-60c:​examplesvscode.jpg?​direct&​600|}} 
 +
 +>The project folder will be added to the VS Code workspace. This project already has the DMC60C vendor dependencies installed. **Note**: To install vendor dependencies,​ click the W in the top right corner and click **Manage Vendor Libraries>​Install New Libraries (Offline)>​Digilent-DMC60C** and click OK. 
 +
 +>4.4) In the explorer tab, open **.wpilib/​wpilib_preferences.json**. Change the team number to your team number and save the file. 
 +
 +>​{{:​dmc-60c:​teamnumber.jpg?​direct&​600|}} 
 + 
 +====4. Opening an example project (Labview) ==== 
 +>4.1) Open LabVIEW FRC 2019. 
 +
 +>4.2) Click **File>​Open Project...**. 
 +
 +>4.3) Navigate to the **dmc60c-frc-api\Examples\Labview** folder. Open the example project folder, select the .lvproj, and click OK to open the project. 
 +
 +>​{{:​dmc-60c:​labviewexample.jpg?​direct&​600|}} 
 +
 +>4.4) Right click the RoboRIO Target and open the Properties. 
 +
 +>​{{:​dmc-60c:​lvproperties.jpg?​direct&​600|}} 
 +
 +>4.5) Under IP Address / DNS Name, change the team number 42 to your team number. Click OK. 
 +
 +>​{{:​dmc-60c:​lvproperties2.jpg?​direct&​600|}} 
 +====5. Running the example project (C++/Java) ==== 
 +>5.1) Run **FRC Driver Station** to open the FRC Driver Station. 
 +
 +>5.2) Click the gear on the left side of the driver station. Change the **Team Number** to the roboRIO'​s team number and press enter. This should find the team's roboRIO. The roboRIO'​s IP address can also be entered here. 
 +
 +>5.3) Plug in the controller and wait for the joysticks light to turn green. 
 +
 +>​{{:​dmc-60c:​driverstation.jpg?​direct&​600|}}
 > >
->3.2Click **Window>​Preferences**Under **WPILib Preferences**,​ enter the team number ​of the roboRIO ​and click **Apply and Close**.+>5.4Open src/​main/​cpp/​Robot.cpp or src/​main/​java/​frc/​robot/​Robot.java to open the top level robot implementation. Change the device ​number ​to the device number of your DMC60C ​and save the file.
 > >
->3.3) Click **File>​Open Projects from File System...**. Click **Directory**. Navigate to the DMC60C_API/​Examples/​cpp/​ folder and click OK. Check the box next to the examples to import. Click Finish.+>{{:​dmc-60c:​devicenumber.jpg?​direct&​600|}}
 > >
->{{:​dmc-60c:​examples.jpg?600|}}+>5.5) When ready, click the WPI Logo on the top right. Click **WPILib C++ Deploy** and click **Ok** to deploy the code to the roboRIO.
 > >
->3.4) Eclipse has problems with auto indexing the example projects, which can result in many false errors. Right click each example project and click **Index>​Rebuild**.+>{{:​dmc-60c:​deploy.jpg?​direct&​600|}}
 > >
->{{:​dmc-60c:​rebuild_index.jpg?600|}}+>5.6) Click the steering wheel on the left side of the driver station. Select **Teleoperated** and click **Enable**. This will start the teleoperated loop in the deployed example code on the roboRIO. You should now be able to drive the DMC60C with the connected joystick.
  
-====4. Running the example project ==== +====5. Running the example project ​(LabVIEW) ​==== 
->4.1) Change the device number ​to the device number of the connected DMC60C.+>5.1) Run **FRC Driver Station** ​to open the FRC Driver Station.
 > >
->{{:​dmc-60c:​device_instantiation.jpg?800|}}+>5.2) Click the gear on the left side of the driver station. Change the **Team Number** to the roboRIO'​s team number and press enter. This should find the team's roboRIO. The roboRIO'​s IP address can also be entered here.
 > >
->4.2When ready, click **Run>​Run**. Click **WPILib C++ Deploy** ​and click **Ok** to deploy ​the code to the roboRIO.+>5.3Plug in the controller ​and wait for the joysticks light to turn green.
 > >
->​{{:​dmc-60c:​deploy.jpg?300|}}+>​{{:​dmc-60c:​driverstation.jpg?direct&​600|}}
 > >
->4.3) Open the **FRC Driver Station**.+>5.4) Open **Target/Team Code/​Begin.vi**. Press **CTRL+E** to open the block diagram for Begin.vi.
 > >
->4.4) Click the gear on the left side of the driver station. Change the **Team Number** to the roboRIO'​s team number and press enter.+>{{:​dmc-60c:​lvbegin.jpg?​direct&​600|}}
 > >
->{{:​dmc-60c:​driverstation.jpg?600|}}+>5.5) Change the device number feeding into the DMC60C Open VI to your DMC60C'​s device number. If applicable, change the wheel parameters based on your hardware configuration.
 > >
->4.5) Plug in the controller ​and wait for the joysticks light to turn green.+>5.5) When ready, open **Target/​Robot Main.vi** ​and run it. This will deploy ​the LabVIEW program ​to the roboRIO.
 > >
->4.6) Click the steering wheel on the left side of the driver station. Select **Teleoperated** and click **Enable**. This will start the teleoperated loop in the deployed example code on the roboRIO.+>5.6) Click the steering wheel on the left side of the driver station. Select **Teleoperated** and click **Enable**. This will start the teleoperated loop in the deployed example code on the roboRIO. You should now be able to drive the DMC60C with the connected joystick.
  
-{{tag>​dmc60c ​tutorial ​frc }}+{{tag>​dmc60c ​gsg frc }}