ZEBRA ZS300 Electronic Sensors Solution Smarter Labels User Guide
- June 16, 2024
- ZEBRA
Table of Contents
- ZEBRA ZS300 Electronic Sensors Solution Smarter Labels
- Product Information
- Product Usage Instructions
- Value drivers exist in multiple industries and applications
- ZS300 Electronic Temperature Sensors
- Solution Architecture & Connectivity
- Sensor Workflow
- Management APIs
- Alarm APIs
- Features
- Sensor BTLE Advertising Packet
- Dev Tools Best Practices
- Documentation
- API Subscriptions
- Visual & RFID Sensors
- ZeOn-Demand Printable Indicators
- ZeOn-Demand High Temp RFID Labels (Q4-2023)
- References
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
ZEBRA ZS300 Electronic Sensors Solution Smarter Labels
Product Information
The Smarter Labels product by Zebra Technologies is equipped with environmental sensors that provide valuable data for various industries and applications. These sensors, such as the ZS300 Electronic Temperature Sensors, are designed to monitor temperature-sensitive products during transportation and storage. They ensure that foods and pharmaceuticals are stored in the proper conditions and validate high-heat processing. The product includes a solution architecture with connectivity options, an ISV-developed mobile app, Zebra Sensor Discovery Service, and a cloud platform for sensor setup, data collection, and alarms.
Specifications
- Sensor Type : Electronic Temperature Sensors
- Alarm Limits : -40 to 85°C
- Alarm Delays: 0 to 60 minutes
- Data Overwrite: Yes/No
- Data Logging Capacity: Up to 16,000 records
Product Usage Instructions
Sensor Workflow
The following steps outline the sensor workflow:
- Enroll the Sensors: Send a POST request to /devices/sensor-enrollments to enroll the sensors.
- Create a Task: Send a POST request to /environmental/tasks to create a task for data collection.
- Subscribe to Alerts: Send a POST request to /subscription to subscribe to alerts.
- Add Sensors to Task: Send a POST request to /environmental/tasks/{taskID}/sensors to associate sensors with the task.
- Stop the Task: Send a POST request to /environmental/tasks/{taskID}/stop to stop the task.
- Get Data Log: Send a GET request to /tasks/{taskID}/log to retrieve the data log for the task.
Sensor Setup and Configuration
To set up and configure the sensors, follow these steps:
- Enroll Sensor: Use the Zebra App Setup Utility to enroll the sensor.
- Create & Configure Task/Alarms: Set the task name, interval, alarm limits, alarm delays, data overwrite, and other parameters using the Zebra Sensor ZS300 or Zebra Bridge ZB200.
- Associate Task with Assets & Alarms: Associate the task with relevant assets and set up alarms.
- Receive Asset with Sensor(s): Receive assets with attached sensors.
- View Sensor Status/Receive Alarms: Monitor the sensor status and receive alarms through the ISV-developed portal or webhook listener.
- Start Logging: Start logging data according to your chosen settings (e.g., start immediately, start after a delay).
- Log Samples: The product can log up to 16,000 records of temperature data.
Frequently Asked Questions (FAQ)
-
Q: What are the core markets and applications for Zebra Environmental Sensors?
A: Zebra Environmental Sensors are well-suited for temperature-sensitive products in transit, ensuring proper storage conditions for foods, monitoring temperature during short- or long-term storage, and validating high-heat processing in industries such as food and pharma manufacturing, transportation, and logistics. -
Q: How do I retrieve data from a task?
A: To retrieve data from a task, send a GET request to /data/environmental/tasks/{taskID}/log with the desired start and end time. -
Q: What are the specifications of the ZS300 Electronic Temperature Sensors?
A: The ZS300 Electronic Temperature Sensors have an operating range of -40 to 85°C and can be configured with upper and lower alarm limits (-40 to 85°C), alarm delays (0 to 60 minutes), and data overwrite option (Yes/No).
Smarter Labels
Go Deeper with Environmental Sensors
- Leo Lowy
- Director, Sensor Product Management
The Critical Role of Cold Chain Logistics
Value drivers exist in multiple industries and applications
Environmental Sensor Use Cases
Food & Pharma Manufacturing, Transportation and Logistics
Zebra Environmental Sensors: Core Markets & Applications
Well-suited to provide value in multiple industries and applications
- Temperature sensitive products in transit
- Ensure foods are stored in the proper condition
- Temperature Monitoring during short- or longer-term storage
- Validate high-heat processing
ZS300 Electronic Temperature Sensors
- Environmental Exposure Revealed via BLE and Cloud
- Detects temperatures from -40˚C to +85˚C, transmits data via Zebra Bridge or Android™ to the cloud
- Enables Real-Time responses to Temp events all along the Cold Chain (Transportation or Storage)
- Easily integrates with existing Transportation and Warehouse Management Systems
Solution Architecture & Connectivity
Sensor Workflow
A Summary
Sensor Workflow
In Detail
Demo Time!
Management APIs
- Included at No Charge
- Enable Management of Sensors & Task Configuration
- Enables retrieving Sensors Certificate of Calibration
Example : Creating a new task à
Data APIs
- Included in LogView and EventView subscriptions
- Provides ability to securely query and retrieve data gathered by sensors
Alarm APIs
- Included in Event View subscription
- Allows subscribing to Temp. Excursion Alarms
- NOTE: webhook listener required
Android Sensor Discover App: “ZSFinder”
Features
- Communicates with ZS300 Sensor via Bluetooth® Low Energy (v5.2).
- Discovers Sensors and enables bidirectional communication with them.
- Connects to Zebra Cloud Platform to upload sensor data.
- Offers an Android™ Interface Definition Language interface, allowing data to be retrieved from sensor for transmission to a user chosen backend system.
- NOTE: The AIDL interface is for use with the SelfView Subscription. Data is not signed during transport.
- For use on Android™ v8.1 and above.
- Access via port 80, 443 to scv.zpc.zebra.com and acs.zebra.com for certificate exchange and data transfer to the Zebra Cloud Platform.
- Requires Bluetooth® Low Energy v4.1 or later.
- Authenticated via the Android™ Services Authentication API
- ZSFinder is available on Google Play
Sensor BTLE Advertising Packet
-
The Advertising Packet is a structured set of information the ZS300 sensor sends every 1.5 seconds to let Bluetooth Low Energy (BTLE) hardware and software-based receivers “find” the sensor.
It contains information on the sensors Unique ID, battery status, last temperature read and if the sensor is in an alarm condition, plus many other attributes. -
The Advertising Packet also contains forward-looking data fields for potential future products.
-
The Advertising Packet, along with the Sensor Discovery Service app (ZSFinder) are key assets for developers using the SelfView Subscription.
Dev Tools Best Practices
Sensor Discovery App (ZSFinder)
- Use Android v8.1 or later to ensure BLTE functionality.
- Ensure that Bluetooth® is enabled on the Android™ device, and prompt user to enable if not enabled.
- If using the “SelfView” subscription, ensure that data is both retrieved from the Sensor and securely transmitted to your backend system(s).
- If using the “SelfView” subscription, ensure data is retained for up to 7 years, to support future product handling process audits.
- If using the “EventView” subscription, set up a webhook listener to capture Alarms.
- If using the Android™ Interface Definition Language feature to retrieve data from the Sensor, review the Google AIDL documentation.
- Provide feedback to end user to ensure they stay within range of the sensor when collecting data. Most Android™ devices will support a 30-foot range. Provide feedback when data collection is complete.
Zebra Cloud Platform (APIs)
- Review the Developer Guide, available here
- Keep your API keys and Tokens private and secure.
- Handle any errors that may occur during API communication in a graceful manner. This could include retrying failed requests or displaying an appropriate error message to the user.
- Use pagination for large data sets: If an API returns a large data set, consider using pagination to retrieve the data in smaller chunks. This can help to improve the performance and scalability of your application.
- Know and handle rate limits, providing users feedback where needed. The daily rate limit is 5000 calls per day per API key, with a spike rate limit of 7 calls per second per API Key.
- Keep current on API changes over time, updating your applications as needed to keep them up-to-date and fully functional. Update information is available here.
- Use the correct method for the intended action (e.g., GET, POST, PUT, DELETE). Example, use GET to retrieve data and POST to create new resources.
Documentation
Software
- Developer Portal
- “Creating an ZS300 app” blog post
- Developer Getting Started Guide
- Postman Collection
- OpenAPI Spec including
- API Description
- Example Use Case
- Sample Code
- Error Responses
- Postman Collection
- Android™ AIDL Documentation
Hardware
- User Guides for ZS300 and ZB200
- Quick Start Guides for ZS300 and ZB200
- Setup Utility App will be included with ZB200
API Subscriptions
Subscription Types | Features | Term |
---|
- Developer Subscription
- Enables Developers to create their apps
|
- Unlimited API calls
- Access to Android™ Sensor Discovery Service Access to Sensors Management APIs Access to Data APIs Access to Alerts
| 90 Days (Renewable for up to 6 months
- SelfView Subscription
- Access Data from your Cloud
|
- Unlimited API calls
- Access to Android™ Sensor Discovery Service Access to Sensors Management APIs
| 1 year
3 years
- Log View Subscription
- Enables apps to operate from Zebra’s cloud
|
- Unlimited API calls
- Access to Android™ Sensor Discovery Service Access to Sensors Management APIs Access to Data APIs
| 1 year
3 years
EventView Subscription
- Enables apps to receive real-time
- Alerts from Zebra’s cloud platform
| Unlimited API calls
- Access to Android™ Sensor Discovery Service Access to Sensors Management APIs
- Access to Data APIs Access to Alerts
| 1 year
3 years
Visual & RFID Sensors
ZeOn-Demand Printable Indicators
- Environmental Exposure Revealed with a Simple Machine Readable Visual
- Combines environmental indicator with on-demand thermal printing
- Reveals Insights into a sensitive assets
- Supports quality processes and workflows across the spectrum of label materials
- Come Build with Us!
Temperature
Humidity/Moisture
Sterilization
ZeOn-Demand High Temp RFID Labels (Q4-2023)
- Environmental Exposure Revealed Via existing RFID Infrastructure
- Combines environmental indicator with on-demand thermal printing
- Supports “High Temp” detection : 113F (45c)
- Currently in “Market Trial” : Seeking ISV’s and customers to build out software ecosystem
…and, reach out to us at sensorpm@zebra.com
Questions
Thank You
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies
Corp., registered in many jurisdictions worldwide. All other trademarks are
the property of their respective owners. ©2023 Zebra Technologies Corp. and/or
its affiliates. All rights reserved.
ZEBRA TECHNOLOGIES
References
- Android Interface Definition Language (AIDL) | Background work | Android Developers
- Data Reporting for Electronic Temperature Sensors | Developer Portal
- Electronic Temperature Sensors | Developer Portal
- Management for Electronic Temperature Sensors | Developer Portal
- Electronic Temperature Sensors - Developer Guide | Developer Portal
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>