From 829c1cb8ddcff74dffe6f552288a5e41ce5cb31b Mon Sep 17 00:00:00 2001 From: Hans Christian Olaussen <41271048+klutvott123@users.noreply.github.com> Date: Sat, 9 May 2020 18:20:34 +0200 Subject: [PATCH] Update readme Added instructions for background script. Removed 4.1.0 requirement. Merged "How to download the scripts" into "Installing" section. some minor changes. --- README.md | 20 ++++++++++-------- .../assets/images/background_script_setup.png | Bin 0 -> 1353 bytes 2 files changed, 11 insertions(+), 9 deletions(-) create mode 100644 docs/assets/images/background_script_setup.png diff --git a/README.md b/README.md index a55ad2d7..eb175806 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,8 @@ -# betaflight-tx-lua-scripts - -## How to download the scripts - -Please visit the [releases page](https://github.com/betaflight/betaflight-tx-lua-scripts/releases) to download a zip file containing latest version. +# Betaflight TX Lua Scripts ## Firmware Considerations -- Betaflight - 4.1.0 or newer. As a best practice, it is recommended to use the most recent stable release of Betaflight to obtain the best possible results; +- Betaflight - As a best practice, it is recommended to use the most recent stable release of Betaflight to obtain the best possible results; - OpenTX - 2.3.4 or newer; - Crossfire TX / RX - v2.11 or newer; - FrSky TX / RX - While most receivers work fine, it's recommended to update the XSR family of receivers to their most recent firmware version to correct any known bugs in SmartPort telemetry. @@ -15,9 +11,9 @@ Please visit the [releases page](https://github.com/betaflight/betaflight-tx-lua **!! IMPORTANT: DON'T COPY THE CONTENTS OF THIS REPOSITORY ONTO YOUR SDCARD !!** -Unzip the files from the link above and drag the contents to your radio. If you do this correctly, the SCRIPTS directory will merge with your existing directories, placing the scripts in their appropriate paths. You will know if you did this correctly if the `bf.lua` file shows up in your `/SCRIPTS/TOOLS` directory. +Download a zip file containing the latest version from the [releases page](https://github.com/betaflight/betaflight-tx-lua-scripts/releases). -The src directory is not required for use and is only available for maintenance of the code. While it may work to use this directory, you may encounter memory issues on your transmitter. +Unzip the files from the link above and drag the contents of the `obj` folder to your radios SD card. If you do this correctly, the `SCRIPTS` directory will merge with your existing directories, placing the scripts in their appropriate paths. You will know if you did this correctly if the `bf.lua` file shows up in your `/SCRIPTS/TOOLS` directory. ### How to install @@ -46,8 +42,14 @@ Due to issues with input mapping and memory overruns, running the script as a te If you are using a VTX that supports the SmartAudio or Tramp protocols then bands and channels etc. are managed using VTX tables since Betaflight version 4.1.0. The script will be downloading and storing the current VTX table for every model the first time the model is connected and the script is run. If you change the VTX table, you have to re-load the updated VTX table in the script, by choosing the 'vtx tables' option in the function menu. +### Background script +The optional background script offers RTC synchronization and RSSI through MSP. It can be setup as a special or global function in OpenTX. The image below shows how to run the background script as a special function. + +![Background script setup](docs/assets/images/background_script_setup.png) + + ## Building from source - Be sure to have `make` and `luac` in version 5.2 installed in the path - Run `make` from the root folder -- The installation files will be created a the `obj` in the root folder. Copy the files to your transmitter as instructed in the '[Installing](#installing)' section below as if you unzipped from a downloaded file. +- The installation files will be created in the `obj` folder. Copy the files to your transmitter as instructed in the '[Installing](#installing)' section as if you unzipped from a downloaded file. diff --git a/docs/assets/images/background_script_setup.png b/docs/assets/images/background_script_setup.png new file mode 100644 index 0000000000000000000000000000000000000000..fabb458ecd7154d1279477624c35060fab60cb52 GIT binary patch literal 1353 zcmX|>e^8Ql9LFCeXR=bePOS`Rxye;?S1UA=&^A5u=O}HcrM6}1XxbDpHFeUuHMik2 zGb=U0hQB(<$Dy4eg5Avk(<1UYx(mtDm+XHN)PVG9f17n^%^ zW_;g;F<(~)W)$1`NqW{t#)5Umf@>+&UdMODY^i4kRi%8%j_PX9Dsf$zshZ09>A!sW zct-o!jJ9j3V_}%0FIuu{(Sf-u8qGtI6_JDt(W}ji7R{Bpc`vL)>ndY}4!>$i9$AZ&PF^bK~IFjL-|;1U(;N1&V)b#CBfP5Nj1N^q)qR0 zOJ1;z7CSRKba*i>)vuXK(Dy1lzF%ll-TH8S@*7zNU7SB|8oWDyWcn$xWVk!v)?Xyr zY&OU@SP;%}d@91JPegJXx+RFOupU~n9M&JUUg@q9kj>S;w(6@6$u)*v22d(2`l$D0T6@O$d469D zV|Za3MtWnpJA5dThGDKq5?Xkh!}5L=_(3TS=ws^kwPh6roaVFZ)Izyv=Ghr>JVH-W z2*gr#Yj;m%XEXpEvzg}~aZ`K2LOQ_}h?-h{X03yvo}5?YVzw2S<^@YNU8yUaE|OmLs&PmQCsXd1;v{_*V{i8z zlfHzSAE1P)d4uVOkhuHuE^OAP*4vG8zke5OoL^fD>7JSFq7p}SeCox-%{p;bc$do@K0G{$o>UM!$tv%kVjn1%;m_qvU zQJG2BQJ8#SbP>ED;V~1)`rQY8oMLgMn>%1_O<_V;DkhcCE?em+KX{Sbzg$XWAVc=73^?{8= xDH%7wXL}307xmOTybreqNX3Bi&@$}>0&h0*(^b(Sa`112!a|~ho4+`E_J5>*x^(~m literal 0 HcmV?d00001