Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Overview

Table of Contents

Overview

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width400px
urlhttps://www.youtube.com/watch?v=4bm6Bz-xAJ4
height300px
Info

For Fullscreen: https://www.youtube.com/watch?v=4bm6Bz-xAJ4

This project is intended to show one how to setup a joystick with their Quantum platform. The joystick prototype consists of two joysticks and a button. It can be wired up on a breadboard using the schematics. The joystick can be used for controlling the Mecanum car or steering car.

You can also build this project with one of our DIY Kits!

Check out the Joystick DIY Kit page to find out how.

Status
colour

Bluestatus

Green
titlebeginner

Status

title10$ - $15

colourGreen
title1 hour

Status
title1-3 Clients

Add Image, Fritzing or animated gif here

Image Removed
Image Removed
Image Removed

Things used in this project

Hardware componentsImage AddedImage Added

Hardware Components

Picture

Name

Quantity

Link

Image Modified

Joystick

2

One is included in the

Starter Kit

Component Kit, but you can purchase the second one here

Image Modified

Tactile Push Button

1

Included in

Starter

Component Kit

Or you can purchase it here

Image Modified

Jumper Cables (MM)

4

Included in

Starter

Component Kit

Or you can purchase it here

Image Modified

Breadboard (any size)

2

Included in

Starter

Component Kit

Or you can purchase it here

Image Modified

Q-Client Builder Base

1

Q-Client

Tools Used

Picture

Name

Quantity

Link

Image Modified

Small flat-head screwdriver

1

Included in the

Starter

Component Kit

or you can pick from one on our Recommended Tools List

Build Process

The idea

This project is intended to show one how to setup a joystick with their Quantum platform. It’s an easy project that can be utilized to control numerous motor driven projects.

Video

Widget Connectoroverlayyoutube_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vmwidth960pxurlhttps://www.youtube.com/watch?v=4bm6Bz-xAJ4&ab_channel=QuantumIntegration

height540px

Procedure

Step 1:

Assemble the

Hardware

Circuit

To get started, gather all of the parts listed above.

Take your two joysticks and connect a male to female jumper wire to every terminal on them. Like so:

Image RemovedImage Added

Now, on your bread board place the tactile push button and attach a MM jumper wire to one pin and another MM wire to the pin diagonal to that one, like so:

Image RemovedImage Added

Finally, follow the schematic and bread board diagrams below to attach the components to the Builder Base:

Image RemovedImage Added

Image RemovedImage Added
Note

Be careful to connect both Joysticks to 3.3V and not 5V! If you don’t your readings will be wrong.

Step 2:

Pair the Builder Base

Now we want to pair the Builder Base with our Q-Server. In order to do so, go to the Homescreen of your Q-Server.

Image Added

Next click on the lift side symbol labeled “Clients”. Switch to the “Unpaired” tab at the top middle of the screen.

Image Added

You should see your unpaired Builder Base. If not, check if you have plugged in the power supply for the Builder Base. Now move to the three dots below “Actions” and click “Pair”.

Image Added

Once your Client is paired, click the “Setup” button.

Image Added

Now you can edit your Client. Give him a Name you want and also a location where you are going to use it. Hit “Save” when you finished.


Build the Firmware

Tip

Remember: all Apps and Firmware files are available in the resources section below!

Navigate to the Firmware Builder and create a new Firmware file. We named ours Joystick.

Image RemovedImage Added

Next, click the “+ Add Hardware” button and find the Joystick device via the search bar, select it, name it, and then click “Add Hardware”. We named ours Left.

Image RemovedImage Added

Now, add another device by clicking the “Add Hardware” button again, and add another Joystick. We named this one “Right”.

Image Removed

Image Removed
Image Added

Lastly, we will add one more device. Repeat the steps above to add another device, but this time search for a “Button”.

Image RemovedImage Added

You should now have three devices in your firmware file.

Image RemovedImage Added

Now you can follow this video to configure each device in the firmware file:

Joystick_Project

Note

Your joystick may come in a different pin mode configuration. Make sure to read manufacturer documentation on whether the joystick pushbutton is pull up or pull down.

Editing the hardwares.mov

Now you can upload your firmware to the Build Base.

Image Removed

Image Removed

Step 3: Image AddedImage Added

Build the

Application

App

Tip

Remember: all Apps and Firmware files are available in the resources section below!

Navigate to the Applications page and click .

Image Added

Click the “+ Create New Button”, name your application, and click create.

Image Removed

Image Removed
Image Added

You will now be directed to the App Builder Canvas.

Using the search bar in the left hand tool-bar search for the Joystick code object and drag it .

Image Added

Drag and drop two Joystick hardware objects onto the canvas.

Image Removed

Image Removed
Image Added

We will now name the Joystick code objects by clicking on them and editing their name in the right hand “properties” panel.

Image Removed

Image Removed
Image Added

Search for a “Button” hardware object, drag it .

Image Added

Drag and drop one onto the canvas, and name it accordingly.

Image Removed

Image Removed
Image Added

In order to save the names you must click the “Save Properties” button at the bottom of the properties tab.

Image RemovedImage Added

Next, search for the “Slider Analog” code object using the search bar.

Image Added

Drag and drag drop four of them onto the canvas.

Image Removed

Image Removed
Image Added

Search for the “Switch” object.

Image Added

Drag and drag drop three of them onto the screencanvas.

Image Removed

Image Removed
Image Added

At this point you should name and label all of your interface objects (The Switches and the Analog Sliders), as this will make them easier to identify on the dashboard.

We’ll show you how to do the first one. Select the object you wish to change the name of by clicking on it. The properties panel on the right will pop open. Here you can change the “Object Name” and the “Label”.

For this first object we will change both the Label and the Object Name to “X-Axis Left Joystick”. Remember to hit the “Save Properties” tab for each object that you rename, otherwise your changes will be lost.

Image Removed

Image Removed

Image Removed

Now that each Image AddedImage Added

Each of your interface objects are should now be properly labeled, let’s .

Image Added

Let’s connect the Hardware hardware objects to themthe interface objects. Connect the objects as follows:

Image Removed
Image Added

Image Removed

Your application is now complete! Save it and return to the Applications page.

Step 4: Map Your Application

Map the Hardware

You should now be back on the Apps page.

Find your “Joystick” app and hit the play button.

Image RemovedImage Added

A list containing all of the devices in your application will expand.

Image RemovedImage Added

Next click on the “Button” device and the client dropdown menu will appear on the right.

Select the Button driver from the dropdown menu and hit “Done”.

Image RemovedImage Added

Repeat the same steps for the “Right” and Joystick device.

Image Added

Repeat the same steps for the “Left” Joystick devicesdevice.

Image Removed

Image Removed
Image Added

Notice how the status symbols have changed to green checkmarks.

Image RemovedImage Added
Info

When mapping firmware devices to objects in your Apps it is important to note that only devices and objects of the same type can be mapped together. Using this app for example, we are only given the option to map the client with the button firmware to the button object.

Step 5:

Run the

Application

App!

Lastly, hit “Save + Run”

Image RemovedImage RemovedImage Added

Congratulations! Your Joystick project is now complete! You can now use this as input control for RC cars and other motorized projects!

Image Removed

Schematics

Image Removed

Image Removed

Code

App

View file
nameJoystick App.json

Firmware

View file
nameJoystick Firmware.json

Use the DIY Kit

You can also build this project with one of our DIY kits!

Check out the following project section of the Joystick DIY Kit page to find out how.

Gallery

Image Removed
Image Removed
Image Removed
Image Removed
Image Removed

Resources

AppImage Added

Resources

Application

View file
nameJoystick App.json

Firmware

View file
nameJoystick Firmware.json

Schematic

Image RemovedImage Removed
Image Added

Fritzing

View filenameJoystick.fzz

Diagram

Image Added