APIÕûºÏ

How to Integrate with SmartOWONTM Platform


By offering the Mobile APP Software Development Kit (SmartOWONTM APP SDK), the System Communication Protocol Interface (SmartOWONTM System CPI), and the ZigBee Application Program Interface (SmartOWONTM ZigBee API), OWON's partners are allowed to create and maintain their own software ecosystem from scratch on top of OWON's hardware platform, and further tailor their system with unique features and user's experience for  various applications. OWON's partners could choose from the below THREE options in designing their own system based on OWON's platform, or integrate OWON' s hardware system into their existing system.


Option A. Mobile APP Software Development Kit (SmartOWONTM  APP SDK)

Based on OWON's hardware platform (Smart Gateway + surrounding devices) and its existing Cloud Server solution, the APP SDK allows you to design your own Android/iOS mobile APP the way you want.It is exactly the same Development Kit OWON deployed in designing its own Mobile APP, which makes it a fully verified and thoroughly tested source to create a reliable new APP.

Tips:

    • Don't bother with the hardware and Cloud Server solution, you could simply focus on creating the most attractive and userfriendly APP that suits your application scenario.

    • You could even deploy OWON's Cloud Server application on your own Cloud Server Space, and manage the entire backend system by yourself.


Option B. System Communication Protocol Interface (SmartOWONTM  System CPI)

The System CPI describes both the communication protocol and data contents between the Smart Gateway, the Cloud Server and the Mobile APPs, which enables you to construct the entire software ecosystem from scratch on top of OWON's hardware platform. It also allows you to integrate OWON's hardware platform with your existing system. The CPI describes: 

    • General: TCP/IP protocol, communication ports, JSON data format, requests callback mechanism, timeout mechanism, etc.

    • Local Area Network: system login, Wi-Fi network configuration, ZigBee network management, device management, etc.

    • Functional Application: upstream status reports and downstream control commands to and from each specific surrounding device.

    • Wide Area Network: online registration, system login, account management, communication heartbeat, time synchronization, etc.


Option C. ZigBee Application Program Interface (SmartOWONTM  ZigBee API) 

OWON's Smart Gateway is equipped with a ZigBee module, a Micro-Processor and an IP-based communication unit (WiFi,Ethernet or GPRS). By following the standard of ZigBee Pro and ZHA profile, the ZigBee module is responsible for the ZigBee network management and specific communication with each surrounding device within the network; while the IP-based communication unit is the contact window of the Smart Gateway interfacing with the mobile APP and the Cloud Server. Therefore,the Gateway Application Firmware running on the Micro-Processor, plays a crucial role of mirroring the complicated ZigBee Local Area Network to an IP-based single device, thus to be accessed by the universal network technologies. The ZigBee API provides an intermediate interface between the ZigBee module and the Micro-processor allowing a developer to design the Gateway Application Firmware even without any ZigBee knowledge. By using the ZigBee API, you will be able to:

    • Manage the ZigBee Network such as enable/disable new devices to join the network, discover available devices, create device list, collect devices information, etc.

    • Manage ZigBee devices such as add/remove devices from the network, identify and address devices within the network,rename device, maintain network address, update device information, etc.

    • Control or monitor ZigBee devices: address a specific ZigBee device within the ZigBee network so as to be accessed by the application layer, conduct downstream command to the device, collect application data from the devices; etc.

Tips: 

    • Like ZigBee, but don¡¯t know too much about it? Now, you could use the ZigBee API to create your own ZigBee system by developing your own Gateway Application Firmware on top of OWON's Smart Gateway, from where you can further develop your Cloud Server and Mobile APP freely. This would significantly save your efforts and investment in digesting the ZigBee technology, while still give you the maximum flexibility of designing a system as you wish.

    • OWON will be continuously upgrading the ZigBee API to keep up with your system expansion.



SmartOWONTM System Architecture


OWON's HASS6000 is an off-the-shelf Smart Home System including FIVE functional modules: Security, Home Automation, Comfort, Video Surveillance and Energy Management. The system is consist of FOUR key elements: a ZigBee Smart Gateway,surrounding ZigBee devices, Cloud Server and Mobile APPs. While SmartOWONTM is the complete technical platform behind the scene that covers each segment of this IoT solution including: 

    • Reliable ZigBee Local Area Network backed with mature Node Management Technology.

    • Finished integration with various surrounding ZigBee Home Automation and Security devices.

    • Complete ZigBee to IP conversion to ease the design at the application level without ZigBee knowledge        required.

    • Open interface and detailed documentation at each layer to facilitate system integration at different levels.


HASS 6000 System Architecture.png


The Smart Gateway is equipped with both ZigBee and Wi-Fi connectivity, which integrates all ZigBee devices within the Local Area Network following ZigBee Home Automation Profile 1.2 (ZHA1.2), and connects to mobile devices through Wi-Fi following TCP/IP communication protocol. This creates the persistent connections between all different elements to allow reliable and real-time system performance.



SmartOWONTM platform offers THREE communication modes between the Smart Gateway and the mobile devices: 


blob.png

The mobile device logs onto the Smart Gateway (using the Smart Gateway's SSID and password under its AP mode), and then connects to the Smart Gateway directly even without a home router.

  


Both the Smart Gateway and the mobile device log onto the same Wi-Fi router and discover each other through UDP broadcasting; the mobile device then connects to the Smart Gateway locally via the Wi-Fi router without the involvement of a Cloud Sever.

e.png

The Smart Gateway registers to the Cloud Server through a home router, while the mobile device also logs onto the Cloud Server via an Internet connection. The mobile device will then be able to access to a designated Smart Gateway by addressing its unique device ID from distance.