Table of Contents
Advertisement
Quick Links
Advertisement
Table of Contents
Summary of Contents for Plat Home OpenBlocks IoT VX2
- Page 1 OpenBlocks IoT Family Developer Guide Version 3.1.0 Plat'Home Co., Ltd.
- Page 2 ■ About trademarks ・ Linux is a trademark or registered trademark of Linus Torvalds in the United States and/or other countries. ・ Company and product names mentioned in this Developer Guide may be trademarks or registered trademarks of their respective companies. ・...
-
Page 3: Table Of Contents
Table of contents Chapter 1 General ........................5 1-1. Items included in package for VX2 ................5 1-2. Names of parts (VX2 main body) ................6 Chapter 2 Before starting to use the OpenBlocks IoT Family ..........8 2-1. Product overview ......................8 2-2 Cautions about SSD-based system development ............ - Page 4 4-1. Open Blocks IoT VX2 main body specifications ............36 4-2. OpenBlocks IoT VX series options ................37 4-2-1. 3G module ......................37 Chapter 5 Cautions and supplementary information............38 5-1. Countermeasures against delays due to script processing ........38 5-2.
-
Page 5: Chapter 1 General
If a general user, please refer to the OpenBlocks IoT Family WEB UI Set-up Guide. 1-1. Items included in package for VX2 Standard configuration of OpenBlocks IoT VX2 is as follows: 1 x VX2 main body 1 x USB Type-A Micro USB cable... -
Page 6: Names Of Parts (Vx2 Main Body)
1-2. Names of parts (VX2 main body) Name Remarks ① USB serial console port Micro USB Micro-B ② Ethernet port 0 10BASE-T / 100BASE-TX / 1000BASE-T ③ Ethernet port 1 10BASE-T / 100BASE-TX / 1000BASE-T Shuts down OS if in operation. ④... - Page 7 Name Remarks ⑫ Power switch Shuts down OS if in operation. Starts up OS if not in operation. ⑬ Status indicator LEDs illuminate or flash in seven colors. ⑭ SIM slot Slot for inserting SIM card. *Supports mini-SIM card format (2FF) (standard SIM) ⑮...
-
Page 8: Chapter 2 Before Starting To Use The Openblocks Iot Family
Chapter 2 Before starting to use the OpenBlocks IoT Family 2-1. Product overview The OpenBlocks IoT Family is a general-purpose server product employing Debian GNU/Linux as an OS. Though customized to take advantage of hardware properties, it is possible to use the OpenBlocks IoT Family in a general operational method for Debian and other Linux products, apart from such customization. - Page 9 ●Write count per cell and block size of flash memory Despite a write capacity of 3,000 times per cell, just one byte of writing onto an SSD means one count. To support large capacity with a small number of address lines, recent flash memory is read and written in a block as large as 512 KB.
- Page 10 Number of physical blocks is 8,192. If each of them are rewritten 3,000 times: 8,192 × 3,000 = 24,576,000 times In other words, if writing one-byte data per time, the life will end when writing 18.4MB. (Actually, SSD promotes efficiency of such writes). Furthermore, if assuming that for writes of 512 KB in size, a block segment does not overlap the border of 512 KB, it will be one write, whereas in fact, file access by OS may start writing in the middle of the block, so even if a write of 512 KB or less is written twice with a 50% probability.
-
Page 11: About Sim Cards
SIM adapter is used will be subject to repair on an at-cost basis. 2-4 eMMC storage partition information Partition information of eMMC used for this product is as follows: ●In the case of OpenBlocks IoT VX2 Number Format Size... -
Page 12: Storage Mode
2-5 Storage mode Operation is conducted by referring to basic user land data from eMMC. Should an unexpected power interruption occur, there is a risk of damage to files in physical storage, but for Docker and other applications, data in storage are referenced by unionfs, thereby securing normal operation. -
Page 13: Connecting Pc To Openblocks Iot Family
2-6. Connecting PC to OpenBlocks IoT Family The OpenBlocks IoT Family and a PC are connected via an accessory USB cable. The OpenBlocks IoT VX series must be supplied with power via an AC adapter or a wide-range power supply input. In the case of a Windows PC, connection to a USB port will automatically install a USB serial driver (if Windows PC is connected to an Internet environment). -
Page 14: Web Ui
2-7. WEB UI To enable basic system setup, this system is installed with WEB UI. Use WEB UI to set up networks and control mobile networks. In addition, WEB UI enables various functions to be added. Please refer to the WEB UI Set-up Guide for basic use, etc. -
Page 15: Chapter 3 Using The Openblocks Iot Family
Chapter 3 Using the OpenBlocks IoT Family The OpenBlocks IoT Family is a general-purpose server product employing Debian GNU/Linux. The OpenBlocks IoT Family can be used in the same way as with a regular Debian product. This Chapter describes information that is particular to the OpenBlock IoT Family. 3-1. - Page 16 Status Color Illumination Remarks status enabled by FUNC button displaying that mobile network or SIM slot is not used. Terminating OS Yellow Illuminating This indication is shown when an initial Initial trial to access access to AirManage remote control server Illuminating AirManage failed has failed.
- Page 17 Line Setting description Remarks 1st line Illumination hours 1 or more (msec) 2nd line Illumination hours 1 or more (msec) 3rd line Illumination #1 color Refer to table below. 4th line Illumination #2 color Refer to table below. (If omitted: 0) Color # Color illuminated...
-
Page 18: Modem Control For Mobile Networks
3-2. Modem control for mobile networks A tool to check the power ON/OFF state of module installed in this unit and radio wave state is provided. Command name: atcmd Startup method 1: atcmd [Command] Startup method 2: atcmd [Command 1] [Command 2] [Command 3] Startup method 3: atcmd -d [Device file] [Command] As shown in Startup method 2, it is possible to list commands and execute them in sequence. - Page 19 When constantly obtaining radio wave status, WEB UI will occupy the device file. For this command, designate a device file not used by WEB UI and execute it. In an environment or user control not using WEB UI, this restriction will not apply. Please note that depending on module in use, the device files that can be used by atcmd will differ.
-
Page 20: On-Demand Connections
3-3. Mobile network connection It can control the mobile line's modem using the Service network (Mobile line) menu in the [Network]-[Basic] tab in WEB UI. The OpenBlocks IoT Family supports a method to make a connection to mobile networks whenever necessary through control by WEB UI (On-demand connections), and a method to make a connection by the user fully excluding control by the modem. -
Page 21: User Control Of Mobile Network Modem
Below is a sample of a combination of the above commands, meaning: 1. Connect to mobile network. 2. Execute ping command to DNS server. 3. Disconnect from mobile network. #!/bin/bash echo "#------------------------------------------------------------#" echo "# Connect (`date`)" echo "#------------------------------------------------------------#" /var/webui/scripts/mobile_control.sh con 1 sleep 2 echo ""... - Page 22 To implement this item, check "Display the modem control items." The following information is required for settings: ・ Modem control: Choose "User control." ・APN ・Username ・Password ・Authentication method Information set up via WEB UI can be reflected upon modem using the following command: ●Command to reflect modem settings # /var/webui/scripts/setapn.sh Config.
- Page 23 Variable Description Remarks method modem_ppp0_provier Provider name designated PON/POFF command DEVICE_CONNECT Device file for mobile Will be /dev/ttyACM[0-9]*. network connections DEVICE_SETTING Device file for mobile Will be /dev/ttyACM[0-9]*. network connections ●Sample settings modem_ppp0_apn="iixxxx.jp" modem_ppp0_user="test@iixxxx" modem_ppp0_pass="xxxx" modem_ppp0_authtype="PAP" modem_ppp0_provier="usermobile" With each of the following commands, can connect to or disconnect from mobile network. ●Command for mobile network connection # pon <modem_ppp0_provier>...
-
Page 24: Backup
3-4. Backup When customizing the file syatem etc, It can back up the file system that will be booted as Normal boot mode, to TGZ format file in following. 1. Rebooting the unit # sync # reboot 2. Startup in emergency boot mode For the OpenBlocks IoT VX series, choose "Emergency boot"... -
Page 25: Restoration
3. Deletion of unnecessary data and backup obsiot login: root Password: root # mount /dev/mmcblk0p2 /mnt *Delete files particular to hardware, etc. below /mnt. BT information is deleted. # rm -rf /mnt/var/lib/bluetooth/* # cd /mnt # tar --exclude=lost+found --exclude=<tgz filename> -cpzf <tgz filename> . /mnt/<tgz file>... -
Page 26: Applications
3-6. Applications In emergency boot mode, in addition to a backup file, it is possible to run a script, etc. by preparing a file with a designated name as a volume label in DEB_CONFIG. This will be effective only if a file actually exists. ・init.sh (sh script;... -
Page 27: Web Ui Extensions
3-7. WEB UI extensions As an extension in the [Extension] tab in WEB UI, the following are available. 3-7-1. Script editing Choose the [Extension] –[Edit Scripts] tab to create and edit the following scripts from WEB ・Startup scripts ・Exit scripts ・User-defined scripts 1-5 ・User-defined scripts (Button) Please note that this function depends on... -
Page 28: Command Execution
3-7-2. Command execution Use the [Extension]-[Command exec.] tab, can execute a command of one line or so. When executing a command, response results will be displayed. Please note that if executing a command that is permanently run in the foreground with this function, will not obtain web response. -
Page 29: Switching Boot Modes
3-8 Switching boot modes Can set up boot mode at the next startup using the [Maintenance]-[Boot switch] tab . At the time of normal factory shipment, only one boot mode can be selected. rewriting part /dev/mmcblk0p1/EFI/boot/bootx64.conf file, can show boot modes here. However, selectable boot modes mean a risk to actual operations, for example, restoring setting to factory condition. -
Page 30: Sending Sms Messages
What is described in this section is a shell script. Edit with iptables command as appropriate. 3-11. Sending SMS messages If the unit uses WEB UI, is equipped with a modem module (other than an LTE module (KDDI)) and is inserted with a SIM card that can send SMS messages, it is possible to send SMS messages from the command line. - Page 31 ●Command to switch to external SIM mode # /var/webui/scripts/kym_set_mode.sh out 31/39...
-
Page 32: Factory Reset (Reset To Condition At Time Of Factory Shipment)
3-13. Factory Reset (Reset to condition at time of factory shipment) With the OpenBlocks IoT VX series, if a package has been added to the storage domain or if important data has been deleted and to reset the unit to the condition at the time of factory shipment, choose "Factory Image"... -
Page 33: Recovery Startup
3-14. Recovery startup A file system for recovery is prepared for the case where the file system used for normal startup is damaged and can not be started. With the OpenBlocks IoT VX series, choose "Emergency boot" from the GRUB menu to start up the unit in the RAMdisk mode. -
Page 34: Automatic External Storage Mounting In Web Ui
3-16. Automatic external storage mounting in WEB UI If WEB UI finds storage devices with specific volume labels, they will be automatically mounted. Please use this function to manage storage using WEB UI functions, etc. Volume label Mounting destination Supplement WEBUI_STORAGE /var/tmp/storage Use the NTFS file system. -
Page 35: Recommended Device Files To Use
3-17. Recommended device files to use With Linux, each device file is assigned with a name in the order of recognition. For this reason, device files may differ depending on the power ON/OFF conditions of devices. As device file links are setup for individual models, to access device files, use the following recommended device files. -
Page 36: Chapter 4 Product Specifications
Chapter 4 Product specifications 4-1. Open Blocks IoT VX2 main body specifications Model # OBSVX2 Model Intel Atom E3805 Clock speed 1.3 GHz (dual core) Built-in secondary 1024 kB/Core cache Main memory On-board 2 GB (64 bit bus DDR3L) Built-in storage 32 GB (eMMC) Additional storage 1 x MMC slot... -
Page 37: Openblocks Iot Vx Series Options
Environmental protection Conforms to RoHS Directives Authentication JATE/ TELEC RTC backup time 10 years OS at the time of shipment Debian GNU/Linux *1: Energy Consumption Efficiency is measured power consumption (Measurement method defined by the Act Concerning the Rational Use of Energy) divided by composite theoretical performance, as defined by the Act Concerning the Rational Use of Energy. -
Page 38: Chapter 5 Cautions And Supplementary Information
Chapter 5 Cautions and supplementary information 5-1. Countermeasures against delays due to script processing When writes to storage are made using init.sh and post-init.sh scripts in emergency boot mode, a next command process may be implemented before writing is complete. For this reason, expressly execute sleep and sync commands. - Page 39 OpenBlocks IoT Family Developer Guide Version 3.1.0 (May 31, 2018) Plat'Home Co., Ltd. NIHON BUILDING KUDANBEKKAN, 3F 4-2-3, Kudankita, Chiyoda-ku, TOKYO 102-0073, JAPAN 39/39...
Need help?
Do you have a question about the OpenBlocks IoT VX2 and is the answer not in the manual?
Questions and answers