Skip to content

Benjamindannegard/x8 gs improvements #115

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 25, 2022
Merged

Benjamindannegard/x8 gs improvements #115

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e45758b
standardized images
BenjaminDannegard Mar 24, 2022
94a7f67
Small fixes to the text
BenjaminDannegard Mar 24, 2022
c0562b2
Update content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-th…
BenjaminDannegard Mar 25, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 15 additions & 16 deletions content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ software:

## Connecting to the Board

Once the Portenta X8 its plugged via USB, you can open your browser and go to http://192.168.7.1 and see a web which is hosted by the board, from this dashboard you will be able to:
Once the Portenta X8 is plugged in via USB, you can open your browser and go to http://192.168.7.1 and see a web page which is hosted by the board, from this dashboard you will be able to:

![Board set up page](assets/x8-oob-main.png)

Expand All @@ -36,19 +36,20 @@ Click the Wi-Fi button to start configuring your network connection.

![Select wifi on set up page](assets/x8-oob-main-wifi.png)

Select your Wi-Fi SSID
Select your Wi-Fi SSID.

![Wifi ssid set up](assets/x8-oob-wifi-ssid.png)

Type the password
Type the password.

![Wifi password set up](assets/x8-oob-wifi-pass.png)

Once its connected you should see the Wi-Fi status button on green.
Once its connected you should see the Wi-Fi status dot in the bottom left turn green.

![Wifi connection done](assets/x8-oob-wifi-sucess.png)


***You can change your network by clicking again on the button and repeat the steps***
***You can change your network by clicking on the button again and repeat the steps***

## Registering a Factory

Expand All @@ -60,35 +61,33 @@ And set your new factory name.

![Name your factory](assets/x8-oob-factory-name.png)

Click register, now you will get a code that you need to paste into your factory page by opening [Arduino Create Cloud](https://create.arduino.cc) in your browser and click inside the integrations section "Portenta X8 Board Manager"
Click register, now you will get a code that you need to paste into your factory page by opening [Arduino Create Cloud](https://create.arduino.cc) in your browser and click the "Portenta X8 Board Manager" inside the integrations section.
![Complete factory page](assets/x8-oob-factory-register.png)
![Arduin Cloud integration](assets/cloud-main.png)

Once it succeed the factory button will turn to green.
Once it is complete the factory button will turn green.

![Successful connection](assets/x8-oob-wifi-sucess.png)


## Controlling Portenta X8 Through the Terminal

You have plenty of ways to communicate with your board, we are going to show adb and ssh.
You have plenty of ways to communicate with your board, be it wirelessly or with a cable. Next we are going to show how to use adb and ssh.

### ADB

First of all make sure you have the latest Mbed Portenta Core, which contains the adb program.
You can go to its directory inside the Arduino15/packages/arduino/tools/adb/32.0.0, to check the tool you can type on your terminal `adb` you should get feedback from the tool.
First of all make sure you have the latest **Mbed OS Portenta Core**, which contains the adb program.
You can go to its directory inside the **Arduino15/packages/arduino/tools/adb/32.0.0**. To check the tool you can use your teminal and type `adb`, you should get feedback from the tool when typing this.

To know the list of devices that can be accessed type `adb devices`.

If you see only one you just can type `adb shell` if it succeed, you are now communicating to your Portenta X8.
If you only see one device you can try and type `adb shell`, you are now communicating with your Portenta X8.

### SSH

SSH is commonly used for remote control on a different kind of devices running different set ups through TCP-IP.

To communicate with your board, you will need to know the IP of it, and just type `ssh fio@<IP>`, then the terminal workaround should be the same as ADB.
SSH is commonly used for remote control on different kinds of devices running different set ups through TCP-IP.

The password is `fio`.
To communicate with your board, you will need to know the IP of it, and just type `ssh fio@<IP>`, then the terminal workaround should be the same as ADB. The password is `fio`.

![SSH connection](assets/ssh-connection.png)
As it is a linux device, you can do normal stuff like creating files, changing directory, etc.
Expand All @@ -111,4 +110,4 @@ Make sure you have the latest mbed Core and as every other board you can select

And click compile and upload.

***Make sure you don't share GPIOs on the linux side and the Arduino sketc, this will avoid possible errors***
***Make sure you don't share GPIOs on the linux side and the Arduino sketch, this will avoid possible errors***