A simple implementation to talk to OpenPeak OpenFrame devices. The code might be messy, but it works. Thanks to everyone over at jogglerwiki.com

Using:

• Bootstrap (License)
• PrismJS (License)
• Font Awsome (License)

cd /var/www/html/
sudo wget https://github.com/brazier/oophs/archive/refs/heads/main.zip
sudo unzip -j main.zip
sudo mkdir devicefiles
sudo chown www-data:www-data *
sudo rm main.zip

1. Setup a local DNS(e.g. PiHole) and point services.openpeak.net to your servers local IP-address, and add your DNS IP-address to you DHCP server.

2. Install Apache with mod_rewrite and mod_ssl.

   SSL might not be needed as others have reported uisng standard HTTP on port 443 instead, and others have been able to use a standard SSL config. There exists different devices running different software from different vendors. This is what was needed on mine running software from "Telio"

   sudo apt install apache2 libapache2-mod-php8.2 openssl
   sudo s2enmod ssl
   sudo a2enmod rewrite
   

3. Generate a self signed cert and key:

   sudo mkdir -p /etc/ssl/localcerts
   sudo openssl req -new -x509 -days 365 -noenc -out /etc/ssl/localcerts/apache.pem -keyout /etc/ssl/localcerts/apache.key
   sudo chmod 600 /etc/ssl/localcerts/apache*
   

4. Edit sites-enabled/default-ssl.conf

   SSLCertificateFile      /etc/ssl/localcerts/apache.pem
   SSLCertificateKeyFile   /etc/ssl/localcerts/apache.key
   

5. Change ssl.conf to make it accept old ciphers/protocols (source)

   This is usually not adviseable and could pose a security risk on a production server.

   SSLProtocol             -all +TLSv1 +TLSv1.1 +TLSv1.2 +TLSv1.3
   SSLOpenSSLConfCmd       Curves X25519:prime256v1:secp384r1
   SSLCipherSuite          @SECLEVEL=0:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA
   SSLHonorCipherOrder     on
   SSLSessionTickets       off
   

6. Download files to document root of your server and make a folder named 'devicefiles' and make sure the server has write and read permissions to that folder.

7. Go to services.openpeak.net and enter the mac address of the device:

   

   if you dont know you device mac you can check apache logs or look for a [MAC-ADDRESS].heartbeat file in the devicefiles/ folder.

   10.0.0.xx - - [24/Apr/2025:22:31:28 +0000] "GET /dms/device/heartbeat?mac=DE:AD:CA:FE:BA:BE HTTP/1.1" 200 1410 "-" "OpenPeak DMS Client/v0.2"
   

8. Send one of the xml files to the device, and wait for a reply(auto update every 5 second). The device will only run it once

• Whenever a user accesses services.openpeak.net?mac=[MAC-ADDRESS]

  1. Every 5 seconds, updates the "heartbeat" in the top left corner from [MAC-ADDRESS].heartbeat and updates the "Response" field from [MAC-ADDRESS].reply

  2. When "Send" is clicked, writes a number 1-3 to [MAC-ADDRESS].run

     Example [MAC-ADDRESS].run file when "Send command" is choosen:

     3
     cd /some/dir
     

• Whenever a device accesses services.openpeak.net/dms/devices/heartbeat?mac=[MAC-ADDRESS] (ie. heartbeat.php):
  1. A corresponding [MAC-ADDRESS].heartbeat file is made/updated with the current UNIX timestamp inside devicefiles/
  2. If a [MAC-ADDRESS].run exists, output corresponding XML for the device to process. Then delete [MAC-ADDRESS].run

<?xml version="1.0" encoding="UTF-8"?>
<command>
   <postDeviceDetails url="" method="post" />
</command>

The openframe will resond to the url specified with a HTTP POST request with the following XML:

<?xml version="1.0" encoding="utf-8"?>
<deviceDetails version="0.5" build_num="0.2" build_date="Wed Nov 19 14:22:45 2014">
 <configuration>
  <device>
   <telnetEnabled>true</telnetEnabled>
  </device>
 </configuration>
 <hw-unitsn>32092730848</hw-unitsn>
 <hw-pcbsn>H0EWFX3Y40T2</hw-pcbsn>
 <hw-rev>32</hw-rev>
 <hw-type>8047</hw-type>
 <bios-core>04.06</bios-core>
 <bios-project>00.05</bios-project>
 <partitions total="4">
  <partition name="mmcblk0p4" free="946712" total="1057728"/>
  <partition name="mmcblk0p3" free="198132" total="443392"/>
  <partition name="mmcblk0p2" free="208719" total="443392"/>
 </partitions>
 <standby-rfs>mmcblk0p2</standby-rfs>
 <active-rfs>mmcblk0p3</active-rfs>
 <bootloader-ver>7596</bootloader-ver>
 <net-intfs>
  <net-intf ip-addr="10.0.0.2"/>
 </net-intfs>
 <mac-addr>DE:AD:CA:FE:BA:BE</mac-addr>
 <psoc-8051>0008</psoc-8051>
 <arch>Intel</arch>
 <product-tag>openframe</product-tag>
 <firmware-ver>8964</firmware-ver>
 <software-ver>38510</software-ver>
 <client-tag>telio</client-tag>
 <os>Openpeak Version: 1.0.000 Nov 19 2014:14:22:29</os>
 <device-id>0</device-id>
</deviceDetails>