Configure Temperature Screening Alarm

Temperature screening can detect the human body temperatures at large-scale area in the public places (e.g., customs, airports, schools, hospitals) with high people density, and help to fast find and track the person with high body temperature. Then, the alarm will be remotely uploaded to the monitor center via the network for real-time analysis and handling. This function is mainly applied to the control and prevention of some serious febrile infectious diseases (e.g., SARS, Avain Influenza, Ebola).

  • Make sure you have called NET_DVR_Init to initialize the development environment.

  • Make sure you have called NET_DVR_Login_V40 to log in to the device.

Figure 1 Programming Flow of Configuring Temperature Screening Alarm

  1. Optional: Call NET_DVR_GetSTDAbility, set the dwAbilityType to NET_DVR_GET_THERMAL_CAPABILITIES (value: 3634), and set condition parameter lpCondBuffer in the structure of NET_DVR_STD_ABILITY to "NULL" for getting the thermal capability to check if the following functions are supported.

    The thermal capability (XML_ThermalCap) is returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_ABILITY.

  2. Configure functional mutex parameters.
    1. Optional: Call NET_DVR_GetSTDAbility, set the dwAbilityType to NET_DVR_GET_THERMINTELL_CAPABILITIES (value: 6711), and set condition parameter lpCondBuffer in the structure of NET_DVR_STD_ABILITY to 4-byte channel No. for getting the functional mutex capability to check if it is supported.

      The functional mutex capability (XML_Cap_ThermIntell) is returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_ABILITY.

    2. Optional: Call NET_DVR_GetSTDConfig with NET_DVR_GET_THERMINTELL (command No.: 6712) and set the condition parameter IpCondBuffer in the structure of NET_DVR_STD_CONFIG to 4-byte channel No. for getting the existing or configured functional mutex parameters for reference.

      The functional mutex parameters (NET_DVR_THERMINTELL_PARAM) are returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_CONFIG.

    3. Call NET_DVR_SetSTDConfig with NET_DVR_SET_THERMINTELL (command No.: 6713), set the condition parameter IpCondBuffer and input parameter lpInBuffer in the structure of NET_DVR_STD_CONFIG to 4-byte channel No. and NET_DVR_THERMINTELL_PARAM for setting functional mutex parameters.
  3. Configure basic temperature measurement parameters.
    1. Optional: Call NET_DVR_GetSTDAbility, set the dwAbilityType to NET_DVR_GET_THERMOMETRY_BASICPARAM_CAPABILITIES (value: 3620), and set condition parameter lpCondBuffer in the structure of NET_DVR_STD_ABILITY to 4-byte channel No. for getting the basic temperature measurement capability to check if it is supported.

      The basic temperature measurement capability (XML_Cap_ThermometryBasicParam) is returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_ABILITY.

    2. Optional: Call NET_DVR_GetSTDConfig with NET_DVR_GET_THERMOMETRY_BASICPARAM (command No.: 3621) and set the condition parameter IpCondBuffer in the structure of NET_DVR_STD_CONFIG to 4-byte channel No. for getting the existing or configured basic temperature measurement parameters for reference.

      The basic temperature measurement parameters (NET_DVR_THERMOMETRY_BASICPARAM) are returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_CONFIG.

    3. Call NET_DVR_SetSTDConfig with NET_DVR_SET_THERMOMETRY_BASICPARAM (command No.: 3622), set the condition parameter IpCondBuffer and input parameter lpInBuffer in the structure of NET_DVR_STD_CONFIG to 4-byte channel No. and NET_DVR_THERMOMETRY_BASICPARAM for setting basic temperature measurement parameters.
  4. Configure black body as the reference of temperature screening.
    1. Optional: Call NET_DVR_STDXMLConfig to transmit the request URI: GET /ISAPI/Thermal/channels/<ID>/blackBody/capabilities for getting the black body capability to check if it is supported.

      The black body capability is returned in the message of XML_Cap_ThermalBlackBody.

    2. Optional: Call NET_DVR_STDXMLConfig to transmit the request URI: GET /ISAPI/Thermal/channels/<ID>/blackBody for getting the existing or configured black body parameters for reference.

      The black body parameters are returned in the message of XML_ThermalBlackBody.

    3. Call NET_DVR_STDXMLConfig to transmit the request URI: PUT /ISAPI/Thermal/channels/<ID>/blackBody and set the request message to XML_ThermalBlackBody for setting the black body parameters.
  5. Configure temperature screening parameters.
    1. Optional: Call NET_DVR_STDXMLConfig to transmit the request URI: GET /ISAPI/Thermal/channels/<ID>/faceThermometry/capabilities for getting the temperature screening capability to check if it is supported.

      The temperature screening capability is returned in the message of XML_Cap_FaceThermometry.

    2. Call NET_DVR_STDXMLConfig to transmit the request URI: PUT /ISAPI/Thermal/channels/<ID>/faceThermometry and set the request message to XML_FaceThermometry for setting the temperature screening parameters.
    3. Call NET_DVR_STDXMLConfig to transmit the request URIs: PUT /ISAPI/Thermal/channels/<ID>/faceThermometry/regions or PUT /ISAPI/Thermal/channels/<ID>/faceThermometry/regions/<ID>, and then set the request messages to XML_FaceThermometryRegionList and XML_ThermometryRegion, respectively, for setting temperature measurement rules of all detection regions or a specific detection region.
    4. Optional: Call NET_DVR_STDXMLConfig to transmit the request URI: GET /ISAPI/Thermal/channels/<ID>/faceThermometry/regions/<ID>/detectionInfo for getting the temperature screening results by channel or by detection region.

      The temperature screening results are returned in the message of XML_FaceThermDetectionInfo with form format (see the example in the message).

    Note:

    Before setting the temperature screening parameters (include temperature measurement rules), you can call each configuration URI by GET method to get the existing or configured parameters for reference.

  6. Configure arming schedule for temperature screening alarm.
    1. Optional: Call NET_DVR_GetSTDAbility, set the dwAbilityType to NET_DVR_GET_ FACE_THERMOMETRY_SCHEDULE_CAPABILITIES (value: 4402), and set condition parameter lpCondBuffer in the structure of NET_DVR_STD_ABILITY to 4-byte channel No. for getting the arming schedule configuration capability to check if it is supported.

      The arming schedule configuration capability (XML_Schedule) is returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_ABILITY.

    2. Optional: Call NET_DVR_GetSTDConfig with NET_DVR_GET_FACE_THERMOMETRY_SCHEDULE (command No.:4403) and set the condition parameter IpCondBuffer in the structure of NET_DVR_STD_CONFIG to 4-byte channel No. for getting the existing or configured arming schedule parameters for reference.

      The arming schedule parameters (NET_DVR_EVENT_SCHEDULE) are returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_CONFIG.

    3. Call NET_DVR_SetSTDConfig with NET_DVR_SET_FACE_THERMOMETRY_SCHEDULE (command No.: 4404), set the condition parameter IpCondBuffer and input parameter lpInBuffer in the structure of NET_DVR_STD_CONFIG to 4-byte channel No. and NET_DVR_EVENT_SCHEDULE for setting arming schedule.
  7. Configure linkage action for temperature screening alarm.
    1. Optional: Call NET_DVR_GetSTDAbility, set the dwAbilityType to NET_DVR_GET_EVENT_TRIGGERS_CAPABILITIES (value: 3501), and set condition parameter lpCondBuffer in the structure of NET_DVR_STD_ABILITY to "NULL" for getting the linkage action configuration capability to check if it is supported.

      The linkage action configuration capability (XML_EventTriggersCap) is returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_ABILITY.

    2. Optional: Call NET_DVR_GetSTDConfig with NET_DVR_GET_FACE_THERMOMETRY_TRIGGER (command No.: 4405) and set the condition parameter IpCondBuffer in the structure of NET_DVR_STD_CONFIG to 4-byte channel No. for getting the existing or configured linkage action parameters for reference.

      The linkage action parameters (NET_DVR_EVENT_TRIGGER) are returned by the output parameter lpOutBuffer in the structure of NET_DVR_STD_CONFIG.

    3. Call NET_DVR_SetSTDConfig with NET_DVR_SET_FACE_THERMOMETRY_TRIGGER (command No.: 4401), set the condition parameter IpCondBuffer and input parameter lpInBuffer in the structure of NET_DVR_STD_CONFIG to "NULL" and NET_DVR_EVENT_TRIGGER for setting linkage action.
    Note:

    To receive the alarm in platform or system, the linkage action must be set to "center" (upload to alarm center).

  8. Optional: Receive the temperature screening alarm in arming mode (see Receive Alarm/Event in Arming Mode) or listening mode (see Receive Alarm/Event in Listening Mode) when alarm is triggered.
    Note:

    The command (lCommand) to receive temperature screening alarm should be set to COMM_FACE_THERMOMETRY_ALARM (command No.: 0x4994) in the APIs of NET_DVR_SetDVRMessageCallBack_V50 and NET_DVR_StartListen_V30. For the alarm details, refer to structure NET_DVR_FACE_THERMOMETRY_ALARM.

Call NET_DVR_Logout and NET_DVR_Cleanup to log out and release the resources.