{"id":13743610,"url":"https://github.com/ArduPilot/SiK","last_synced_at":"2025-05-09T01:31:17.572Z","repository":{"id":1789814,"uuid":"2713719","full_name":"ArduPilot/SiK","owner":"ArduPilot","description":"Tools and firmware for the Si1000","archived":false,"fork":false,"pushed_at":"2023-10-28T22:33:34.000Z","size":3715,"stargazers_count":281,"open_issues_count":47,"forks_count":231,"subscribers_count":43,"default_branch":"master","last_synced_at":"2024-11-09T12:09:48.457Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"jbramblegmu/Laphroaig18","license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArduPilot.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2011-11-05T03:34:08.000Z","updated_at":"2024-10-13T20:56:58.000Z","dependencies_parsed_at":"2024-01-15T00:11:16.807Z","dependency_job_id":"4a18beaf-e815-4703-ae5c-9bf724d46f91","html_url":"https://github.com/ArduPilot/SiK","commit_stats":{"total_commits":741,"total_committers":23,"mean_commits":32.21739130434783,"dds":0.4939271255060729,"last_synced_commit":"3e7b5b8db0158373c27d004c7d72e9caf50f55cd"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FSiK","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FSiK/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FSiK/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArduPilot%2FSiK/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArduPilot","download_url":"https://codeload.github.com/ArduPilot/SiK/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224796493,"owners_count":17371500,"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":[],"created_at":"2024-08-03T05:00:53.151Z","updated_at":"2024-11-15T14:31:34.383Z","avatar_url":"https://github.com/ArduPilot.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"SiK\n=====\nFirmware for SiLabs Si1000 - Si102x/3x/6x ISM radios\n\n[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ArduPilot/SiK?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nSiK is a collection of firmware and tools for radios based on the cheap, versatile SiLabs Si1000 and Si1060 SoC.\n\n## Branch Build Status\n[![Build Status](http://jenkins.hovo.id.au/buildStatus/icon?job=SiK)](http://jenkins.hovo.id.au/job/SiK/)\n\n## Documentation\nFor user documentation please see [ardupilot docs](http://ardupilot.org/copter/docs/common-sik-telemetry-radio.html)\n\nCurrently, it supports the following boards:\n\n - HopeRF HM-TRP\n - HopeRF RF50-DEMO\n - RFD900\n - RFD900u\n - RFD900p\n - [MLAB ISM01A](https://www.mlab.cz/module/ISM01A)\n\nAdding support for additional boards should not be difficult.\n\nCurrently the firmware components include:\n\n - A bootloader with support for firmware upgrades over the serial interface.\n - Radio firmware with support for parsing AT commands, storing parameters and FHSS/TDM functionality\n\n### AT commands\n\n|Command| Variants| Function |\n|-------|--------|----------|\n|+++    | |Entering bootloader mode. Could be tested by sending AT, reply should be OK|\n|RT     | |remote AT command - send it to the tdm, system to send to the remote radio |\n|AT\u0026F   | |  Restore default parameters |\n|AT\u0026W| | Write parameters to the flash memory | \n|AT\u0026U | | Erase Flash signature forcing it into reprogram mode next reset |\n|AT\u0026P | | TDM change phase |\n|AT\u0026T | AT\u0026T \u003cbr\u003e AT\u0026T=RSSI \u003cbr\u003e AT\u0026T=TDM |  disable all test modes \u003cbr\u003e display RSSI stats \u003cbr\u003e display TDM debug ) |\n|AT\u0026E | AT\u0026E?  \u003cbr\u003e AT\u0026E= | Print_encryption_key \u003cbr\u003e Set encryption key | \n|AT+ | AT+P= \u003cbr\u003e AT+Cx=y \u003cbr\u003e AT+Fx? \u003cbr\u003e AT+L \u003cbr\u003e AT+A |  set power level pwm to x immediately \u003cbr\u003e  write calibration value \u003cbr\u003e get calibration value \u003cbr\u003e lock bootloader area if all calibrations written \u003cbr\u003e RFD900 antenna diversity  |\n|ATI0| | banner_string |\n|ATI1| | version_string  |\n|ATI2| | BOARD_ID |\n|ATI3| | Board design frequency|\n|ATI4| | Board boot loader version|\n|ATI5| | Parameters |\n|ATI6| | TDM timing |\n|ATI7| | Show RSSI |\n|ATP |  ATPx=O \u003cbr\u003e ATPx=I \u003cbr\u003e ATPx=R \u003cbr\u003e ATPx=Cx | Set pin to output, turn mirroring off pulling pin to ground    |\n|ATO | |    |\n|ATS | ATS? \u003cbr\u003e ATS= | \u003cbr\u003e Set a parameter  |\n|ATZ | | Generate a software reset    |\n\nUp to date AT command processig is located in [at.c](Firmware/radio/at.c) source code.\n\n## What You Will Need\n\n - A Mac OS X or Linux system for building.  Mac users will need the Developer Tools (Xcode) installed.\n - At least two Si1000 - Si102x/3x - based radio devices (just one radio by itself is not very useful).\n - A [SiLabs USB debug adapter](http://www.silabs.com/products/mcu/Pages/USBDebug.aspx).\n - [SDCC](http://sdcc.sourceforge.net/), version 3.1.0 or later.\n - [EC2Tools](https://github.com/SamwelOpiyo/ec2)\n - [Mono](http://www.mono-project.com/) to build and run the GUI firmware updater.\n - Python to run the command-line firmware updater.\n\nNote that at this time, building on Windows systems is not supported.  If someone wants to contribute and maintain the necessary pieces that would be wonderful.\n\n## Building Things\n\nType `make install` in the Firmware directory.  If all is well, this will produce a folder called `dst` containing bootloader and firmware images.\n\nIf you want to fine-tune the build process, `make help` will give you more details.\n\nBuilding the SiK firmware generates bootloaders and firmware for each of the supported boards. Many boards are available tuned to specific frequencies, but have no way for software on the Si1000 to detect which frequency the board is configured for. In this case, the build will produce different versions of the bootloader for each board. It's important to select the correct bootloader version for your board if this is the case.\n\n## Flashing and Uploading\n\nThe SiLabs debug adapter can be used to flash both the bootloader and the firmware. Alternatively, once the bootloader has been flashed the updater application can be used to update the firmware (it's faster than flashing, too).\n\nThe `Firmware/tools/ec2upload` script can be used to flash either a bootloader or firmware to an attached board with the SiLabs USB debug adapter.  Further details on the connections required to flash a specific board should be found in the `Firmware/include/board_*.h` header for the board in question.\n\nTo use the updater application, open the `SiKUploader/SikUploader.sln` Mono solution file, build and run the application. Select the serial port connected to your radio and the appropriate firmware `.hex` file for the firmware you wish to uploader.  You will need to get the board into the bootloader; how you do this varies from board to board, but it will normally involve either holding down a button or pulling a pin high or low when the board is reset or powered on.\n\nFor the supported boards:\n\n - HM-TRP: hold the CONFIG pin low when applying power to the board.\n - RF50-DEMO: hold the ENTER button down and press RST.\n - RFD900x: hold the BOOT/CTS pin low when applying power to the board.\n\nThe uploader application contains a bidirectional serial console that can be used for interacting with the radio firmware.\n\nAs an alternative to the Mono uploader, there is a Python-based command-line upload tool in `Firmware/tools/uploader.py`.\n\n## Supporting New Boards\n\nTake a look at `Firmware/include/board_*.h` for the details of what board support entails.  It will help to have a schematic for your board, and in the worst case, you may need to experiment a little to determine a suitable value for EZRADIOPRO_OSC_CAP_VALUE.  To set the frequency codes for your board, edit the corresponding `Firmware/include/rules_*.mk` file.\n\n## Resources\n\nSiLabs have an extensive collection of documentation, application notes and sample code available online.\n\nStart at the [Si1000 product page](http://www.silabs.com/products/wireless/wirelessmcu/Pages/Si1000.aspx) or [Si102x/3x product page](http://www.silabs.com/products/wireless/wirelessmcu/Pages/Si102x-3x.aspx)\n\n## Reporting Problems\n\nPlease use the GitHub issues link at the top of the [project page](http://github.com/tridge/SiK) to report any problems with, or to make suggestions about SiK.  I encourage you to fork the project and make whatever use you may of it.\n\n## What does SiK mean?\n\nIt should really be Sik, since 'K' is the SI abbreviation for Kelvin, and what I meant was 'k', i.e. 1000.  Someday I might change it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FArduPilot%2FSiK","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FArduPilot%2FSiK","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FArduPilot%2FSiK/lists"}