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
Next revision Both sides next revision
en:sw:03-3rd-party:nodered:installation-neuron [2019/09/13 13:45]
tomhora old revision restored (2019/01/29 09:57)
en:sw:03-3rd-party:nodered:installation-neuron [2020/03/06 08:29]
tomhora
Line 1: Line 1:
-====== Node-RED on UniPi Neuron ======+====== Node-RED on Unipi Neuron ======
 The following manual will guide you through the process of powering up your UniPi Neuron controller. Before the start, please check the device for any damage that occurred during shipment or any other visible defect. ​ The following manual will guide you through the process of powering up your UniPi Neuron controller. Before the start, please check the device for any damage that occurred during shipment or any other visible defect. ​
 ===== OS installation =====  ===== OS installation ===== 
Line 5: Line 5:
 Prepare an SD card to which the OS will be burned. You can purchase the card in a single package with the controller – if the card was not purchased this way, you need to either purchase one or use your own card. The complete software package requires approximately **2.5 GB**; while a 4GB memory card would be sufficient theoretically,​ we strongly recommend using an **8 GB** or **16 GB**. The card’s speed is important, we thus recommend to choose a faster card of Class 10 or more.  Prepare an SD card to which the OS will be burned. You can purchase the card in a single package with the controller – if the card was not purchased this way, you need to either purchase one or use your own card. The complete software package requires approximately **2.5 GB**; while a 4GB memory card would be sufficient theoretically,​ we strongly recommend using an **8 GB** or **16 GB**. The card’s speed is important, we thus recommend to choose a faster card of Class 10 or more. 
  
-After obtaining the card, download ​the UniPian OS image. In the [[files:​software:​os-images:​00-start|Files & Downloads]] section, you can find the latest release. Download and extract the RAR archive containing a //.img// file to be burned onto an SD card. +After obtaining the card, download the [[https://​kb.unipi.technology/​en:​files:​software:​os-images:​00-start#​neuron_opensource_os ​Unipi Neuron OpenSource OS image]]. Download and extract the archive containing a //.img// file to be burned onto an SD card.
- +
-{{:​en:​sw:​03-3rd-party:​nodered:​screenshot_113.png?​300|}}+
  
 We also recommend formatting the SD card first by using the [[https://​kb.unipi.technology/​files:​software:​tools:​00-start#​sd_card_formatter|SD Card Formatter]] We also recommend formatting the SD card first by using the [[https://​kb.unipi.technology/​files:​software:​tools:​00-start#​sd_card_formatter|SD Card Formatter]]
Line 43: Line 41:
   * an input file (input file if=) – here, insert the downloaded image: ''​if=UniPian-Neuron-2019-01-07v1.9.omg'' ​   * an input file (input file if=) – here, insert the downloaded image: ''​if=UniPian-Neuron-2019-01-07v1.9.omg'' ​
   * an output file (''​output file of=''​);​ insert the SD card: ''​of=/​dev/​mmcblk0.''​ Bear in mind it is again necessary to state the SD card itself, not only a directory such as //sdds1//, //sddp1// or //​mmcblk0p1//​. ​   * an output file (''​output file of=''​);​ insert the SD card: ''​of=/​dev/​mmcblk0.''​ Bear in mind it is again necessary to state the SD card itself, not only a directory such as //sdds1//, //sddp1// or //​mmcblk0p1//​. ​
-  * A block size (''​block size bs''​). This parameter determines the size of blocks used for writing onto the SD card. The default size is 4 MB – in case of issues, it is also possible to use 1MB size. The resulting command to write data looks like the following: ''​sudo dd bs=4M if=UniPian-Neuron-2019-01-07-v1.9.img of=/​dev/​mmcblk0'' ​+  * A block size (''​block size bs''​). This parameter determines the size of blocks used for writing onto the SD card. The default size is 4 MB – in case of issues, it is also possible to use 1MB size. The resulting command to write data looks like the following: ​ 
 +''​sudo dd bs=4M if=UniPian-Neuron-2019-01-07-v1.9.img of=/​dev/​mmcblk0'' ​
  
 The "​dd"​ program does not indicate its operation, nor displays any information. Writing onto the SD card may take up to 5 minutes; that said, simply wait until some result will display. ​ The "​dd"​ program does not indicate its operation, nor displays any information. Writing onto the SD card may take up to 5 minutes; that said, simply wait until some result will display. ​
Line 51: Line 50:
 === Editing the SD card directory === === Editing the SD card directory ===
 If the image was burned successfully,​ the card will load as a boot when inserted to the PC.  If the image was burned successfully,​ the card will load as a boot when inserted to the PC. 
-Before inserting the card into the controller, it is necessary to create ssh file. The easiest method is to create a .txt file named ssh.txt+Before inserting the card into the controller, it is necessary to create ssh file. The easiest method is to create a .txt file named **ssh.txt**
  
 === Inserting the card === === Inserting the card ===
Line 86: Line 85:
   * Login: ** pi**    * Login: ** pi** 
   * Password: **raspberry**  ​   * Password: **raspberry**  ​
-  *  +
-<WRAP center round info 60%>+
 The password text is written as invisible – if the cursor is not moving during the password insertion, it is not an error! ​ The password text is written as invisible – if the cursor is not moving during the password insertion, it is not an error! ​
 Upon successful login, this screen will appear: Upon successful login, this screen will appear:
-</​WRAP>​ +
- +
 With the SSH running, the controller is ready for the upload of remaining parts of the Node-RED setup. With the SSH running, the controller is ready for the upload of remaining parts of the Node-RED setup.
  
Line 101: Line 98:
 For the purpose of this guide, only several commands will be needed to be entered into the SSH terminal. Bear in mind that it is recommended to paste commands by lines. It is also possible to run several blocks at once, but we strongly recommend to perform the procedure one step at a time. If the UniPian image was used, the EVOK is already contained within it and it is not needed to install it again. It is, however, necessary to check if the latest version is used. All you need to do is to use following commands: ​ For the purpose of this guide, only several commands will be needed to be entered into the SSH terminal. Bear in mind that it is recommended to paste commands by lines. It is also possible to run several blocks at once, but we strongly recommend to perform the procedure one step at a time. If the UniPian image was used, the EVOK is already contained within it and it is not needed to install it again. It is, however, necessary to check if the latest version is used. All you need to do is to use following commands: ​
  
-''​sudo su ''​  +''​sudo su''​ 
-''​apt-get install evok '' ​+  
 +''​apt-get install evok'' ​ 
 ''​apt-get update'' ​ ''​apt-get update'' ​
 +
 ''​reboot'' ​ ''​reboot'' ​
  
Line 124: Line 124:
 ''​bash <(curl -sL https://​raw.githubusercontent.com/​node-red/​raspbian-deb-package/​master/​resources/​update-nodejs-and-nodered)'' ​ ''​bash <(curl -sL https://​raw.githubusercontent.com/​node-red/​raspbian-deb-package/​master/​resources/​update-nodejs-and-nodered)'' ​
  
-To finish the install, three questions will appear.  +To finish the install, three questions will appear. 
-1. Are you really sure you want to install as root? [y/N]? + 
-2. Are you really sure you want to do this? [y/N]? +  - Are you really sure you want to install as root? [y/N]? 
-3. Would you like to install the Pi-specific nodes? [y/N]?+  ​- ​Are you really sure you want to do this? [y/N]? 
 +  ​- ​Would you like to install the Pi-specific nodes? [y/N]?
   ​   ​
 Answer them in the following order – Y, Y, N (check the following screenshot for reference) ​ Answer them in the following order – Y, Y, N (check the following screenshot for reference) ​
Line 137: Line 138:
 {{:​en:​sw:​03-3rd-party:​nodered:​screenshot_122.png?​600|}} {{:​en:​sw:​03-3rd-party:​nodered:​screenshot_122.png?​600|}}
  
-By default, the ''​node-red''​ command must be used each time to run Node-RED. In order to make things easier, enter one additional command to the SSH terminal: ''​sudo systemctl enable ​unordered.service''​+By default, the ''​node-red''​ command must be used each time to run Node-RED. In order to make things easier, enter one additional command to the SSH terminal: ''​sudo systemctl enable ​nodered.service''​
    
 This command will set Node-RED to launch on device startup. ​ This command will set Node-RED to launch on device startup. ​
Line 178: Line 179:
 {{:​en:​sw:​03-3rd-party:​nodered:​screenshot_130.png?​400|}} {{:​en:​sw:​03-3rd-party:​nodered:​screenshot_130.png?​400|}}
    
-Now just copy and paste the content of the **flow pro navod verze 1.0.json** file added to this manual and click on Import.  ​+Now just copy and paste the content of the **{{ :​en:​sw:​03-3rd-party:​nodered:​json.txt |demo_flow_1.0.json}}** file added to this manual and click on Import.  ​
 With the import finished, open the user interface webpage by entering the IP address and adding /ui. as a suffix With the import finished, open the user interface webpage by entering the IP address and adding /ui. as a suffix
   ​   ​