diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/IDE-boards.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/IDE-boards.png new file mode 100644 index 0000000000..cdbf11449e Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/IDE-boards.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/cloud-main.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/cloud-main.png new file mode 100644 index 0000000000..ffc76ca5a8 Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/cloud-main.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/command-journalctl.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/command-journalctl.png new file mode 100644 index 0000000000..e8dfdd64d0 Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/command-journalctl.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/ssh-connection-admin.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/ssh-connection-admin.png new file mode 100644 index 0000000000..2b1076167e Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/ssh-connection-admin.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/ssh-connection.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/ssh-connection.png new file mode 100644 index 0000000000..8979d5e135 Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/ssh-connection.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-factory-name.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-factory-name.png new file mode 100644 index 0000000000..c9c37a883c Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-factory-name.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-factory-register.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-factory-register.png new file mode 100644 index 0000000000..d478dc2d63 Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-factory-register.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main-factory.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main-factory.png new file mode 100644 index 0000000000..3d56015f7d Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main-factory.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main-wifi.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main-wifi.png new file mode 100644 index 0000000000..f23e4e2232 Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main-wifi.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main.png new file mode 100644 index 0000000000..f2dc1b46a4 Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-main.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-pass.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-pass.png new file mode 100644 index 0000000000..80028b2b2d Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-pass.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-ssid.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-ssid.png new file mode 100644 index 0000000000..c3b6d009f1 Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-ssid.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-sucess.png b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-sucess.png new file mode 100644 index 0000000000..d6b039e99f Binary files /dev/null and b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/assets/x8-oob-wifi-sucess.png differ diff --git a/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md new file mode 100644 index 0000000000..c7c2b416f8 --- /dev/null +++ b/content/hardware/04.pro/boards/portenta-x8/tutorials/out-of-the-box/content.md @@ -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: + +![Board set up page](assets/x8-oob-main.png) + + +* [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 wifi on set up page](assets/x8-oob-main-wifi.png) + +Select your Wi-Fi SSID + +![Wifi ssid set up](assets/x8-oob-wifi-ssid.png) + +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. + +![Wifi connection done](assets/x8-oob-wifi-sucess.png) + + +***You can change your network by clicking again on the button and repeat the steps*** + +## Registering a Factory + +Click the "Register with Factory" button. + +![Register with factory](assets/x8-oob-main-factory.png) + +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" +![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. + +![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. + +### 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@`, 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. + +To gain admin (root) access, type `sudo su -` and the password is `fio` after that the terminal prefix should turn red. + +![CLI configured](assets/ssh-connection-admin.png) + +### Inspecting Real Time Tasks + +Run: `journalctl -f` to see what's going on on the device + +![Real time tasks on CLI](assets/command-journalctl.png) + +## 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`. + +![Board selected in Arduino IDE](assets/IDE-boards.png) + +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*** \ No newline at end of file