Power ----- The ptBox requieres 5-30V input via a LP12 M12 power plug which is provided. **Turn On** To turn on the ptBox click one on the power button (see `Specifications`_). \ If it is the first time the ptBox has been turnned on, \ it will start in Maintenance mode (see next section `Operation Modes`_) **Turn Off** To turn OFF the ptBox click the power button for 10 seconds. .. _Operation Modes: Operation Modes --------------- The ptBox has different operation modes. The main mode is "Cycling", \ while on this mode the ptBox turns on at predefined times, performs predefined \ actions and turns-off. When it is desired to access the ptBox, it is necessary \ to stop the cycling mode and change it to "Maintenance" in this mode the \ ptBox will stop the cycle and be ready for access. **Cycle mode** This is the main ptBox mode, while in this mode, it will turn on at predefined \ times and will execute certain commands once done, it will shutdown. On starting it will invoke the script /home/pt/ptBox_Start.sh. However, if it \ is desired to change the behavior and invoke specific commands you can modify \ the script in /home/pt/mode/run_ptBox_cycle.sh **Maintenance Mode** Depending on the task performed during cycling mode, the ptBox might be ON only \ for a short period of time, making it difficult to access it. If it is desired to work on the ptBox software and have it ON for a longer period \ of time, the ptBox can be put in "Maintenance" mode. 3 main things take place when in Maintenance mode: 1. The cycle mode will be interrupted. 2. TeamViewer will be activated for remote access. 3. A hotspot will be created with the same name as the ptBox. 4. A timeout of 30 minutes is setup. After this time the ptBox will automatically restart in cycling mode. There are 2 ways to bring the ptBox into maintenance mode, via FTP when the user \ is not close to the ptBox and using an USB stick prepared with the maintenance \ mode configuration. .. _Maintenance mode via FTP: **Maintenance mode via FTP** Every cycle the ptBox looks inside the FTP folder for a configuration_file, \ if it finds the file, it will updated its configuration accordingly. To go into \ maintenance mode the following field in the configuration file should be set to "M": .. code-block:: console "ptBox_mode" : "M" Inside the FTP a folder the following subfolder structure should exist: | FTP | --- ptBox_config | ---trigger_files | ---ptBox-xxxxx_config.json In order to go into Maintenance mode the file has to be moved up to the parent \ folder: trigger files The content of the file ptBox-xxxxx_config.json is described in: `Configuration file`_ For more information on how to access the ptBox see the section `Access`_ .. _Configuration file: Configuration file ------------------ The configuration should have the following parameters in JSON format: .. code-block:: console { "ptBox_mode" : "C", "reboot_timeout" : 30, "cycle_period" : 30, "start_time" : 0600, "night_time" : 1700, "video_length" : 5 } - ptBox_mode: C for Cycling M for maintenance - reboot_timeout: time before reboot to cycle mode in minutes [15-60] - cycle_period range: cycle period in minutes [5, 10, 15, 20, 30] - start_time: Hour of the day at which recording is started, [0001-1200] - night_time: Hour of the day at which recording is stopped, [1201-2400] - video_length: video duration in seconds **Update ptBox configuration** Following the same procedure described in `Maintenance mode via ftp`_ can be used to \ update any parameter described in this section. .. _Access: Access ------ The ptBox can be accessed via SSH, VNC or Teamviewer **Connect via to the RPi via SSH** Connecting to the ptBox using SSH it is possible via Ethernet cable, hotspot or \ a VPN. Using Ethernet cable: 1. Connect the ethernet port to the network 2. On the linux PC change the network settings IPV4 to Link-local Only 3. On PC type: .. code-block:: console $ ssh pt@ **Connect via VNC** To connect to the ptBox via VNC the following things are necessary: 1. VNC viewer installed in the computer which is going to be used to access the \ ptBox. 2. The ptBox and the viewer computer have to be connected to the same network, or \ the ptBox has to be connected to the PC allowing the Local-Link Now you can connect to the ptBox via VNC: 1. Connect to: ptBox-xxxxx.local 2. Username: pt 3. Password: XXXXXXX If you get the error: 'Cannot Currently Show the Desktop', do: .. code-block:: console $ sudo raspi-config 1. Go to Resolution, change screen resolution: 1280x720 **Connect via TeamViewer** The ptBox comes with teamviewer installed, the only thing needed is to give the \ ID and Password to access it. It is important to notice that teamviewer is only active when the ptBox is in \ maintenance mode. .. _Camera: Camera ------ **Focus** The focus of the camera can be adjusted by changing the parameter "--lens-position" in file ptBox/capture/Picture_Capture.sh. if lens-position = 0 f is inf, lens-position = 5 -> f = 0.2 [0, 10]. Default value is 0 If parameter is missing then the camera is set in autofocus mode. **Image quality** Image quality can be adjusted by changing the parameter "--quality" in file ptBox/capture/Picture_Capture.sh. Default value is 100, range [0, 100]. When this parameter is missing, it seems that the value is around 70 .. _Specifications: Specifications -------------- **Dimensions** - Size (LxWxH): 164 x 124 x 127 mm - Weight: 2.0kg **Operating temperature** - -15°C to 50°C **Power** - Internal Battery: 10Ah, 3.7V, Li-Ion - Power input 5-30V - LP12 M12 power plug **Connectors** - RJ45 ethernet cable **Cameras** - 2 Cameras, one without IR cut for night vision - 12 Megapixels - Focal length: 4.74mm (28mm in 35mm-eq.), 75 degrees (at 16:9), F/1.8 **Computer** - CPU: Broadcom BCM2711 quad-core Cortex-A72 (ARM v8) 64-bit SoC @ 1.5GHz - RAM: 8GB LPDDR4 - Storage: 150GB - WiFi 2.4GHz and 5.0GHz IEEE 802.11b/g/n/ ac - Bluetooth 5.0 **Display** - 296×152, 2.66inch E-Paper E-Ink Display **Modem** - LTE Cat 4 modem incl. GPS/Beidou/GLONASS/GALILEO/QZSS **RF sender** - RF module for sending/receiving over radio frequecies .. image:: images/ptBox_front.png .. image:: images/ptBox_bottom.png