Development Kit for Educational Scenes

Last Updated on : 2023-01-17 06:36:44download

In recent years, the myopia rate of students in China has been increasing year by year. One contributing factor is improper classroom lighting. In light of this, classroom lighting is expected to be retrofitted on a large scale. To meet increasing challenges and renovation requirements, how to cost-effectively make classroom lighting smart, energy-saving, and healthy in a short time window is put at the core.

For this purpose, Tuya comes up with smart classroom lighting solutions that control smart classroom devices over Zigbee and Bluetooth mesh protocols. The solutions have been implemented and proven in a host of projects.

Tuya sorts out a smart classroom template on top of these comprehensive solutions. Based on the development kit, you can create smart scenes for classroom environmental setup.

Features

  • Purpose system settings
  • Standard classroom lighting scenes
  • Sensing control rule settings

Recommended devices

Eye-protection LED lamp (microcrystalline)

Development Kit for Educational Scenes

LED lamp for blackboard

Development Kit for Educational Scenes

  • Use a light source chip closest to the natural light spectrum to simulate a natural light environment.
  • Microcrystalline anti-glare panel designed for classroom lights is used to strictly control glare and make sure the unified glare rating (UGR) is less than 16.
  • The lamps become more energy efficient.
  • High color rendering index Ra and R9, helping to better show real colors of of the object.
  • Achieve RG0, indicating there is no blue light hazard. Light flickering does not cause a significant effect, whereas electromagnetic radiation to the human body complies with safety requirements.
  • Lamp dimension: 1,200 mm long and 295 mm wide.
  • The lamp is equipped with two rigid hollow aluminum suspenders in a diameter of 12 mm and with a wall thickness of 1 mm or more. The suspenders can accommodate the lamp wires, and the surface is treated with anodic oxidation or electrostatic spraying.
  • The main body of the lamp is made of an oxidation-resistant metal material that is not easy to deform. It is embedded and fixed with screws and nuts.
  • The external power supply can be fixed on the back of the lamp, facilitating installation and maintenance.

Zigbee 6-gang scene switch with a color display

Scene features: 32 local scenes are built-in for users to choose from. Press and hold both button 3 and button 4 for about five seconds, and the scene icon blinks. Users can press the buttons to switch between scenes. The settings interface is exited if users do not operate for three seconds. The scene icon becomes steady on.

Development Kit for Educational Scenes

Microwave human presence sensor

Use a millimeter-wave Doppler radar to sense the biological movement of people and determine whether a person is present in the specified place. This product can detect the light intensity.

Development Kit for Educational Scenes

Set up a smart classroom

Prerequisites

  1. Contact the account manager to open an account.
  2. See how to create a project and space.
  3. Pair Tuya’s smart lighting control devices with the specified app. For more information, see Device Management and Control.

Configure API parameters

Request method API Description
POST /v1.0/light/devices/edu/purpose Set the purpose of educational devices. Currently, six modes are designed based on the basic lighting purpose and blackboard lighting purpose. After settings, you can call the API operations to generate a variety of scenes.
POST /v1.0/light/smart/edu-template/class Generate class mode with one tap.
POST /v1.0/light/smart/edu-template/class-over Generate class-over mode with one tap.
POST /v1.0/light/smart/edu-template/siesta Generate lunch break mode with one tap.
POST /v1.0/light/smart/edu-template/projection Generate projection mode with one tap.
POST /v1.0/light/smart/edu-template/exam Generate exam mode with one tap.
POST /v1.0/light/smart/edu-template/study Generate study mode with one tap.
POST /v1.0/light/smart/edu-template/reaction Generate space sensing configurations with one tap.

Set the purpose of educational devices

Functional description

Assign the following purposes to numerous devices in a teaching building. Tuya’s built-in templates of commercial lighting will help to generate desirable scenes or linkages for each classroom with one tap.

API endpoint

POST /v1.0/light/devices/edu/purpose

Request parameters

Parameter Type Parameter type Description Required Example
device_ids String[] body The list of device IDs. true uQvUFxMm9J
roomId String body The ID of the specified space. true uQvUFxMm9J
device_purpose String body The purpose of the specified educational device. Valid values:
  • basicLighting: basic lighting
  • atmosphereLighting: ambient lighting
  • emergencyLighting: emergency lighting
  • functionLighting: functional lighting
  • blackboardLighting: blackboard lighting
  • windowLighting: lighting beside windows
  • aisleLighting: aisle lighting
  • internalLighting: interior lighting
  • auxiliaryLighting: auxiliary lighting
true basicLighting

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result Object The returned result.

Sample request

POST /v1.0/light/devices/edu/purpose
{
  "device_ids": [
    "0Mmpmallta"
  ],
  "room_id": "f3OhK5UIub",
  "device_purpose": "basicLighting"
}

Sample response

{
  "success": true,
  "t": 1573441137
}

Generate class mode

Functional description

Generate a scene in class mode for a classroom with one tap.

API endpoint

POST /v1.0/light/smart/edu-template/class

Request parameters

Parameter Type Parameter type Description Required
roomId String body The ID of the specified space. true

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result String The returned result.

Sample request

POST /v1.0/light/smart/edu-template/class

Sample response

{
  "success": true,
  "t": 1573441137
}

Generate class-over mode

Functional description

Generate a scene in class-over mode for a classroom with one tap.

API endpoint

POST /v1.0/light/smart/edu-template/class-over

Request parameters

Parameter Type Parameter type Description Required
roomId String body The ID of the specified space. true

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result String The returned result.

Sample request

POST /v1.0/light/smart/edu-template/class-over

Sample response

{
  "success": true,
  "t": 1573441137
}

Generate lunch break mode

Functional description

Generate a scene in lunch break mode for a classroom with one tap.

API endpoint

POST /v1.0/light/smart/edu-template/siesta

Request parameters

Parameter Type Parameter type Description Required
roomId String body The ID of the specified space. true

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result String The returned result.

Sample request

POST /v1.0/light/smart/edu-template/siesta

Sample response

{
  "success": true,
  "t": 1573441137
}

Generate projection mode

Functional description

Generate a scene in projection mode for a classroom with one tap.

API endpoint

POST /v1.0/light/smart/edu-template/projection

Request parameters

Parameter Type Parameter type Description Required
roomId String body The ID of the specified space. true

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result String The returned result.

Sample request

POST /v1.0/light/smart/edu-template/projection

Sample response

{
  "success": true,
  "t": 1573441137
}

Generate exam mode

Functional description

Generate a scene in exam mode for a classroom with one tap.

API endpoint

POST /v1.0/light/smart/edu-template/exam

Request parameters

Parameter Type Parameter type Description Required
roomId String body The ID of the specified space. true

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result String The returned result.

Sample request

POST /v1.0/light/smart/edu-template/exam

Sample response

{
  "success": true,
  "t": 1573441137
}

Generate study mode

Functional description

Generate a scene in study mode for a classroom with one tap.

API endpoint

POST /v1.0/light/smart/edu-template/study

Request parameters

Parameter Type Parameter type Description Required
roomId String body The ID of the specified space. true

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result String The returned result.

Sample request

POST /v1.0/light/smart/edu-template/study

Sample response

{
  "success": true,
  "t": 1573441137
}

Generate space sensing configurations

Functional description

Generate space sensing configurations with one tap.

API endpoint

POST /v1.0/light/smart/edu-template/reaction

Request parameters

Parameter Type Parameter type Description Required
roomId String body The ID of the specified space. true

Return parameters

Parameter Type Description
code Integer The response code. For more information, see the error code section. It is empty if the request is successful.
success Boolean Indicates whether the operation is successful. Valid values:
  • true: succeeded.
  • false: failed.
msg String The message that is returned if the request failed. The response is empty if the request is successful.
t Long The returned 13-digit timestamp.
result String The returned result.

Sample request

POST /v1.0/light/smart/edu-template/reaction

Sample response

{
  "success": true,
  "t": 1573441137
}

Error codes

The following table lists common error codes for the API calls. For more error codes, see Global Error Codes.

Error code Description
500 A system error has occurred while processing your request.