{"id":20885509,"url":"https://github.com/lab11/blees","last_synced_at":"2026-02-09T13:02:15.409Z","repository":{"id":30974115,"uuid":"34532335","full_name":"lab11/blees","owner":"lab11","description":"Bluetooth Low Energy Environmental Sensors","archived":false,"fork":false,"pushed_at":"2018-08-20T02:44:26.000Z","size":53172,"stargazers_count":19,"open_issues_count":3,"forks_count":10,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-08-08T13:41:24.905Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Eagle","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lab11.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-24T17:32:16.000Z","updated_at":"2024-09-12T17:05:52.000Z","dependencies_parsed_at":"2022-08-07T16:15:15.396Z","dependency_job_id":null,"html_url":"https://github.com/lab11/blees","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/lab11/blees","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fblees","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fblees/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fblees/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fblees/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lab11","download_url":"https://codeload.github.com/lab11/blees/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fblees/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29266083,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T12:53:16.161Z","status":"ssl_error","status_checked_at":"2026-02-09T12:52:30.244Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T08:13:42.579Z","updated_at":"2026-02-09T13:02:15.364Z","avatar_url":"https://github.com/lab11.png","language":"Eagle","funding_links":[],"categories":[],"sub_categories":[],"readme":"BLEES\n=====\n\n\u003cimg src=\"https://raw.githubusercontent.com/lab11/blees/master/media/blees.png\" alt=\"BLEES\" width=\"20%;\" align=\"left\"\u003e\nBLEES: Bluetooth Low Energy Environment Sensors.\n\u003cbr /\u003e\u003cbr /\u003e\nBLEES is a 1 inch round sensor tag for sensing the ambient environment. It monitors\ntemperature, humidity, light, pressure, and movement and reports its readings\nover BLE.\n\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\n\nHardware\n--------\nThe BLEES hardware is a small, once inch round sensor board that mounts onto a [Squall](https://github.com/helena-project/squall) BLE sensor tag. The board \ncurrently has four sensors:\n\n1. Temperature and Humidity (Si7021)\n2. Pressure (LPS331AP)\n3. Light (TSL2561)\n4. Accelerometer (ADXL362)\n\nThe BLEES hardware is located in the `hardware` directory, where you can find\nthe Eagle design files.\n\nSoftware\n--------\nThe [Squall](https://github.com/helena-project/squall) uses the software\nlocated in the `software` directory. Follow the directions in the [nrf5x-base Readme]\n(http://github.com/lab11/nrf5x-base#program-a-nrf51822) to\nget your machine set up to build and flash the Squall.\n\nThe primary application is\n[`software/apps/blees`](https://github.com/lab11/blees/tree/master/software/apps/blees).\nThis application samples the\nsensors and makes this data available as both broadcast advertisements and the\nEnvironmental Sensing Service for a connected device.\n\nData Reference\n--------------\n### Advertisement data\nBLEES transmits advertisements every 1000 ms containing application data.\n[Here's a useful BLE Advertisement\nprimer](http://www.argenox.com/bluetooth-low-energy-ble-v4-0-development/library/a-ble-advertising-primer/).\nThe advertisements come in two forms: environmental data and eddystone.\nAdvertisements alternate between the two evenly.\n\nThe environmental data advertised is same data as is available through the\nenvironmental sensing service, but broadcast so several nearby devices can\naccess it concurrently. The data includes, in order, four bytes for pressure,\ntwo bytes for humidity, two bytes for temperature, two bytes for light\nilluminance, and one byte for acceleration state. An example application that\ncollects BLE advertisements from BLEES devices and displays the data can be\nfound at `data_collection/advertisements/blees_adv.js`\n\n[Eddystone](https://github.com/google/eddystone) is a protocol for connecting\nBLE devices to Internet resources. BLEES advertises the URL of an application\nthat can be interpreted by the Summon framework in order to automatically\ngenerate a user interface. (see next heading)\n\n\n### Environmental Sensing Service\nBLEES is also connectable and supports the Environmental Sensing Service. While\nconnected to, it continues to advertise, but only one connection at a time is\nallowed. The environmental sensing service is defined by the\n[BLE SIG](https://www.bluetooth.org/en-us/specification/assigned-numbers/environmental-sensing-service-characteristics).\n\n\nSummon App\n----------\n[Summon](https://github.com/lab11/summon) is a UI application for BLE devices.\nRather than requiring every user\nto install a new app for every BLE device, Summon allows BLE devices to\npoint to their own HTML/JS based interface and loads it in a single\napplication. BLEES supports the summon architecture and provides\na Summon application.\n\n\nCloning\n-------\nTo clone both this repository and the required submodules,\nclone with the `--recursive` option: \n`git clone --recursive git@github.com:lab11/blees.git`\n\nOtherwise, you can initialize the submodule and keep submodules up to\ndate by doing `git submodule update --init --recursive`\n\nIf you think all of this is ridiculous and git should just handle submodules automatically, use this:\nhttps://gist.github.com/brghena/fc4483a2df83c47660a5\n\nOther Hardware\n--------------\n\nIncluded in this repo are:\n\n### Blink\n\n\u003cimg src=\"https://raw.githubusercontent.com/lab11/blees/master/media/blink_large_1000x790.jpg\" width=\"25%\" align=\"left\"\u003e\n\nBlink is a PIR sensor that is also based on Squall. Like BLEES, it supports Summon.\nThe nRF51822 app is [here](https://github.com/lab11/blees/tree/master/software/apps/blink).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flab11%2Fblees","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flab11%2Fblees","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flab11%2Fblees/lists"}