Skip to main content

BN Adjustable Bed Mock API and Socket Interface

Project description

BN Adjustable Bed Mock API and Socket Interface

This project is not an official project of, and is in no way affiliated with, Blissful Nights or the Ronin Wifi mobile app

codecov pre-commit.ci status CI Release PyPI version

image image

This project sets up an HTTP API and Socket Interface for the Blissful Nights Wall Hugger Adjustable Bed with Massage and Alexa Voice Command.

I can control the bed using the HTTP API or the mobile app without having anything connected to the official servers hosted in AWS.

I have the HTTP API hooked up to my iOS Shortcuts which allows me to use it in my automation.

Not all of the socket communication protocol is understood, but enough of it has been reverse engineered to provide this functionality.

Docker Hub Links

How to Use

To use it, you must hijack the DNS queries for cm2.xlink.cn and api2.xlink.cn and redirect them to your server.

api2.xlink.cn is used by the Ronin WiFi mobile app [ ios | android ].

cm2.xlink.cn is used by the bed. The bed creates a persistent socket connection to this address.

Use of the mobile app is required to perform the initial setup and get the bed hooked up to your wireless network. Once you have it setup, use of the mobile app is optional.

Mobile App API

The HTTP API is exposed on port 80 and provides endpoints that will allow you to log into the app without creating an account.

Setup

  1. An example Docker Compose Config File is provided. It uses a default bridge network for communcation to the redis instance and configures the other 3 services to use an IP on a macvlan network named lan. Change <IP> in the example file based on your network, they all need to be unique. If you prefer, you could use the main Docker Compose Config File used for development as a start, it uses the default network and exposes the service ports through a single IP instead. In this case the Bed Controller API will be on port 8080 instead of 80.

  2. Setup a directory for the services and run Docker Compose to start the 4 services (Redis, App API, Bed Socket Interface and Controller API).

mkdir bn-adjustable-bed

cd bn-adjustable-bed

wget https://github.com/trevorlauder/bn-adjustable-bed/blob/main/docker-compose.yml.example -O docker-compose.yml

# adjust <IP> and config for your network

docker-compose up
  1. Hijack DNS queries to api2.xlink.cn and cm2.xlink.cn on your network so that they resolve to the IP address of your docker services. If you're using separate IP's for each service, api2.xlink.cn should be pointed at the app-api service and cm2.xlink.cn should be pointed at the bed-socket service.

  2. Log into the Ronin Wifi mobile app using any email address and password, neither need to be valid. Make sure your mobile device is connected to your network so that is resolves your hijacked domains properly.

  3. Select My Bed from the menu and then Connect new bed

    • Follow the instructions in the app to "Long press the Foot Up and Down buttons for 5 seconds until you hear a beep every 3 seconds". Click Next

    • Connect your mobile device to the KeesonAp-XXXXXXXXXX Wireless SSID. Click Next

    • Continue with the instructions and provide the Wireless network credentials for the network you wish to connect the bed to.

    • The bed will beep a couple times and connect to your Wireless Network. The bed should show up shortly in the list with an option to Connect. Skip this part as not enough of the communications protocol has been reverse engineered at this point for the app to completely perform the setup. At this point you can force quit the app and re-open it, you should be able to control the bed now and see it in the list of beds.

Bed Controller API

The Bed Controller API is exposed on port 80 and provides an endpoint that allows you to send commands to the bed.

This can be easily added to Siri Shortcuts or similar tools to add bed control to whatever automation platform you use.

# Tell the bed to move to the flat position
curl -X 'PUT' \
  'http://bn-adjustable-bed-controller.changethistoyourdomain.com/command?name=flat' \
  -H 'accept: application/json'

# Tell the bed to move to the Zero-G position
curl -X 'PUT' \
  'http://bn-adjustable-bed-controller.changethistoyourdomain.com/command?name=zero_g' \
  -H 'accept: application/json'

# Tell the bed to move to the Preset I position
curl -X 'PUT' \
  'http://bn-adjustable-bed-controller.changethistoyourdomain.com/command?name=preset_one' \
  -H 'accept: application/json'

# Tell the bed to move to the Preset II position
curl -X 'PUT' \
  'http://bn-adjustable-bed-controller.changethistoyourdomain.com/command?name=preset_two' \
  -H 'accept: application/json'

# Tell the bed to move to the Preset III position
curl -X 'PUT' \
  'http://bn-adjustable-bed-controller.changethistoyourdomain.com/command?name=preset_three' \
  -H 'accept: application/json'

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bn-adjustable-bed-1.3.14.tar.gz (12.3 kB view details)

Uploaded Source

Built Distribution

bn_adjustable_bed-1.3.14-py3-none-any.whl (15.6 kB view details)

Uploaded Python 3

File details

Details for the file bn-adjustable-bed-1.3.14.tar.gz.

File metadata

  • Download URL: bn-adjustable-bed-1.3.14.tar.gz
  • Upload date:
  • Size: 12.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.11 CPython/3.10.7 Linux/5.15.0-1020-azure

File hashes

Hashes for bn-adjustable-bed-1.3.14.tar.gz
Algorithm Hash digest
SHA256 27e3384b407cd7cfff113d6cd9b87890b08172284b3c593e1689b4c2d8439bad
MD5 9dba9375c2461bc9aa47cebff2e5a30c
BLAKE2b-256 584edee8bde84b5deb9cd0197a048ec69b33832796e2f142402514d0a5e99491

See more details on using hashes here.

File details

Details for the file bn_adjustable_bed-1.3.14-py3-none-any.whl.

File metadata

  • Download URL: bn_adjustable_bed-1.3.14-py3-none-any.whl
  • Upload date:
  • Size: 15.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.11 CPython/3.10.7 Linux/5.15.0-1020-azure

File hashes

Hashes for bn_adjustable_bed-1.3.14-py3-none-any.whl
Algorithm Hash digest
SHA256 cf36cc182095f9598b88e4438dbd47b9a96b8ffbc12f2d1d952973ae1600032c
MD5 e4917e4b928539e02182f70f603c9232
BLAKE2b-256 d64ed9bc98fa5d23158b5049e25a183a841aa4de5af796c3baca00dda2341bef

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page