Troubleshooting

Known issues

1. Pinecil not detected

   • possible reason: pinecil is paired to computer/phone settings. solution: unpair it from all other places and reboot.
   • possible reason: using older firmware (below 2.21). solution: flash current BLE firmware; below IronOS 2.21 only beta versions work with PineSAM.

2. bleak causes Python to crash on Mac: https://github.com/hbldh/bleak/issues/768

   • possible solution: give access to iTerm (or whichever terminal you use) to Bluetooth in Settings

3. PineSAM script terminal crashes on start of script: incompatible version of IronOS, check/update firmware see .

4. Windows Powershell issue

   • windows by default does not allow any scripts to run in powershell. Make sure the zip file property is Unblock (reference) and set powershell to remotesigned with:
     set-executionpolicy remotesigned
   • check that windows has not reset the permissions in powershell with Get-ExecutionPolicy and change it back to RemoteSigned if needed (reference).

5. See the Discussions section for install hints, screenshot images, and solutions to common issues.

6. Something else: open an issue .

Running Unit tests

For development work

Run inside 'backend' folder

pipenv run test

---