Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:automation:unipi-ssh-connect-hidden [2020/05/25 06:52]
avsetula
en:automation:unipi-ssh-connect-hidden [2021/09/01 13:09] (current)
avsetula
Line 1: Line 1:
-====== ​Internal ​SSH console ​======  +====== SSH access ​====== 
 +<WRAP group 100%> 
 +<WRAP half column 81%>
 All Unipi devices include a full-featured ARM-based Linux environment,​ which is accessible via a Secure Shell console after following the steps below. This allows the users of Unipi devices to fully leverage the incredible versatility provided by open-source software packages. All Unipi devices include a full-featured ARM-based Linux environment,​ which is accessible via a Secure Shell console after following the steps below. This allows the users of Unipi devices to fully leverage the incredible versatility provided by open-source software packages.
 +</​WRAP>​
 +<WRAP half column 15%>
 +;;#
 +<​html><​span class="​dev-tag dev-axon">​Axon</​span></​html>​ \\
 +<​html><​span class="​dev-tag dev-neuron">​Neuron</​span></​html>​ \\
 +<​html><​span class="​dev-tag dev-unipi11">​Unipi&​nbsp1.1</​span></​html>​
 +;;#
 +</​WRAP>​
 +</​WRAP>​
 +===== Unipi Patron / Axon / Gate =====
 +Patron / Axon controllers and Unipi Gate devices have an internal SSH server. This server is enabled by default for all the most current OS images that we provide for these units. The exception is the Mervis OS image, which has SSH disabled. Instructions for enabling SSH can be found in the leaflet supplied with the unit or below. After enabling the server, it is then possible to connect to the PLC through any SSH client in the local network. The following instructions are intended primarily for users who are not yet familiar with SSH.
  
-The process of enabling access to it differs slightly between the three generations of Unipi devices and is detailed below for Unipi Axon. The [[en:​files:​software:​os-images:​00-start#​neuron_mervis_os|process]] for Unipi 1.1 and Unipi Neuron is the same as for ordinary Raspberry Pi. +==== Connecting ​to the service interface, enabling ​the SSH ==== 
- +The first step is to enable remote access to the SSH internal ​server. ​This configuration ​is available in the Axon service interface ​accessible by the following ​methods
-==== Unipi Axon ==== +
- +
-Unipi Axon includes an internal SSH server which is disabled by default and must be enabled according ​to the instructions in the “Getting Started” leaflet packaged with the device. After the server is enabled it is possible to connect to the device via any SSH client in the local network. This guide is intended to help users who are not otherwise familiar with SSH and is not necessarily the only way of connecting to the device. +
- +
-=== Necessary steps === +
- +
-The first step for connecting to the Unipi Axon SSH console ​is to enable remote access to the internal ​SSH server. ​The server ​is enabled via the Unipi Axon service interfacethe interface can be accessed by following ​the steps below:+
  
-  ​Hold down the small recessed button on top of the Axon device case using a thin-enough tool. The button can be found next to the USB port labels on the upper side of the device. +{{page>​en:​hw:​01-axon:service-web-interface-hidden}}
-  - Power up the controller while holding the button down. +
-  - Wait until the device finishes booting into the Unipi service ​mode. This is indicated by the two rows of LEDs flashing in an alternating fashion.  +
-  ​Use a device with a web browser to connect to the Unipi Axon via Ethernet LAN or Wi-Fi. The process is slightly different between the two options: +
-      - Ethernet LAN: The interface ​will be accessible on IP address 192.168.200.200. The device will also attempt to acquire an additional dynamic IP address via DHCP if DHCP is available.  +
-      ​Wi-Fi: The Unipi Axon service mode will create a Wi-Fi access point with SSID “UNIPICONFIG” and password “unipi.technology”. The interface will be accessible on IP addresses 192.168.200.200 and 192.168.201.1+
  
-After accessing ​the web interface ​you should see a screen with multiple buttons. To enable the SSH server first press the button with “Enable ssh” in the centre of the screen and then the “Restart System” button in the upper right corner of the screen.+Enter the IP address into your browser'​s address tab and confirm. Upon loading the service ​interface ​the following ​screen with multiple buttons ​should appear: ​
  
-==== Setting up tools ====+{{ :​en:​hw:​patron_service_mode.png?​direct |}}
  
-There are many tools which can be used to connect to SSH servers. For this tutorialwe recommend using PuTTY. You can download ​the PuTTY installer from https://the.earth.li/​~sgtatham/​putty/​0.70/​w32/​putty-0.70-installer.msi (a third-party link) or many other places on the web.+To enable the SSH server firstclick **Enable ssh** in the **Settings** category, and when the successful enable message appears, click **Restart System** in the upper right corner
  
-==== Connecting to the device via PuTTY ====+===== Unipi Neuron / 1.1 ===== 
 +All up-to-date OS images provided for Unipi Neuron and Unipi 1.1 controllers have SSH enabled by default except for the Mervis OS image. To enable SSH in Mervis OS create a new empty file named **ssh** (without any suffix, or with *.txt* suffix) and place it into the microSD card's boot directory along with Mervis OS. The SSH server will start after re-inserting the SD card into the PLC 
  
-The next step is to run PuTTY. You should be presented with relatively complicated interface, however, the only portion which we need to fill in is the “Host Name (or IP address)” field. Type in the IP address of your Unipi device, and then press the “Open” button at the bottom of the PuTTY windows.+===== Selecting ​suitable communication software =====
  
-You should now see a console window asking for a username and passwordUse the username “unipi” and password “unipi.technology”;​ these may be changed later, but this is outside the scope of this tutorial.+There are many tools that can be used to connect to SSH serversFor this tutorial, we recommend using PuTTY
  
-At this point you should see a Linux command prompt with the following format **“unipi@[your-device-ID]:”** – if so congratulations,​ you have connected to the internal SSH console successfully!+{{page>​en:files:​software:​tools:​putty-hidden}}