# Quick Start

## Creating a Project

To be able to use FMS, you need to create a project. Everything in FMS (robots, maps, tasks, etc.) is organised in projects. To create a project, from the FMS application home click "Add Projects" or "Create" > "Project" from the top right.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FntcrwzMdz6eeFfnPo2BS%2Fvlcsnap-2024-07-22-14h56m57s616.png?alt=media&#x26;token=8f427dbe-f1aa-47b9-b357-6fed399cad68" alt=""><figcaption></figcaption></figure>

Fill in the details then click "Submit". You then should see there's a new project on the list.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FeANbGaJEZUY8z7uICUNa%2Fvlcsnap-2024-07-24-10h41m38s076.png?alt=media&#x26;token=adf8df00-c56c-4a37-9625-01854cda2038" alt=""><figcaption></figcaption></figure>

Enter the project and you should be directed to the new project's dashboard.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2F1rC9gmz4wPXthnijXUW4%2Fvlcsnap-2024-07-24-10h44m12s332.png?alt=media&#x26;token=3497648f-9603-4431-bc62-9c09e3dca645" alt=""><figcaption></figcaption></figure>

## Adding Your First Robot

Now that we have a project, let's add a robot to the project. Inside the project, under the "Robots" tab, click "Create Robot".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2F7ZtiqsxkuhaXtcN9XDMJ%2Fvlcsnap-2024-07-24-10h45m18s129.png?alt=media&#x26;token=1d453655-4679-41a4-8a01-379f71df5f7f" alt=""><figcaption></figcaption></figure>

Fill in the details, then click "Submit".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FStdLxS1IznDcE51PHWwU%2Fvlcsnap-2024-07-24-15h07m03s841.png?alt=media&#x26;token=c62a7db4-e324-472d-8992-babbeb9ab2b4" alt=""><figcaption></figcaption></figure>

You will get a robot key. Copy and paste this robot key to your robot's plugin. Refer to this tutorial for a quick start with RNS plugin. Now you can close the dialog.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FZlzNe039jF7D6AmlXcqO%2Fvlcsnap-2024-07-24-15h07m28s829.png?alt=media&#x26;token=055bd54c-5092-4ed8-9ffa-4bc8cb3f041a" alt=""><figcaption></figcaption></figure>

You will see the new robot appear on the list. When the robot is connected, the connection status should turn green.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FhZSYe7oxBzQQFKy1FAzf%2Fvlcsnap-2024-07-24-15h07m49s842-1.png?alt=media&#x26;token=c87f1037-1d9b-4224-b5e3-ccf298ddc4d5" alt=""><figcaption><p>When robot is disconnected</p></figcaption></figure>

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FlwJLgigXIUyieeGracQi%2Fvlcsnap-2024-07-24-15h08m28s635-1.png?alt=media&#x26;token=2111d40f-b86a-4312-b8ba-e9212daf8aa2" alt=""><figcaption><p>When robot is connected</p></figcaption></figure>

## Add and Load a Map to FMS

Robots must operate within a map. For this, we need to add a map to FMS. There are several ways to add a map to FMS. We will discuss two methods: importing from file and creating a map with robot (mapping).

### Adding a Map to FMS

#### Import a Map from File

To import a map from file, go to "Library" tab and click "Import Map from File" on the top left.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FsfOh1yUfoKivU6pTUFvZ%2Fvlcsnap-2024-07-29-10h51m23s775.png?alt=media&#x26;token=acab732a-4b50-43d5-a5e9-ef24f25b3783" alt=""><figcaption></figcaption></figure>

Fill in the map information and upload the files. You need both the PGM and YAML files of the map (following the ROS mapping system). Then click "Submit".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2Fm6ODhHNoJYjQfOeuoELS%2Fvlcsnap-2024-07-29-10h52m14s628.png?alt=media&#x26;token=144d8c59-ab92-4da0-865f-cfd65eba4220" alt=""><figcaption></figcaption></figure>

You should now see the new map on the list.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FFbHQrwQ8iyjUHWMHmWWb%2Fvlcsnap-2024-07-29-10h53m55s022.png?alt=media&#x26;token=99115573-5c84-450e-9ba1-c413898f55c1" alt=""><figcaption></figcaption></figure>

#### Adding a Map by Mapping

To add a new map by mapping, go to the Dashboard tab and switch the mode to manual mapping.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FJKo06gL3hZhgyMdRzpO9%2Fvlcsnap-2024-07-29-10h57m19s214.png?alt=media&#x26;token=2f891607-238f-4fbf-8595-2a4259ddb0ad" alt=""><figcaption></figcaption></figure>

To begin the mapping process, click "Manual" on the control panel.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2F7wpHo1B0oPCEz7PWkjm1%2Fvlcsnap-2024-07-29-10h57m02s002.png?alt=media&#x26;token=2bc78bad-f66a-4139-8550-482bb65d7cee" alt=""><figcaption></figcaption></figure>

Drive the robot with keyboard or joystick.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2F8whjjGbKYGW8G1LLbzog%2Fvlcsnap-2024-07-29-10h57m53s570.png?alt=media&#x26;token=1f66917c-97ec-482f-9c5a-768144645da8" alt=""><figcaption></figcaption></figure>

When you're done, click "Save".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FlZedt0tqsyGVe5Lnf017%2Fvlcsnap-2024-07-29-11h00m25s867.png?alt=media&#x26;token=e18c8f0e-0938-4b04-9a63-36ffb641733e" alt=""><figcaption></figcaption></figure>

A new map will then appear on the list in "Library".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FDMkSnj8Tpxp6y2WAVZca%2Fvlcsnap-2024-07-29-11h01m17s855.png?alt=media&#x26;token=59a51fc5-9132-485c-87ed-27210eaa4edd" alt=""><figcaption></figcaption></figure>

### Loading a Map to Dashboard

Now we will use the map(s) that we just added into the dashboard so the robots can use it for navigation and localisation. For this, under the "Library" tab, click "Load Maps".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FsQCAZdFLOTfsXis1NSnt%2Fvlcsnap-2024-07-29-11h04m14s569.png?alt=media&#x26;token=aebb53fe-e7cc-482b-baea-b88c98172a67" alt=""><figcaption></figcaption></figure>

FMS allows multiple maps to be loaded at the same time (e.g. for multi-floor operations). Robots will be able to navigate between maps. To add a map to dashboard, click the little "+" button on the map card. Then click "Save".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2Fb5u3U7UN0bVfKlwPGVnU%2Fvlcsnap-2024-07-29-11h05m39s705.png?alt=media&#x26;token=85725f06-1138-486e-94cb-eea8c6a91ac0" alt=""><figcaption></figcaption></figure>

If you go to the Dashboard, you should see that the maps are now visible.

## Adding and Running a Task

Now that we have robots operating in a map, let's put the robot to work. We can send robots to do tasks. Let's create our first task.

Under the "Dashboard" tab, switch the mode to "Waypoint".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FUGPBcWXahQKAMQx8107X%2Fvlcsnap-2024-07-29-11h09m17s619.png?alt=media&#x26;token=08a43fff-cf37-4e16-b50e-4117a8897423" alt=""><figcaption></figcaption></figure>

Add waypoints on the map by dragging across the map and clicking "Mark" where you want your waypoint to be, then click "Save". Name your waypoint.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2F1OKS642udZMz7iSTRVM3%2Fvlcsnap-2024-07-29-11h16m43s668.png?alt=media&#x26;token=3a2a086f-8a55-43d0-bb9f-1eacb0d8410c" alt=""><figcaption></figcaption></figure>

To execute the task, click the tasks shortcut icon and choose your task.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FBEw9T08tTakKQ7cyHUKQ%2Fvlcsnap-2024-07-29-11h14m27s055.png?alt=media&#x26;token=bfa758c8-99fc-461a-8d1c-f9f21f924d2a" alt=""><figcaption></figcaption></figure>

Choose the agent to execute the task. You can also ask the FMS to automatically assign the task to any one robot. Then click "Run Now".

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FnBDnaeWHkWALrqcJ8Lrb%2Fvlcsnap-2024-07-29-11h15m07s729.png?alt=media&#x26;token=89b9b03a-96e9-42a6-9fc8-e9d80d4c0465" alt=""><figcaption></figcaption></figure>

You shall now see that the assigned robot is executing the task.

<figure><img src="https://3011557067-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkBtlBrwlCbBifOLd-h-887967055%2Fuploads%2FHbq0YHYJxTONBZbk689s%2Fvlcsnap-2024-07-29-11h15m37s266.png?alt=media&#x26;token=6f48dd73-1103-4feb-9535-99ec1294c3c6" alt=""><figcaption></figcaption></figure>

## Next Steps

Congratulations, you've executed your first task on FMS. Now let's see the other features that FMS has to offer.
