{"id":15797291,"url":"https://github.com/alexeden/bno055-imu-node","last_synced_at":"2025-06-25T09:38:45.539Z","repository":{"id":34911561,"uuid":"188717727","full_name":"alexeden/bno055-imu-node","owner":"alexeden","description":"Interface with a BNO-series IMU from your Node.js app over I2C","archived":false,"fork":false,"pushed_at":"2022-12-10T17:44:52.000Z","size":2431,"stargazers_count":4,"open_issues_count":12,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-08T03:09:57.246Z","etag":null,"topics":["bno055","embedded","imu","imu-sensor","nodejs","raspberry-pi","rpi","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/alexeden.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":"2019-05-26T18:25:56.000Z","updated_at":"2025-04-30T00:46:21.000Z","dependencies_parsed_at":"2023-01-15T10:16:21.897Z","dependency_job_id":null,"html_url":"https://github.com/alexeden/bno055-imu-node","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/alexeden/bno055-imu-node","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexeden%2Fbno055-imu-node","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexeden%2Fbno055-imu-node/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexeden%2Fbno055-imu-node/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexeden%2Fbno055-imu-node/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexeden","download_url":"https://codeload.github.com/alexeden/bno055-imu-node/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexeden%2Fbno055-imu-node/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259578217,"owners_count":22879216,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bno055","embedded","imu","imu-sensor","nodejs","raspberry-pi","rpi","typescript"],"created_at":"2024-10-05T00:06:19.914Z","updated_at":"2025-06-25T09:38:45.489Z","avatar_url":"https://github.com/alexeden.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![npm version](https://img.shields.io/npm/v/bno055-imu-node.svg?style=for-the-badge\u0026logo=npm\u0026color=c41949)\n\n# BNO055 IMU + Node.js\n\n## Install\n\n```\nnpm install --save bno055-imu-node\n```\n\n## Usage\n\n```ts\nimport {\n  BNO055,\n  // Enums:\n  OpMode,\n  DeviceAddress,\n  PowerLevel,\n} from 'bno055-imu-node';\n\n// All BNO055 instance methods are async and return a promise\n(async () =\u003e {\n  // Start the sensor\n  // The begin method performs basic connection verification and resets the device\n  const imu = await BNO055.begin(\n    DeviceAddress.A,    // Address enum: A = 0x28, B = 0x29\n    OpMode.FullFusion   // Operation mode enum\n  );\n\n  // Get the sensors' calibration status\n  const calibration = await imu.getCalibrationStatuses();\n\n  // Check to see if the device is fully calibrated\n  const isCalibrated = await imu.isFullyCalibrated();\n\n  // Get information about the device's operational systems\n  const systemStatus = await imu.getSystemStatus();\n  const systemError = await imu.getSystemError();\n  const selfTestResults = await imu.getSelfTestResults();\n  const versions = await imu.getVersions();\n\n  // Get the device's orientation as a quaternion object { x, y, z, w }\n  const quat = await imu.getQuat();\n\n  // Force the device to reset\n  await imu.resetSystem();\n\n  // Set the device power level (Normal, Low, or Suspend)\n  await imu.setPowerLevel(PowerLevel.Normal);\n\n  // Force the device to use an external clock source\n  await imu.useExternalClock();\n\n  // Verify that the device is connected (will throw an error if not)\n  await imu.verifyConnection();\n})();\n```\n\n## Workflow\n\n\u003e Make sure you have [passwordless SSH](https://www.raspberrypi.org/documentation/remote-access/ssh/passwordless.md) access to your Raspberry Pi.\n\nClone/fork your repo onto both your local machine and your Raspberry Pi.\n\n`npm install` inside the project on both your local machine and the remote device.\n\nCreate a file called `sync.config.json` on the machine on which you'll be developing, and substitute these values with your own:\n\n```jsonc\n{\n  \"username\": \"\u003c\u003c\u003cusername\u003e\u003e\u003e\",\n  \"hostname\": \"\u003c\u003c\u003chostname or IP address of your remote device\u003e\u003e\u003e\",\n  \"directory\": \"\u003c\u003c\u003cparent directory on remote device into which the repo was cloned\u003e\u003e\u003e\",\n  \"quiet\": false // Disable most rsync logs (defaults to false)\n}\n```\n\n**Locally**, you can now run `npm run sync-changes`, and any changes made to files inside `/src` or `/examples` will automatically be uploaded to your Pi.\n\n\u003e You can configure which excluded from uploaded by opening `sync.js` and modifying the `exclude` option passed to `Rsync.build`.\n\n**From the remote device**, you can run `npm run build-changes`, and any changes pushed from your local machine will automatically be rebuilt. You can run additional scripts (test scripts, etc) by appending the shell commands to the `exec` property inside `nodemon.build.json`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexeden%2Fbno055-imu-node","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexeden%2Fbno055-imu-node","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexeden%2Fbno055-imu-node/lists"}