ਸਾਫਟਵੇਅਰ ਦਾ HALO ਸਮਾਰਟ ਸੈਂਸਰ API ਬੇਸਿਕ ਸਾਫਟਵੇਅਰ ਯੂਜ਼ਰ ਗਾਈਡ

ਸਮੱਗਰੀ ਓਹਲੇ

1 ਸਾਫਟਵੇਅਰ ਦਾ HALO ਸਮਾਰਟ ਸੈਂਸਰ API ਬੇਸਿਕ ਸਾਫਟਵੇਅਰ

2 ਅੱਗੇ

7 ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ ਵੇਰਵੇ

8 ਦਿਲ ਦੀ ਧੜਕਣ ਦੇ ਵੇਰਵੇ

9 HTTP (ਅਤੇ HTTPS) ਮੋਡ

ਸਾਫਟਵੇਅਰ ਦਾ HALO ਸਮਾਰਟ ਸੈਂਸਰ API ਬੇਸਿਕ ਸਾਫਟਵੇਅਰ

ਅੱਗੇ

ਇਹ ਦਸਤਾਵੇਜ਼ ਹੈਲੋ ਸਮਾਰਟ ਸੈਂਸਰ ਦੀਆਂ ਸਹੂਲਤਾਂ ਦੇ ਸਮੂਹ ਦਾ ਵਰਣਨ ਕਰਦਾ ਹੈ ਜਿਸਨੂੰ ਸਮੂਹਿਕ ਤੌਰ 'ਤੇ ਬੇਸਿਕ API, ਜਾਂ ਐਪਲੀਕੇਸ਼ਨ ਪ੍ਰੋਗਰਾਮਿੰਗ ਇੰਟਰਫੇਸ ਵਜੋਂ ਜਾਣਿਆ ਜਾਂਦਾ ਹੈ। ਇਹ ਚਰਚਾ ਉਹਨਾਂ ਪ੍ਰੋਗਰਾਮਰਾਂ ਜਾਂ ਏਕੀਕ੍ਰਿਤੀਆਂ ਦੁਆਰਾ ਵਰਤਣ ਲਈ ਹੈ ਜੋ ਇੱਕ ਜਾਂ ਇੱਕ ਤੋਂ ਵੱਧ HALO ਸਮਾਰਟ ਸੈਂਸਰਾਂ (HALOs) ਨੂੰ ਤੀਜੀ ਧਿਰ (ਗੈਰ-IPVideo) ਸੌਫਟਵੇਅਰ ਭਾਗਾਂ ਜਾਂ ਸਿਸਟਮਾਂ ਨਾਲ ਜੋੜਨ ਵਿੱਚ ਦਿਲਚਸਪੀ ਰੱਖਦੇ ਹਨ। ਆਮ ਤੌਰ 'ਤੇ, HALO API ਦਾ ਉਦੇਸ਼ HALO ਤੋਂ ਇੱਕ ਰਵਾਇਤੀ ਈਥਰਨੈੱਟ ਨੈੱਟਵਰਕ ਰਾਹੀਂ ਬਾਹਰੀ ਪ੍ਰੋਗਰਾਮ ਵਿੱਚ ਜਾਣਕਾਰੀ ਨੂੰ ਕੁਸ਼ਲਤਾ ਨਾਲ ਟ੍ਰਾਂਸਫਰ ਕਰਨਾ ਹੈ। ਇਸ ਟੀਚੇ ਨੂੰ ਪੂਰਾ ਕਰਨ ਲਈ, API ਨੂੰ ਤਿੰਨ ਭਾਗਾਂ ਵਿੱਚ ਵੰਡਿਆ ਗਿਆ ਹੈ: ਇਵੈਂਟ ਡਰਾਈਵ ਸਾਕਟ ਕਨੈਕਸ਼ਨ, ਹਾਰਟਬੀਟ ਸਾਕਟ ਕਨੈਕਸ਼ਨ, ਅਤੇ ਇਵੈਂਟ ਡੇਟਾ URL. BACnet ਇੰਟਰਫੇਸ ਵੀ ਮੌਜੂਦ ਹੈ ਅਤੇ ਇੱਕ ਵੱਖਰੇ ਦਸਤਾਵੇਜ਼ ਵਿੱਚ ਕਵਰ ਕੀਤਾ ਗਿਆ ਹੈ।

API ਡਿਜ਼ਾਈਨ

API ਨੂੰ ਉਦਯੋਗਿਕ ਮਿਆਰੀ ਫਾਰਮੈਟਾਂ ਜਿਵੇਂ ਕਿ TCP/IP ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਡਿਜ਼ਾਈਨ ਕੀਤਾ ਗਿਆ ਹੈ। HTTP, HTTPS, ਅਤੇ JSON। ਡਿਜ਼ਾਈਨ ਨੂੰ ਬਾਹਰੀ ਪ੍ਰੋਗਰਾਮ ਜਾਂ ਐਪਲੀਕੇਸ਼ਨ ਦੇ ਵਿਕਾਸ ਵਿੱਚ ਵਰਤੇ ਜਾਣ ਲਈ ਕਿਸੇ ਵਿਸ਼ੇਸ਼ ਜਾਂ ਮਲਕੀਅਤ ਵਾਲੀਆਂ ਤਕਨੀਕਾਂ ਜਾਂ ਲਾਇਬ੍ਰੇਰੀਆਂ ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ। API ਲਚਕਦਾਰ ਹੈ ਅਤੇ ਲੋੜੀਂਦੇ ਡੇਟਾ ਨੂੰ ਸਭ ਤੋਂ ਪ੍ਰਭਾਵਸ਼ਾਲੀ ਢੰਗ ਨਾਲ ਪ੍ਰਦਾਨ ਕਰਨ ਲਈ ਸੰਰਚਿਤ ਅਤੇ ਪ੍ਰੋਗਰਾਮ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। ਉਪਰੋਕਤ ਭਾਗਾਂ ਵਿੱਚੋਂ ਹਰੇਕ ਦੇ ਸੰਚਾਲਨ ਦੇ ਵੇਰਵੇ ਇਸ ਗਾਈਡ ਦੇ ਹੇਠਾਂ ਦਿੱਤੇ ਭਾਗਾਂ ਵਿੱਚ ਸ਼ਾਮਲ ਕੀਤੇ ਗਏ ਹਨ।

ਬਾਹਰੀ ਸੁਨੇਹਾ

ਇਹ ਸਹੂਲਤ ਅਲਰਟ ਜਾਂ ਅਲਾਰਮ ਅਤੇ ਇਵੈਂਟ ਡੇਟਾ ਨੂੰ ਬਾਹਰੀ ਪ੍ਰੋਗਰਾਮ, VMS ਸਿਸਟਮ, ਸਰਵਰ, ਆਦਿ ਨੂੰ ਪ੍ਰਦਾਨ ਕਰਨ ਲਈ ਵਰਤੀ ਜਾਂਦੀ ਹੈ ਜਦੋਂ ਕੋਈ ਇਵੈਂਟ ਚਾਲੂ ਹੁੰਦਾ ਹੈ (ਸੈੱਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ)। ਜਦੋਂ ਕੋਈ ਇਵੈਂਟ ਕਲੀਅਰ ਹੁੰਦਾ ਹੈ (ਰੀਸੈੱਟ ਹੁੰਦਾ ਹੈ) ਤਾਂ ਵਿਕਲਪਿਕ ਸੁਨੇਹਿਆਂ ਨੂੰ ਸੰਕੇਤ ਦੇਣ ਲਈ ਵੀ ਸਮਰੱਥ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। ਇਹ ਡਿਲੀਵਰੀ ਇੱਕ TCP/IP ਸਾਕਟ ਜਾਂ HTTP/S ਸਰਵਰ ਨੂੰ ਰੀਅਲ ਟਾਈਮ ਵਿੱਚ ਕੀਤੀ ਜਾ ਸਕਦੀ ਹੈ। ਅਨੁਕੂਲਿਤ ਸਮੱਗਰੀ ਦੇ ਨਾਲ ਕੌਂਫਿਗਰੇਬਲ ਪ੍ਰੋਟੋਕੋਲ ਦੀ ਇੱਕ ਸੀਮਾ ਹੈ। ਪ੍ਰਮਾਣਿਕਤਾ ਅਤੇ ਏਨਕ੍ਰਿਪਸ਼ਨ ਉਪਲਬਧ ਹਨ।

ਦਿਲ ਦੀ ਧੜਕਣ

ਲਾਈਵ/ਉਪਲਬਧਤਾ ਦਾ ਸਬੂਤ ਪ੍ਰਦਾਨ ਕਰਨ ਲਈ ਦਿਲ ਦੀ ਧੜਕਣ ਦੇ ਸੁਨੇਹੇ ਇੱਕ ਸੰਰਚਨਾਯੋਗ ਅੰਤਰਾਲ 'ਤੇ ਭੇਜੇ ਜਾਂਦੇ ਹਨ (ਇਸਦੀ ਬਜਾਏ ਜਦੋਂ ਇਵੈਂਟ ਸ਼ੁਰੂ ਹੁੰਦੇ ਹਨ)। ਉਹਨਾਂ ਕੋਲ ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ ਵਰਗੀਆਂ ਸਮਰੱਥਾਵਾਂ ਦੀ ਸੀਮਾ ਹੈ ਪਰ ਆਮ ਤੌਰ 'ਤੇ ਕਿਸੇ ਖਾਸ ਘਟਨਾ ਬਾਰੇ ਵੇਰਵਿਆਂ ਦੀ ਬਜਾਏ ਆਮ ਸਥਿਤੀ ਦੀ ਜਾਣਕਾਰੀ ਰੱਖਣ ਲਈ ਕੌਂਫਿਗਰ ਕੀਤਾ ਜਾਵੇਗਾ।

ਇਵੈਂਟ ਡੇਟਾ URL

ਇਹ ਸਹੂਲਤ ਕੇਵਲ ਇੱਕ NDA ਦੇ ਅਧੀਨ ਉਪਲਬਧ ਹੈ ਅਤੇ ਕੇਵਲ ਉਦੋਂ ਹੀ ਵਰਤੀ ਜਾਣੀ ਚਾਹੀਦੀ ਹੈ ਜਦੋਂ ਬਾਹਰੀ ਪ੍ਰੋਗਰਾਮ ਨੂੰ ਕਿਸੇ ਵੀ ਅਤੇ ਸਾਰੇ ਇਵੈਂਟ ਮੁੱਲਾਂ, ਥ੍ਰੈਸ਼ਹੋਲਡਾਂ, ਅਤੇ ਰਾਜ ਝੰਡਿਆਂ ਤੱਕ ਪਹੁੰਚ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ। ਇਹ ਡੇਟਾ ਆਮ ਤੌਰ 'ਤੇ ਬਾਹਰੀ ਪ੍ਰੋਗਰਾਮ ਦੁਆਰਾ ਮੰਗ 'ਤੇ ਪ੍ਰਾਪਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਪਰ ਬਹੁਤ ਜ਼ਿਆਦਾ ਬਾਰੰਬਾਰਤਾ 'ਤੇ ਨਹੀਂ। ਜਦੋਂ ਇੱਕ ਮਾਮੂਲੀ ਪੋਲਿੰਗ ਦਰ ਵਰਤੀ ਜਾਂਦੀ ਹੈ ਤਾਂ ਇਹ ਵਿਧੀ ਆਮ ਤੌਰ 'ਤੇ ਕੁਝ ਲੇਟੈਂਸੀ ਲੈਂਦੀ ਹੈ। ਆਮ ਪੋਲਿੰਗ ਦਰਾਂ ਇੱਕ ਵਾਰ ਪ੍ਰਤੀ ਮਿੰਟ ਤੋਂ ਲੈ ਕੇ ਇੱਕ ਵਾਰ ਪ੍ਰਤੀ 5 ਸਕਿੰਟ ਤੱਕ ਹੁੰਦੀਆਂ ਹਨ ਜਿਸਦੀ ਵੱਧ ਤੋਂ ਵੱਧ ਦਰ ਪ੍ਰਤੀ ਸਕਿੰਟ ਇੱਕ ਵਾਰ ਹੁੰਦੀ ਹੈ। ਜਦੋਂ ਕੋਈ ਇਵੈਂਟ (ਸੁਚੇਤਨਾ) ਪ੍ਰਾਪਤ ਹੁੰਦਾ ਹੈ ਤਾਂ ਇਹ ਵਿਧੀ ਵਾਧੂ ਸਹਾਇਕ ਡੇਟਾ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਵੀ ਵਰਤੀ ਜਾ ਸਕਦੀ ਹੈ।

ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ ਵੇਰਵੇ

HALO ਦਾ ਇੱਕ ਭਾਗ web ਇੰਟਰਫੇਸ ਏਕੀਕਰਣ ਪੌਪਅੱਪ ਇੱਕ ਸਿੰਗਲ ਤੀਜੀ ਧਿਰ ਕੁਨੈਕਸ਼ਨ ਦੀ ਸੰਰਚਨਾ ਲਈ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ ਜਿੱਥੇ ਕਈ ਮੁੱਲ ਇੱਕ ਰਿਮੋਟ TCP ਸਾਕਟ ਜਾਂ ਇੱਕ HTTP/HTTPS ਸਰਵਰ ਨੂੰ ਭੇਜੇ ਜਾ ਸਕਦੇ ਹਨ। ਪਲੇਸ ਹੋਲਡਰ (ਟੋਕਨ) ਦੀ ਵਰਤੋਂ ਪ੍ਰਸਾਰਿਤ ਟੈਕਸਟ ਵਿੱਚ ਲਾਈਵ ਮੁੱਲਾਂ ਨੂੰ ਪਾਉਣ ਲਈ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਹਾਲਾਂਕਿ "ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ" ਲੇਬਲ ਕੀਤਾ ਗਿਆ ਹੈ, ਇਸ ਚੈਨਲ ਨੂੰ ਲਗਭਗ ਕਿਸੇ ਵੀ ਉਦੇਸ਼ ਲਈ ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ ਜਿਸ ਲਈ ਅਸਲ ਸਮੇਂ ਦੇ ਇਵੈਂਟ ਟਰਿਗਰ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, HALO ਦੁਆਰਾ ਸਰਗਰਮੀ ਨਾਲ ਡਿਲੀਵਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਇਹ ਵਿਵਸਥਾ ਕਾਫ਼ੀ ਲਚਕਦਾਰ ਹੈ ਕਿਉਂਕਿ "ਐਕਸ਼ਨ" 'ਤੇ ਚੋਣ ਇਹ ਨਿਰਧਾਰਤ ਕਰਦੀ ਹੈ ਕਿ ਇਸ ਚੈਨਲ ਰਾਹੀਂ ਕਿਹੜੀਆਂ HALO ਇਵੈਂਟਸ ਪ੍ਰਸਾਰਿਤ ਹੁੰਦੀਆਂ ਹਨ।

HTTP ਮੋਡ ਵਿੱਚ, ਸੈਟ ਅਤੇ ਰੀਸੈਟ ਸਤਰ ਹਨ URLs ਜੋ ਲੋੜੀਂਦੇ ਮੰਜ਼ਿਲ ਸਰਵਰ ਦੁਆਰਾ ਲੋੜ ਅਨੁਸਾਰ ਦਰਜ ਅਤੇ ਫਾਰਮੈਟ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਪ੍ਰਮਾਣਿਕਤਾ ਲਈ ਇੱਕ ਉਪਭੋਗਤਾ ਅਤੇ ਪਾਸਵਰਡ ਖੇਤਰ ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ। ਹੇਠਾਂ HTTP ਮੋਡ ਦੇਖੋ।

TCP ਮੋਡ ਵਿੱਚ, ਸੈਟ ਅਤੇ ਰੀਸੈਟ ਸਟ੍ਰਿੰਗਸ ਕੇਵਲ ਇੱਕ ਸੁਨੇਹੇ ਦਾ ਡੇਟਾ ਹੁੰਦਾ ਹੈ ਜੋ ਪ੍ਰਾਪਤ ਕਰਨ ਵਾਲੇ TCP ਸਾਕਟ ਨੂੰ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ। ਉਹਨਾਂ ਨੂੰ ਮੰਜ਼ਿਲ ਦੁਆਰਾ ਲੋੜ ਅਨੁਸਾਰ ਫਾਰਮੈਟ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। ਮੰਜ਼ਿਲ ਪਤਾ ਅਤੇ ਪੋਰਟ ਖੇਤਰਾਂ ਵਿੱਚ ਦਰਸਾਈ ਗਈ ਹੈ। ਹੇਠਾਂ TCP ਮੋਡ ਦੇਖੋ।

ਕਿਸੇ ਵੀ ਮੋਡ ਲਈ, ਸਭ ਤੋਂ ਤਾਜ਼ਾ ਸੰਦੇਸ਼ ਤੋਂ ਸਥਿਤੀ ਪ੍ਰਦਰਸ਼ਿਤ ਕੀਤੀ ਜਾਂਦੀ ਹੈ ਜੋ ਕੁਨੈਕਸ਼ਨ ਜਾਂ ਹੋਰ ਮੁੱਦਿਆਂ ਨੂੰ ਠੀਕ ਕਰਨ ਵਿੱਚ ਸਹਾਇਤਾ ਕਰ ਸਕਦੀ ਹੈ। ਤੁਸੀਂ ਇੱਕ ਸੰਦੇਸ਼ ਨੂੰ ਮਜਬੂਰ ਕਰਨ ਲਈ ਐਕਸ਼ਨ ਪੌਪਅੱਪ 'ਤੇ ਇਵੈਂਟ ਟੈਸਟ ਬਟਨਾਂ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ:

ਇਸ ਕਿਸਮ ਦੇ ਸੁਨੇਹਿਆਂ ਨੂੰ ਸਮਰੱਥ ਬਣਾਉਣ ਲਈ ਸੈੱਟ ਜਾਂ ਰੀਸੈਟ ਲਈ ਗਲੋਬਲ ਚਾਲੂ/ਬੰਦ ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਰੀਸੈਟ ਦੀ ਵਰਤੋਂ ਅਕਸਰ ਨਹੀਂ ਕੀਤੀ ਜਾਂਦੀ ਕਿਉਂਕਿ ਸਿਰਫ਼ ਕਿਸੇ ਇਵੈਂਟ ਦੀ ਸ਼ੁਰੂਆਤ ਹੀ ਦਿਲਚਸਪੀ ਵਾਲੀ ਹੁੰਦੀ ਹੈ, ਪਰ ਇਹ ਵੱਖ-ਵੱਖ ਹੋ ਸਕਦਾ ਹੈ। ਹਰੇਕ ਇਵੈਂਟ ਸੁਤੰਤਰ ਤੌਰ 'ਤੇ ਨਿਰਧਾਰਿਤ ਕਰ ਸਕਦਾ ਹੈ ਕਿ ਕੀ ਇਹ ਐਕਸ਼ਨ ਪੌਪਅੱਪ 'ਤੇ ਸੈੱਟ ਜਾਂ ਰੀਸੈਟ ਸੰਦੇਸ਼ ਦੀ ਵਰਤੋਂ ਕਰੇਗਾ। ਆਈਬਾਲ ਬਟਨ ਕੀਵਰਡ ਬਦਲ ਅਤੇ ਫਾਰਮੈਟਿੰਗ ਤੋਂ ਬਾਅਦ ਕੀ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ ਦੀ ਇੱਕ ਮੋਟਾ ਪ੍ਰਤੀਨਿਧਤਾ ਪ੍ਰਦਰਸ਼ਿਤ ਕਰਨਗੇ। ਦੁਹਰਾਓ ਹੋਲਡਆਫ ਦੀ ਵਰਤੋਂ ਵਾਰ-ਵਾਰ ਸੁਨੇਹਿਆਂ ਨੂੰ ਇੱਕ ਹੋਰ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਦੇਰੀ ਕਰਕੇ ਥ੍ਰੋਟਲ ਕਰਨ ਲਈ ਕੀਤੀ ਜਾ ਸਕਦੀ ਹੈ। ਇਹ ਪ੍ਰਤੀ ਇਵੈਂਟ ਸੁਤੰਤਰ ਤੌਰ 'ਤੇ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। HALO ਕੋਲ 15 ਸਕਿੰਟਾਂ ਦੇ ਇਵੈਂਟਾਂ ਲਈ ਇੱਕ ਬਿਲਟ-ਇਨ ਹੋਲਡ ਸਮਾਂ ਹੈ ਤਾਂ ਜੋ ਇਵੈਂਟਸ ਦੇ ਤੇਜ਼ੀ ਨਾਲ ਮੁੜ ਚਾਲੂ ਹੋਣ ਤੋਂ ਬਚਿਆ ਜਾ ਸਕੇ। ਜੇਕਰ ਤੁਸੀਂ ਇਹ ਯਕੀਨੀ ਬਣਾਉਣਾ ਚਾਹੁੰਦੇ ਹੋ ਕਿ ਕਿਸੇ ਕਿਸਮ ਦੀ 1 ਤੋਂ ਵੱਧ ਘਟਨਾ ਪ੍ਰਤੀ ਮਿੰਟ ਨਾ ਭੇਜੀ ਜਾਵੇ, ਤਾਂ ਤੁਸੀਂ ਰਿਪੀਟ ਹੋਲਡਆਫ ਨੂੰ 60 (ਸਕਿੰਟ) 'ਤੇ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹੋ।

ਦਿਲ ਦੀ ਧੜਕਣ ਦੇ ਵੇਰਵੇ

ਦਿਲ ਦੀ ਧੜਕਣ ਪ੍ਰਸਾਰਣ ਉਪਰੋਕਤ ਦੇ ਸਮਾਨ ਤਰੀਕੇ ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ ਸਿਵਾਏ ਇਸ ਤੋਂ ਇਲਾਵਾ ਕਿ ਐਕਸ਼ਨ ਪੰਨੇ ਨਾਲ ਕੋਈ ਪਰਸਪਰ ਪ੍ਰਭਾਵ ਨਹੀਂ ਹੁੰਦਾ। ਇਸਦੀ ਬਜਾਏ, ਦਿਲ ਦੀ ਧੜਕਣ ਦਾ ਪ੍ਰਸਾਰਣ ਇੱਕ ਨਿਯਮਤ ਅਧਾਰ 'ਤੇ ਹੁੰਦਾ ਹੈ ਜਿਵੇਂ ਕਿ ਅੰਤਰਾਲ ਖੇਤਰ ਨਾਲ ਸੰਰਚਿਤ ਕੀਤਾ ਗਿਆ ਹੈ, HTTP ਮੋਡ ਵਿੱਚ, ਸੈਟ ਅਤੇ ਰੀਸੈਟ ਸਟ੍ਰਿੰਗਸ ਹਨ URLs ਜੋ ਲੋੜੀਂਦੇ ਮੰਜ਼ਿਲ ਸਰਵਰ ਦੁਆਰਾ ਲੋੜ ਅਨੁਸਾਰ ਦਰਜ ਅਤੇ ਫਾਰਮੈਟ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਪ੍ਰਮਾਣਿਕਤਾ ਲਈ ਇੱਕ ਉਪਭੋਗਤਾ ਅਤੇ ਪਾਸਵਰਡ ਖੇਤਰ ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ। ਹੇਠਾਂ HTTP ਮੋਡ ਦੇਖੋ।

ਜਦੋਂ ਕਿ ਦਿਲ ਦੀ ਧੜਕਣ ਦਾ ਮੁੱਖ ਉਦੇਸ਼ ਇੱਕ ਰਿਮੋਟ ਐਪਲੀਕੇਸ਼ਨ ਨੂੰ ਇੱਕ HALO ਸਮਾਰਟ ਸੈਂਸਰ ਦੇ ਜੀਵਨ ਦਾ ਸਬੂਤ ਪ੍ਰਦਾਨ ਕਰਨਾ ਹੈ, ਇਸ ਸੰਦੇਸ਼ ਨੂੰ ਚੁਣੇ ਗਏ ਸੈਂਸਰਾਂ ਜਾਂ ਮੌਜੂਦਾ ਇਵੈਂਟ ਸਟੇਟ ਜਾਣਕਾਰੀ ਨੂੰ ਪ੍ਰਸਾਰਿਤ ਕਰਨ ਲਈ ਵੀ ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ। ਸਾਬਕਾample ਉਪਰੋਕਤ ਦੇ ਨਾਲ ਇੱਕ ਲੰਮੀ ਸਤਰ ਪੈਰਾਮੀਟਰ ਭੇਜਦਾ ਹੈ URL ਜਿਸ ਵਿੱਚ ਹੈਲੋ ਨਾਮ, ਸੈਂਸਰ ਮੁੱਲਾਂ ਦੀ ਬਹੁਗਿਣਤੀ, ਅਤੇ ਅੰਤ ਵਿੱਚ ਟ੍ਰਿਗਰਡ=% ACTIVE% ਜੋ ਕਿ ਖਾਲੀ ਹੋ ਸਕਦਾ ਹੈ ਜਾਂ ਵਰਤਮਾਨ ਵਿੱਚ ਟਰਿੱਗਰ ਕੀਤੀਆਂ ਘਟਨਾਵਾਂ ਦੀ ਸੂਚੀ ਸ਼ਾਮਲ ਕਰਦਾ ਹੈ।

HTTP (ਅਤੇ HTTPS) ਮੋਡ

ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ ਅਤੇ ਦਿਲ ਦੀ ਧੜਕਣ ਦੀਆਂ ਤਾਰਾਂ http: ਜਾਂ https: ਹੋ ਸਕਦੀਆਂ ਹਨ। URLs ਲੋੜ ਅਨੁਸਾਰ. ਮੰਜ਼ਿਲ ਸਰਵਰ ਦੁਆਰਾ ਲੋੜ ਅਨੁਸਾਰ ਪਾਥ ਅਤੇ ਪੈਰਾਮੀਟਰ ਦਾਖਲ ਕੀਤੇ ਜਾ ਸਕਦੇ ਹਨ। %NAME% (HALO ਡਿਵਾਈਸ ਦਾ ਨਾਮ) ਜਾਂ %EID% (ਇਵੈਂਟ ਆਈਡੀ) ਵਰਗੇ ਕੀਵਰਡ ਲੋੜ ਅਨੁਸਾਰ ਸ਼ਾਮਲ ਕੀਤੇ ਜਾ ਸਕਦੇ ਹਨ ਅਤੇ ਜਦੋਂ ਸੁਨੇਹਾ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ ਤਾਂ ਉਹਨਾਂ ਨੂੰ ਸੰਬੰਧਿਤ ਡੇਟਾ ਨਾਲ ਬਦਲ ਦਿੱਤਾ ਜਾਵੇਗਾ। ਤੇਜ਼ ਸੰਦਰਭ ਲਈ ਆਮ ਤੌਰ 'ਤੇ ਵਰਤੇ ਜਾਣ ਵਾਲੇ ਕੀਵਰਡਸ ਦੀ ਸੂਚੀ ਦਿਖਾਈ ਜਾਂਦੀ ਹੈ।
ਦ URL ਮਾਰਗ ਵਿੱਚ ਕੀਵਰਡਸ ਦੇ ਨਾਲ-ਨਾਲ ਪੈਰਾਮੀਟਰ ਵੀ ਹੋ ਸਕਦੇ ਹਨ URL. ਪੈਰਾਮੀਟਰ NAME=VALUE ਜੋੜੇ ਜਾਂ ਇੱਕ JSON ਵਸਤੂ, ਜਾਂ ਮੰਜ਼ਿਲ ਸਰਵਰ 'ਤੇ ਨਿਰਭਰ ਕਰਦੇ ਹੋਏ ਇੱਕ ਕਸਟਮ ਫਾਰਮੈਟ ਹੋ ਸਕਦੇ ਹਨ। ਸਾਬਕਾampਬਾਹਰੀ ਮੈਸੇਜਿੰਗ ਲਈ les ਵਿੱਚ %EID% ਸ਼ਾਮਲ ਹੋਵੇਗਾ ਤਾਂ ਜੋ ਇਵੈਂਟ ਸ਼ੁਰੂ ਹੋਇਆ:

https://server.com/event/%NAME%/%EID%
https://server.com/event?location=%NAME%&event=%EID%

https://server.com/event?{“location”:”:%NAME%”,”event”:”%EID%”}

Exampਦਿਲ ਦੀ ਧੜਕਣ ਲਈ ਲੇਸ % ACTIVE% (ਵਰਤਮਾਨ ਵਿੱਚ ਟਰਿੱਗਰ ਕੀਤੇ ਇਵੈਂਟਸ) ਜਾਂ ਇੱਕ ਸੈਂਸਰ ਮੁੱਲ ਜੋੜ ਸਕਦਾ ਹੈ:

https://server.com/alive?location=%NAME%&Triggered=%ACTIVE%
https://server.com/event?{“location”:”:%NAME%”,”NH3”:%SENSOR:NH3%}
%SENSOR:…% ਮੁੱਲ evtYYYYMMDD.csv ਲੌਗ ਵਿੱਚ ਸੱਜੇ-ਹੱਥ ਸੈਂਸਰ ਕਾਲਮ ਸਿਰਲੇਖਾਂ ਵਿੱਚ ਪਾਏ ਗਏ ਨਾਮਾਂ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਨ fileਐੱਸ. ਉਹ ਆਮ ਤੌਰ 'ਤੇ ਹਨ:

ਜੇਕਰ ਮੰਜ਼ਿਲ ਸਰਵਰ GET ਬੇਨਤੀਆਂ ਦੀ ਬਜਾਏ HTTP PUT ਜਾਂ POST ਨੂੰ ਤਰਜੀਹ ਦਿੰਦਾ ਹੈ, ਤਾਂ ਤੁਸੀਂ URL PUT: ਜਾਂ POST: ਦੇ ਨਾਲ। ਸੁਤੰਤਰ ਤੌਰ 'ਤੇ, ਤੁਸੀਂ ਇੱਕ JSON ਪੇਲੋਡ ਸ਼ਾਮਲ ਕਰ ਸਕਦੇ ਹੋ ਜੋ JSON ਫਾਰਮੈਟ ਕੀਤੇ ਆਬਜੈਕਟ ਦੇ ਬਾਅਦ [JSONBODY] ਕੀਵਰਡ ਨੂੰ ਜੋੜ ਕੇ ਬਹੁਤ ਸਾਰੇ ਸਰਵਰਾਂ ਵਿੱਚ ਪ੍ਰਸਿੱਧ ਹੈ। ਸਾਬਕਾampLe:
ਪਾ:https://server.com/event[JSONBODY]{“location”:”%NAME%”,”event”:”%EID%”}
ਦ URL ਆਮ IP ਐਡਰੈੱਸ (ਅਤੇ IPv6) ਅਤੇ ਪੋਰਟ ਅਤੇ ਉਪਭੋਗਤਾ-ਪਾਸਵਰਡ ਵਿਕਲਪਾਂ ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ, ਜਾਂ ਤੁਸੀਂ ਮੂਲ ਜਾਂ ਡਾਇਜੈਸਟ ਵਰਗੇ ਪ੍ਰਮਾਣਿਕਤਾ ਤਰੀਕਿਆਂ ਲਈ ਮੰਜ਼ਿਲ ਸਰਵਰ ਲਈ ਲੋੜ ਪੈਣ 'ਤੇ ਉਪਭੋਗਤਾ ਅਤੇ ਪਾਸਵਰਡ ਖੇਤਰਾਂ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ:
https://username:password@123.321.123.321:9876/event…

TCP ਮੋਡ

ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ ਅਤੇ ਹਾਰਟ ਬੀਟ ਸਤਰ ਸਿਰਫ਼ ਡੇਟਾ ਲਈ ਹਨ ਕਿਉਂਕਿ ਪਤਾ ਅਤੇ ਪੋਰਟ ਖੇਤਰ ਮੰਜ਼ਿਲ ਨੂੰ ਦਰਸਾਉਂਦੇ ਹਨ। ਪਤਾ ਨਾਮਾਂ, IPv4 ਅਤੇ IPv6 ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ।
ਸਤਰ ਨੂੰ ਉੱਪਰ ਦੱਸੇ ਗਏ HTTP ਸੁਨੇਹਿਆਂ ਦੇ ਡੇਟਾ ਭਾਗਾਂ ਵਾਂਗ ਜਾਂ ਮੰਜ਼ਿਲ ਸਰਵਰ ਦੁਆਰਾ ਲੋੜ ਅਨੁਸਾਰ ਫਾਰਮੈਟ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ।
Exampਬਾਹਰੀ ਮੈਸੇਜਿੰਗ ਲਈ les ਵਿੱਚ %EID% ਸ਼ਾਮਲ ਹੋਵੇਗਾ ਤਾਂ ਜੋ ਇਵੈਂਟ ਸ਼ੁਰੂ ਹੋਇਆ:
ਸਥਾਨ=%NAME%, ਘਟਨਾ=%EID%
{“ਟਿਕਾਣਾ”:”:%NAME%”,”ਇਵੈਂਟ”:”%EID%”}
Exampਦਿਲ ਦੀ ਧੜਕਣ ਲਈ ਲੇਸ % ACTIVE% (ਵਰਤਮਾਨ ਵਿੱਚ ਟਰਿੱਗਰ ਕੀਤੇ ਇਵੈਂਟਸ) ਜਾਂ ਇੱਕ ਸੈਂਸਰ ਮੁੱਲ ਜੋੜ ਸਕਦਾ ਹੈ:
ਸਥਾਨ=%NAME%&Triggered=%ACTIVE%
{"ਟਿਕਾਣਾ":":%NAME%","NH3":% SENSOR:NH3%}

"ਏਕੀਕਰਣ ਸੈੱਟ" ਅਤੇ "ਏਕੀਕਰਣ ਰੀਸੈਟ" ਕਾਲਮਾਂ ਵਿੱਚ ਚੈੱਕਬਾਕਸ ਇਹ ਨਿਰਧਾਰਤ ਕਰਦੇ ਹਨ ਕਿ ਕਿਹੜੇ ਇਵੈਂਟ ਭੇਜਣਾ ਸ਼ੁਰੂ ਕਰਦੇ ਹਨ। ਈਵੈਂਟਸ ਅਤੇ ਐਕਸ਼ਨਾਂ ਦੇ ਸੈੱਟਅੱਪ ਬਾਰੇ ਹੋਰ ਜਾਣਕਾਰੀ HALO ਪ੍ਰਸ਼ਾਸਕ ਦੀ ਗਾਈਡ ਵਿੱਚ ਉਪਲਬਧ ਹੈ।

JSON ਇਵੈਂਟ ਸੁਨੇਹਿਆਂ ਦੀ ਡਿਲਿਵਰੀ
ਕੁਝ ਡਿਵੈਲਪਰ ਸਾਦੇ ASCII ਟੈਕਸਟ ਦੀ ਬਜਾਏ ਇੰਡਸਟਰੀ ਸਟੈਂਡਰਡ ਸਵੈ-ਲੇਬਲ ਵਾਲੇ JSON ਦੇ ਰੂਪ ਵਿੱਚ ਫਾਰਮੈਟ ਕੀਤੇ ਇਵੈਂਟ ਡੇਟਾ ਨੂੰ ਪ੍ਰਾਪਤ ਕਰਨਾ ਪਸੰਦ ਕਰਦੇ ਹਨ ਕਿਉਂਕਿ ਪਹਿਲਾਂ ਵਧੇਰੇ ਭਰੋਸੇਯੋਗ ਅਤੇ ਵਧੇਰੇ ਆਸਾਨੀ ਨਾਲ ਪਾਰਸ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। HALO 'ਤੇ web ਪੰਨਾ “ਮੈਸੇਜਿੰਗ” ਟੈਬ, ਤੁਸੀਂ “ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ” ਸੈਟਿੰਗਾਂ “ਸੈਟ ਸਟ੍ਰਿੰਗ” ਅਤੇ “ਰੀਸੈੱਟ ਸਟ੍ਰਿੰਗ” ਅਤੇ “ਦਿਲ ਦੀ ਧੜਕਣ” “ਸੁਨੇਹੇ” ਵਿੱਚ JSON ਸੁਨੇਹੇ ਸਪਲਾਈ ਕਰ ਸਕਦੇ ਹੋ।

Examples:
"ਬਾਹਰੀ ਮੈਸੇਜਿੰਗ" ਸੈਟਿੰਗਾਂ ਸਤਰ ਸੈਟ ਕਰੋ:

{ “ਡਿਵਾਈਸ”:”%NAME%”, “ਇਵੈਂਟ”:”%EID%”, “ਅਲਾਰਮ”:”ਹਾਂ” }
ਇਹ ਨਿਸ਼ਚਿਤ ਸਰਵਰ ਨੂੰ ਇੱਕ ਸਿੰਗਲ TCP ਜਾਂ UDP JSON ਸੁਨੇਹਾ ਭੇਜੇਗਾ ਜੋ ਦੋਸਤਾਨਾ ਡਿਵਾਈਸ ਨਾਮ, ਇਵੈਂਟ ਨਾਮ ਅਤੇ ਇਹ ਹੁਣੇ ਸ਼ੁਰੂ ਹੋਇਆ ਹੈ ਦੀ ਰਿਪੋਰਟ ਕਰੇਗਾ।

"ਬਾਹਰੀ ਸੁਨੇਹਾ" ਸੈਟਿੰਗਾਂ ਸਟ੍ਰਿੰਗ ਰੀਸੈਟ ਕਰੋ:
{ “ਡਿਵਾਈਸ”:”%NAME%”, “ਇਵੈਂਟ”:”%EID%”, “ਅਲਾਰਮ”:”ਨਹੀਂ” }
ਇਹ ਨਿਸ਼ਚਿਤ ਸਰਵਰ ਨੂੰ ਇੱਕ ਸਿੰਗਲ TCP ਜਾਂ UDP JSON ਸੁਨੇਹਾ ਭੇਜੇਗਾ ਜੋ ਦੋਸਤਾਨਾ ਡਿਵਾਈਸ ਦੇ ਨਾਮ, ਇਵੈਂਟ ਨਾਮ ਦੀ ਰਿਪੋਰਟ ਕਰੇਗਾ ਅਤੇ ਇਹ ਕਿ ਸਥਿਤੀ ਹੁਣ ਬੰਦ ਹੋ ਗਈ ਹੈ।

"ਦਿਲ ਦੀ ਧੜਕਣ" ਸੁਨੇਹਾ:
{ “ਡਿਵਾਈਸ”:”%NAME%”, “ਜ਼ਿੰਦਾ”:”%DATE% %TIME%” }
ਇਹ ਸਮੇਂ-ਸਮੇਂ 'ਤੇ ਨਿਰਧਾਰਤ ਸਰਵਰ ਨੂੰ ਇੱਕ TCP ਜਾਂ UDP JSON ਸੁਨੇਹਾ ਭੇਜੇਗਾ ਜੋ ਇਹ ਰਿਪੋਰਟ ਕਰਦਾ ਹੈ ਕਿ HALO ਦੱਸੇ ਸਮੇਂ 'ਤੇ ਜ਼ਿੰਦਾ ਹੈ।