-
-
Notifications
You must be signed in to change notification settings - Fork 481
Portenta X8 : Getting Started (Beta) #113
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.
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
Changes from all commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
114 changes: 114 additions & 0 deletions
content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,114 @@ | ||
| --- | ||
| beta: true | ||
| title: 'Portenta X8 Getting Started (Beta)' | ||
| description: 'Learn how to set up the Portenta X8 (Beta)' | ||
| difficulty: medium | ||
| tags: | ||
| - Beta | ||
| - Installation | ||
| - OTA | ||
| - Embedded Linux | ||
| author: 'Pablo Marquínez' | ||
| hardware: | ||
| - hardware/04.pro/boards/portenta-x8 | ||
| software: | ||
| - ide-v1 | ||
| - ide-v2 | ||
| - web-editor | ||
| - iot-cloud | ||
| --- | ||
|
|
||
| ## 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: | ||
|
|
||
|  | ||
|
|
||
|
|
||
| * [Configure Wi-Fi](#connecting-to-your-wi-fi) | ||
| * [Register the factory (OTA)](#registering-a-factory) | ||
| * Board details | ||
| * Shell | ||
|
|
||
| ## Connecting to Your Wi-Fi | ||
|
|
||
| Click the Wi-Fi button to start configuring your network connection. | ||
|
|
||
|  | ||
|
|
||
| Select your Wi-Fi SSID | ||
|
|
||
|  | ||
|
|
||
| Type the password | ||
|  | ||
|
|
||
| Once its connected you should see the Wi-Fi status button on green. | ||
|
|
||
|  | ||
|
|
||
|
|
||
| ***You can change your network by clicking again on the button and repeat the steps*** | ||
|
|
||
| ## Registering a Factory | ||
|
|
||
| Click the "Register with Factory" button. | ||
|
|
||
|  | ||
|
|
||
| And set your new factory name. | ||
|
|
||
|  | ||
|
|
||
| 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" | ||
|  | ||
|  | ||
|
|
||
| Once it succeed the factory button will turn to green. | ||
|
|
||
|  | ||
|
|
||
|
|
||
| ## Controlling Portenta X8 Through the Terminal | ||
|
|
||
| You have plenty of ways to communicate with your board, we are going to show 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. | ||
|
|
||
| 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. | ||
|
|
||
| ### 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. | ||
|
|
||
| The password is `fio`. | ||
|
|
||
|  | ||
| As it is a linux device, you can do normal stuff like creating files, changing directory, etc. | ||
|
|
||
| To gain admin (root) access, type `sudo su -` and the password is `fio` after that the terminal prefix should turn red. | ||
|
|
||
|  | ||
|
|
||
| ### Inspecting Real Time Tasks | ||
|
|
||
| Run: `journalctl -f` to see what's going on on the device | ||
|
|
||
|  | ||
|
|
||
| ## Uploading an Arduino Sketch | ||
|
|
||
| Make sure you have the latest mbed Core and as every other board you can select the board inside the `mbed Portenta`. | ||
|
|
||
|  | ||
|
|
||
| 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*** |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.