scripts: build: parse_syscalls: Add exception handling

[Bazifrasool]

Adds exception handling to analyze_headers in parse_syscalls.py

• In case a header file contains a non utf-8 character, decode fails
• Add exception handling to inform at compile time which header file failed, so it can be resolved

[github-actions]

Hello @Bazifrasool, and thank you very much for your first pull request to the Zephyr project!
Our Continuous Integration pipeline will execute a series of checks on your Pull Request commit messages and code, and you are expected to address any failures by updating the PR. Please take a look at our commit message guidelines to find out how to format your commit messages, and at our contribution workflow to understand how to update your Pull Request. If you haven't already, please make sure to review the project's Contributor Expectations and update (by amending and force-pushing the commits) your pull request if necessary.
If you are stuck or need help please join us on Discord and ask your question there. Additionally, you can escalate the review when applicable. 😊

[tejlmand]

Please squash your commits and remove the merge commit so that there is only a single commit in this PR.

You may read more in the contribution guideline:
https://docs.zephyrproject.org/latest/contribute/guidelines.html#contribution-workflow

[Bazifrasool]

@tejlmand squashed the commits and adopted sys.stderr.write()