openc3-cosmos-tool-docs 5.12.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/LICENSE.txt +729 -0
- data/README.md +42 -0
- data/Rakefile +42 -0
- data/plugin.txt +7 -0
- data/tools/docs/404.html +16 -0
- data/tools/docs/CNAME +1 -0
- data/tools/docs/assets/css/styles.7bc79028.css +1 -0
- data/tools/docs/assets/images/add_packet-f318d0e92e8a13bd56331350aa341c88c8b12f2c54a4424f6e287817f22fb327.png +0 -0
- data/tools/docs/assets/images/architecture-b78f12eba076a0c07af7abdd9dd4187c59aa6b4f5c51b47ad03f73e9f98a6ed6.png +0 -0
- data/tools/docs/assets/images/autonomic-3d6d152f700c8fc1878d0f952d013ace31fccd7872d28587dc761610a0959e9c.png +0 -0
- data/tools/docs/assets/images/bucket_explorer-983c087ee3bdcf8626219e782620b6c580fd82bfe2e8b0c662a0f90cdca43838.png +0 -0
- data/tools/docs/assets/images/calendar-9fbd635cf3df1ba684bb0c1ebc4f6ad34991efc582e9fd07820c8b74cbb66aa1.png +0 -0
- data/tools/docs/assets/images/checks_rb-a6049cdd99613cea2ee12d76fcfe798ff05270e39d208e93d37da7347049b2b3.png +0 -0
- data/tools/docs/assets/images/cmd_tlm_server-313e3f64afc0e374d9d28b46364235d7b793001f84690fc0ae90e1eefdd9142d.png +0 -0
- data/tools/docs/assets/images/command_sender-a0b113b65368263529d0f8f2d93276a0a44ed81af0d0100f56379346ba592928.png +0 -0
- data/tools/docs/assets/images/commands-3608d5c856fd34e771d1f9e69f9f449f52929249bdf4f0e7feed0aa2bd2d9fd7.png +0 -0
- data/tools/docs/assets/images/connecting-6e453f3d99800d4cb8fdc78f5b8fce1e8cf1bb04840a29dec7c5caefd07c004f.png +0 -0
- data/tools/docs/assets/images/data_extractor-62c5b1743ba9dfdff2e393bcbdf863c36effc5ef5319d845cfd17186bd757bca.png +0 -0
- data/tools/docs/assets/images/data_viewer-8c547cb5ad2ebd179aac5e46c2f4c147889ebad53a5359a5e6b6c580de7184fe.png +0 -0
- data/tools/docs/assets/images/date_chooser-10f7b740b9acc76604e5dc86fe409b6b777abe0fb3fa5ebf8f47cb1ac58b9676.png +0 -0
- data/tools/docs/assets/images/debug-04088348cc04bb8e1a1063fc44920dc8e39616840ef4b09a36c823f185c28669.png +0 -0
- data/tools/docs/assets/images/delete_all_mouseover-06083f3d3d712d39f21bc5eda45adbfff449732a2061e53cb1a0baf6c5f5d4b8.png +0 -0
- data/tools/docs/assets/images/delete_modified-a7ec0ceb61c37398d57fcecf11ebe2453ebd0110be6cfc960a5073a13a557638.png +0 -0
- data/tools/docs/assets/images/edit_all_items-2c57aff19d3b1ce52149c37f50dcaad8c30baa0c9931fdc629f1d163bb56ce96.png +0 -0
- data/tools/docs/assets/images/edit_all_mouseover-f6646df5320045ee10d4c0a15d0349fed6ede075f9cea6f9e449b3785c4f4f8d.png +0 -0
- data/tools/docs/assets/images/edit_graph-4ca61635376fae26cf5eb82fb9fd803f1a51c4d3584aaf9833a270b7916bf531.png +0 -0
- data/tools/docs/assets/images/edit_screen-5724ae13958c1631b3c187cf7cdb6dc9672ecd71f8b0786ac17c0266001edac3.png +0 -0
- data/tools/docs/assets/images/edit_temp1-7446e7c5b7869ccc9ddd467779fa86f44301a5e5896751b016a527587c483cb2.png +0 -0
- data/tools/docs/assets/images/file_menu-2fe13872737c0f3fef84ba5b58b80b609082733acce536ec1f56910c36f68299.png +0 -0
- data/tools/docs/assets/images/file_open-319761fd383fc513b3689ef0a7498c73ce9459a3967c8a395cc2da07c89240d0.png +0 -0
- data/tools/docs/assets/images/file_save_as-44468ed6a48bea3bc4fdd8f50d802569e4582b453e5bf946bfdcba400030d499.png +0 -0
- data/tools/docs/assets/images/four_graphs-826cf8145338fa46e037556df94c59aeb4448330b601953daa94c89de8494cfd.png +0 -0
- data/tools/docs/assets/images/graph_min_max-80a2bd83230c71b00ba9d6da24b8c32a09e4983976cdbf32c33d2680b534b106.png +0 -0
- data/tools/docs/assets/images/graph_temp1-de937a79b314cf856b783c936d2460a6c942bdd45e4d9b3fe488957df5bfa9bc.png +0 -0
- data/tools/docs/assets/images/graph_temp1_temp2-e96370f7d73a6cb68beaa92bcaaf18b72e6619ce948fe835762cca1048efbd18.png +0 -0
- data/tools/docs/assets/images/graph_temp1_time-fec5e99e3cc05ea87208abe9c4b66b63b7497bbefee55f65d034417e966b1c46.png +0 -0
- data/tools/docs/assets/images/handbooks-1d301c83c80a7cb96c548006f5139fe8ec967ed10a49df0142b37328cd987f33.png +0 -0
- data/tools/docs/assets/images/ignored-1e20d4ffe7fd88ffab610340957b1176294269f985e8fdb20a9af07d7a78215f.png +0 -0
- data/tools/docs/assets/images/inst_clear-5ecb859f06f14d91d2ebba27e5a7848d6393db5ad2357f95c12e776c45f6bc64.png +0 -0
- data/tools/docs/assets/images/inst_collect-4f4e453a6521b779e10c4d2be6a8b1acf15fcb083af0164b0df1de27ca250132.png +0 -0
- data/tools/docs/assets/images/inst_collect_hazardous-3aeabedb96bf114b4eb56b6b2ee7bcc601302ec8905a82a16c47ae7870f97978.png +0 -0
- data/tools/docs/assets/images/inst_collect_hazardous_history-952a6e6ff2fb1b5fdf2c6b3d84a3ccf9e303eeb310f35514dc4a6e95f2a7420e.png +0 -0
- data/tools/docs/assets/images/inst_collect_sent-0de429f724264ce8c52a6cb22d4bbb96f14e22b559c091ff4375bb59f124a7a2.png +0 -0
- data/tools/docs/assets/images/inst_collect_sent_3-91cf4e053d246917964330ab93534a0a5eb878b652e7ea879effca7c4eaefbea.png +0 -0
- data/tools/docs/assets/images/interface_read_logic-0deef27c1d2fec9de2a3720a3c9ecedb21a00dca7aabd13da0b8815c037e4c26.png +0 -0
- data/tools/docs/assets/images/interface_write_logic-3360afe1b4af20b10dafba848a21e09baccaacc06e2ec8b6c132ac7a3c99e994.png +0 -0
- data/tools/docs/assets/images/interfaces-5622abf50e3df63980661a48216bf71187f38cb636bd512f48917ca4a425f083.png +0 -0
- data/tools/docs/assets/images/items_table-2fc1bb4d03a2348c4af7df442e13cee2f310cf455228005d76cbfda7a706aa53.png +0 -0
- data/tools/docs/assets/images/items_table_raw-c4d454679c4503ec35710dcee6be5cd1940984595145b333d8604bc505dfe291.png +0 -0
- data/tools/docs/assets/images/items_table_temp1-ea091eaf8005cea839800f4514f72f94e9664993111b935f33e7c5aa3061ca64.png +0 -0
- data/tools/docs/assets/images/limits_monitor-c58d70daea7586b93d5069b9df068a90cea5f7cf2e51a445f3162bf3f66db3d0.png +0 -0
- data/tools/docs/assets/images/list_view-926f42bc1e43283c61616b0cd8fd630cad8e15c9b7298acd98536842472e673b.png +0 -0
- data/tools/docs/assets/images/log-ba64fd307e53adafae55fcea7eb31829ee1aacdf4aafe8b40b270b793be3aa27.png +0 -0
- data/tools/docs/assets/images/log_messages-19c3ce9c7ff86e43d459cb6591df8c05d25e1390d857728cb462a57b9d3ccc69.png +0 -0
- data/tools/docs/assets/images/log_messages-2cfad0fd6f6f980f69b5564a4b7ecfecf3331c6256c78bcfb2b084970db305ca.png +0 -0
- data/tools/docs/assets/images/minimized-59d0d8d8a179ff0475787e87237b77b24d59d78826d43dbc1a554a51380eb37f.png +0 -0
- data/tools/docs/assets/images/minimized-a658bd8f2115d3f9a386844e886de770b23bbf9c0c8c55a4ca587cea67ec320e.png +0 -0
- data/tools/docs/assets/images/minio-150460ac77a50711835de6f0150d019000e5515afae0f3adfcdda8e891484f47.png +0 -0
- data/tools/docs/assets/images/mouseover-95b774047b3c2ca23a3bc645caf75d90511c378729dd9cfb781510a1452e09fe.png +0 -0
- data/tools/docs/assets/images/new_screen-295720ec60219194c8c8dd64c755e8a188cc4a68c2b6cf66197b54514644d52a.png +0 -0
- data/tools/docs/assets/images/notifications-5b32d6619542431027ddd67491eb445469fa2d16fa8352a2b0917b9298b7bbb2.png +0 -0
- data/tools/docs/assets/images/open_config-2e61415a3c2d7a4ce427cf325f3708dd4a761092b7dd0c869279c4354dc34ae4.png +0 -0
- data/tools/docs/assets/images/open_config-3cd3be1ce4560d9e72bb37b83dc830149091dec9a088c36187e0e72660c6ec34.png +0 -0
- data/tools/docs/assets/images/open_config-55ef2f241d02047b252bb8201742f99cffed5680d0e9eb46b3cb53a644ca3dc9.png +0 -0
- data/tools/docs/assets/images/open_config-f848a8b371ae0ec31776834148e9f978d9be94efef03534e5ca3a59c0ae3847f.png +0 -0
- data/tools/docs/assets/images/packet_viewer-19c1015cc704a98d1f6d90dd0dadc13188d25f1d5d2e838b7cfb226e8c173c7b.png +0 -0
- data/tools/docs/assets/images/plugin-variables-5bc00c744182c9a9591e84cb3bbb1c4deb53ff22e05f62ce1b807c26bed782e5.png +0 -0
- data/tools/docs/assets/images/processing-b0c50908284739a76e1bbcfcb3eb34dc9446f8716117cb0e9089ad9df53ebed6.png +0 -0
- data/tools/docs/assets/images/project-fe7ac90f3e45971fca8f1be94be9dbabe494bafe705e7f8f485676e9d96e47ea.png +0 -0
- data/tools/docs/assets/images/project_update-8e7de3b0658b95d4d9931eb52ff8bf339d633cbdc273ce096eb11ceb357c009e.png +0 -0
- data/tools/docs/assets/images/raw_command-759d93759a73a6a3dd7e30f89fc4d1a544dfb6f7355abfed03897d404279161d.png +0 -0
- data/tools/docs/assets/images/raw_telemetry-ffeb6b603f9a9abbe0cb77afaaeb4b4f07dfee479682a5c9661f85589a679049.png +0 -0
- data/tools/docs/assets/images/raw_tlm_logs-8dcba4f020b36f8efbb793271b70d40d9cad627196afaeb5bf6f3931ed53fa52.png +0 -0
- data/tools/docs/assets/images/reactions-dd4a8ebf22eed921a82a5478d23178c62e2cf944d295c2b9e3f4d7ce555b0fcc.png +0 -0
- data/tools/docs/assets/images/reload_file-8e26cd3e1bc1eab7bb6c046d9a6a8231fcd76e56682d819b1e549182890c6486.png +0 -0
- data/tools/docs/assets/images/reloaded-9effa15527244928ee503eb0c3a48cc5e82c07cfb5d5c4300eacfcab913069d1.png +0 -0
- data/tools/docs/assets/images/running_scripts-78bfd36a6c8c7167234e03bd188e974927c2beea1f730498583169a81639e7a3.png +0 -0
- data/tools/docs/assets/images/save_config-0ae36ac1f8114665f2558e936ba3b30e5cba2a16cc01d3494e14ed689b4637f7.png +0 -0
- data/tools/docs/assets/images/save_config-8b028134b07c70d6de019825cbb328623fc485d72aad9ba5b1980246b316fec2.png +0 -0
- data/tools/docs/assets/images/save_config-e4ed80276ebdc2c4eaf9aaeb859cff8aecb380b22da8c659741c31ca66914098.png +0 -0
- data/tools/docs/assets/images/save_config-e748a338526ffd8f9e49def5c0d15f8a80cd987f40d210ff6c6d4b61b713555c.png +0 -0
- data/tools/docs/assets/images/script_error-ce060b3086e7b466e51a276fb6b27245b4d042f07a60fe121b0071dd65a42075.png +0 -0
- data/tools/docs/assets/images/script_runner-7d7f01b90be962b4de46c20568727c55488eec5d9844823b53a262c9cfc470fa.png +0 -0
- data/tools/docs/assets/images/script_suite-42832d936f91417740b76a39841996c8e4a7cf5391dbb19abe9d7b31ab07dd7d.png +0 -0
- data/tools/docs/assets/images/select_item-f063106a8d836656496ba81e7e7428f51bd8ab95aebab0aa4eb6ad41ed42e026.png +0 -0
- data/tools/docs/assets/images/select_packet-0b6d5a2b012445ab2bf0fd3e1545f015cd7787280d05d2bccb0a9c9220102529.png +0 -0
- data/tools/docs/assets/images/select_packet-be9d63c49f898cccb73f9e4b2b39c4b5879cead34a8ab2ede0bb08e953498e95.png +0 -0
- data/tools/docs/assets/images/select_target-71ebcab6cbefafd8958939130861a75f7544e99a043d90fa0734ec2f983d835f.png +0 -0
- data/tools/docs/assets/images/simple_screen-3c9d6d2366c716c03a301396a4ce0ea418532890f349d9bc9ebb8be90983a6e6.png +0 -0
- data/tools/docs/assets/images/status-80010882300d2f1c453fbc4cb35bdb1f06d3db578266dda95c56ea7ec230ac72.png +0 -0
- data/tools/docs/assets/images/table_manager-9a5357ce536102bc1bb0c859be552f4ac82f62e538935a3c45a8e76d4f9744db.png +0 -0
- data/tools/docs/assets/images/targets-d15296b133787be4997c3d5e7d43eec9030831f1758508a8f6a71d40d04478ce.png +0 -0
- data/tools/docs/assets/images/telemetry-3f1169fc67b3d2427047ba66a9b2f3ddf71f61edf498ee70d14e78f0ef3c1e3c.png +0 -0
- data/tools/docs/assets/images/telemetry_grapher-a96b7e0101f5e377a73a186683e967e79d748c5dff2dfed6ec0afcea5694d7c8.png +0 -0
- data/tools/docs/assets/images/telemetry_viewer-be6ee576f1efceb39c2f744889deb4c18f571c4922c69d5d0e5f49a653776a46.png +0 -0
- data/tools/docs/assets/images/temp1_details-f0b6e62bc28da18febacc936112735e1dbd5718ef675668f04d8b3e060d7f87a.png +0 -0
- data/tools/docs/assets/images/time_chooser-e4ca0705d5b97c3056b0de3ab7f71f8091482b9b2e8904e69866a43ce4e616f2.png +0 -0
- data/tools/docs/assets/images/timeline_lifecycle-0bd916dee06bf67936b043abfdbc4d5fdec7cc5a32a889ee6c05e9faf74f4c6a.png +0 -0
- data/tools/docs/assets/images/triggers-0b0b3f9cc2850c1b83b9a7aab6f8a936626fd847c3158e993e4baa0e64b38096.png +0 -0
- data/tools/docs/assets/images/two_full_height-7cf9d0bbdf0269ad85e312f6dcb77930e1e3c4319f9750968a9347fafcf26084.png +0 -0
- data/tools/docs/assets/images/two_full_width-db2d88c0e2e6fc417016f47e3bac0bf68374957d8fc014220f53870429ea1ef3.png +0 -0
- data/tools/docs/assets/images/view_portal-b2e5fef00be80f1551b965d170fc3cd8ed95597f0a1e475a8177ab2d306215f5.png +0 -0
- data/tools/docs/assets/images/view_portal_add-56f06135fc56f1fa85cbc22ea3b7ad52f311641aad25df08b6f4a6f979b30e3f.png +0 -0
- data/tools/docs/assets/js/019369f3.bb600de8.js +1 -0
- data/tools/docs/assets/js/058ffc22.ce27f074.js +1 -0
- data/tools/docs/assets/js/0686a885.5fe3bfd4.js +1 -0
- data/tools/docs/assets/js/078dbab0.0a98e0c9.js +1 -0
- data/tools/docs/assets/js/0f5d161c.3a7b00e4.js +1 -0
- data/tools/docs/assets/js/0ff569c9.930bab08.js +1 -0
- data/tools/docs/assets/js/103cc3be.451dd416.js +1 -0
- data/tools/docs/assets/js/1131.f9e1547d.js +1 -0
- data/tools/docs/assets/js/13196248.1be5ac81.js +1 -0
- data/tools/docs/assets/js/13c1b4e4.ad24c4f6.js +1 -0
- data/tools/docs/assets/js/15a39a64.4138456c.js +1 -0
- data/tools/docs/assets/js/2029.9e268a82.js +1 -0
- data/tools/docs/assets/js/2047b354.7995865f.js +1 -0
- data/tools/docs/assets/js/22b3ac48.73a6c979.js +1 -0
- data/tools/docs/assets/js/2846.a87f3fc4.js +1 -0
- data/tools/docs/assets/js/2923e883.0cbdcbc5.js +1 -0
- data/tools/docs/assets/js/3477.783e2e37.js +2 -0
- data/tools/docs/assets/js/3477.783e2e37.js.LICENSE.txt +61 -0
- data/tools/docs/assets/js/3dd7ef3b.8f77876c.js +1 -0
- data/tools/docs/assets/js/3df159b4.dded3e78.js +1 -0
- data/tools/docs/assets/js/40365d27.9322abd8.js +1 -0
- data/tools/docs/assets/js/411898ad.a1d949a2.js +1 -0
- data/tools/docs/assets/js/42170351.46c774f8.js +1 -0
- data/tools/docs/assets/js/43652efd.cbac4bc0.js +1 -0
- data/tools/docs/assets/js/5109.6a372217.js +1 -0
- data/tools/docs/assets/js/54d0d530.e9c8193b.js +1 -0
- data/tools/docs/assets/js/5bc719f6.fce76244.js +1 -0
- data/tools/docs/assets/js/5c6ce5ec.f909714f.js +1 -0
- data/tools/docs/assets/js/5e3ed378.cdfe0362.js +1 -0
- data/tools/docs/assets/js/5fe211ef.809c3f96.js +1 -0
- data/tools/docs/assets/js/6831b732.735c11e9.js +1 -0
- data/tools/docs/assets/js/696b4199.ff9185d0.js +1 -0
- data/tools/docs/assets/js/6b210247.248680ef.js +1 -0
- data/tools/docs/assets/js/6b65133b.2144fb1b.js +1 -0
- data/tools/docs/assets/js/6f92e431.608f28e7.js +1 -0
- data/tools/docs/assets/js/72c6d8a8.062b7650.js +1 -0
- data/tools/docs/assets/js/75e64983.d42f03f8.js +1 -0
- data/tools/docs/assets/js/7efc9fb0.6164fbad.js +1 -0
- data/tools/docs/assets/js/867640d5.28196e2c.js +1 -0
- data/tools/docs/assets/js/89e76475.5131b624.js +1 -0
- data/tools/docs/assets/js/8f7843ee.69e537b0.js +1 -0
- data/tools/docs/assets/js/9424f0b3.73086bed.js +1 -0
- data/tools/docs/assets/js/97535711.c7556831.js +1 -0
- data/tools/docs/assets/js/99581c43.30aef54d.js +1 -0
- data/tools/docs/assets/js/9d6e81d0.84fe3bb3.js +1 -0
- data/tools/docs/assets/js/9fb6059a.dc4760ab.js +1 -0
- data/tools/docs/assets/js/a182b3b3.25afec82.js +1 -0
- data/tools/docs/assets/js/a507c363.71a89240.js +1 -0
- data/tools/docs/assets/js/a677c089.2ec103f7.js +1 -0
- data/tools/docs/assets/js/a9987364.de63d165.js +1 -0
- data/tools/docs/assets/js/aa6b6c1b.6b24256f.js +1 -0
- data/tools/docs/assets/js/ada50b5c.1c75d3de.js +1 -0
- data/tools/docs/assets/js/b4596165.ab1c689f.js +1 -0
- data/tools/docs/assets/js/b6d70f94.ec27318b.js +1 -0
- data/tools/docs/assets/js/b9f60ba6.bb514133.js +1 -0
- data/tools/docs/assets/js/bd0034eb.0c60929d.js +1 -0
- data/tools/docs/assets/js/c24eae19.12176204.js +1 -0
- data/tools/docs/assets/js/cb8c3f08.762bb287.js +1 -0
- data/tools/docs/assets/js/cd879be4.3641a5cb.js +1 -0
- data/tools/docs/assets/js/d1b923aa.bf4b0c9e.js +1 -0
- data/tools/docs/assets/js/d24bf9b6.6ed3b576.js +1 -0
- data/tools/docs/assets/js/d370d7a7.28ef1aad.js +1 -0
- data/tools/docs/assets/js/d57a4b5d.017675ee.js +1 -0
- data/tools/docs/assets/js/d5d77c37.f472b18b.js +1 -0
- data/tools/docs/assets/js/d5f295fb.e008c3ec.js +1 -0
- data/tools/docs/assets/js/d797a795.9243eac2.js +1 -0
- data/tools/docs/assets/js/d7c988eb.2670948e.js +1 -0
- data/tools/docs/assets/js/d8ca4191.717db664.js +1 -0
- data/tools/docs/assets/js/d9b92eba.5eff70b2.js +1 -0
- data/tools/docs/assets/js/db8fa1d0.85784608.js +1 -0
- data/tools/docs/assets/js/dc5f7beb.120c148d.js +1 -0
- data/tools/docs/assets/js/e501b0d1.ae564e73.js +1 -0
- data/tools/docs/assets/js/f15615f1.3126a842.js +1 -0
- data/tools/docs/assets/js/fd886806.d2d0bdf4.js +1 -0
- data/tools/docs/assets/js/main.b5a535c2.js +2 -0
- data/tools/docs/assets/js/main.b5a535c2.js.LICENSE.txt +70 -0
- data/tools/docs/assets/js/runtime~main.e3a6c705.js +1 -0
- data/tools/docs/docs/configuration/command.html +40 -0
- data/tools/docs/docs/configuration/format.html +16 -0
- data/tools/docs/docs/configuration/interfaces.html +16 -0
- data/tools/docs/docs/configuration/plugins.html +17 -0
- data/tools/docs/docs/configuration/protocols.html +23 -0
- data/tools/docs/docs/configuration/ssl-tls.html +17 -0
- data/tools/docs/docs/configuration/table.html +30 -0
- data/tools/docs/docs/configuration/target.html +16 -0
- data/tools/docs/docs/configuration/telemetry-screens.html +36 -0
- data/tools/docs/docs/configuration/telemetry.html +16 -0
- data/tools/docs/docs/configuration.html +16 -0
- data/tools/docs/docs/development/curl.html +16 -0
- data/tools/docs/docs/development/developing.html +19 -0
- data/tools/docs/docs/development/host-install.html +16 -0
- data/tools/docs/docs/development/json-api.html +16 -0
- data/tools/docs/docs/development/log-structure.html +17 -0
- data/tools/docs/docs/development/roadmap.html +16 -0
- data/tools/docs/docs/development/streaming-api.html +18 -0
- data/tools/docs/docs/development/testing.html +16 -0
- data/tools/docs/docs/development.html +16 -0
- data/tools/docs/docs/getting-started/gettingstarted.html +16 -0
- data/tools/docs/docs/getting-started/installation.html +18 -0
- data/tools/docs/docs/getting-started/podman.html +18 -0
- data/tools/docs/docs/getting-started/requirements.html +16 -0
- data/tools/docs/docs/getting-started/upgrading.html +16 -0
- data/tools/docs/docs/getting-started.html +16 -0
- data/tools/docs/docs/guides/bridges.html +23 -0
- data/tools/docs/docs/guides/cfs.html +46 -0
- data/tools/docs/docs/guides/custom-widgets.html +16 -0
- data/tools/docs/docs/guides/little-endian-bitfields.html +16 -0
- data/tools/docs/docs/guides/local-mode.html +16 -0
- data/tools/docs/docs/guides/logging.html +16 -0
- data/tools/docs/docs/guides/monitoring.html +16 -0
- data/tools/docs/docs/guides/performance.html +16 -0
- data/tools/docs/docs/guides/raspberrypi.html +16 -0
- data/tools/docs/docs/guides/script-writing.html +18 -0
- data/tools/docs/docs/guides/scripting-api.html +17 -0
- data/tools/docs/docs/guides.html +16 -0
- data/tools/docs/docs/meta/contributing.html +20 -0
- data/tools/docs/docs/meta/philosophy.html +16 -0
- data/tools/docs/docs/meta/xtce.html +16 -0
- data/tools/docs/docs/meta.html +16 -0
- data/tools/docs/docs/privacy.html +23 -0
- data/tools/docs/docs/tools/autonomic.html +16 -0
- data/tools/docs/docs/tools/bucket-explorer.html +16 -0
- data/tools/docs/docs/tools/calendar.html +16 -0
- data/tools/docs/docs/tools/cmd-sender.html +16 -0
- data/tools/docs/docs/tools/cmd-tlm-server.html +17 -0
- data/tools/docs/docs/tools/data-extractor.html +16 -0
- data/tools/docs/docs/tools/data-viewer.html +16 -0
- data/tools/docs/docs/tools/handbooks.html +16 -0
- data/tools/docs/docs/tools/limits-monitor.html +16 -0
- data/tools/docs/docs/tools/packet-viewer.html +16 -0
- data/tools/docs/docs/tools/script-runner.html +16 -0
- data/tools/docs/docs/tools/table-manager.html +16 -0
- data/tools/docs/docs/tools/tlm-grapher.html +16 -0
- data/tools/docs/docs/tools/tlm-viewer.html +17 -0
- data/tools/docs/docs/tools.html +16 -0
- data/tools/docs/docs/v5/bridges/index.html +11 -0
- data/tools/docs/docs/v5/bucket-explorer/index.html +11 -0
- data/tools/docs/docs/v5/calendar/index.html +11 -0
- data/tools/docs/docs/v5/cfs/index.html +11 -0
- data/tools/docs/docs/v5/cmd-sender/index.html +11 -0
- data/tools/docs/docs/v5/cmd-tlm-server/index.html +11 -0
- data/tools/docs/docs/v5/command/index.html +11 -0
- data/tools/docs/docs/v5/contributing/index.html +11 -0
- data/tools/docs/docs/v5/custom-widgets/index.html +11 -0
- data/tools/docs/docs/v5/data-extractor/index.html +11 -0
- data/tools/docs/docs/v5/data-viewer/index.html +11 -0
- data/tools/docs/docs/v5/development/index.html +11 -0
- data/tools/docs/docs/v5/format/index.html +11 -0
- data/tools/docs/docs/v5/gettingstarted/index.html +11 -0
- data/tools/docs/docs/v5/handbooks/index.html +11 -0
- data/tools/docs/docs/v5/host-install/index.html +11 -0
- data/tools/docs/docs/v5/index.html +11 -0
- data/tools/docs/docs/v5/installation/index.html +11 -0
- data/tools/docs/docs/v5/interfaces/index.html +11 -0
- data/tools/docs/docs/v5/json-api/index.html +11 -0
- data/tools/docs/docs/v5/limits-monitor/index.html +11 -0
- data/tools/docs/docs/v5/little-endian-bitfields/index.html +11 -0
- data/tools/docs/docs/v5/local-mode/index.html +11 -0
- data/tools/docs/docs/v5/log-structure/index.html +11 -0
- data/tools/docs/docs/v5/logging/index.html +11 -0
- data/tools/docs/docs/v5/monitoring/index.html +11 -0
- data/tools/docs/docs/v5/packet-viewer/index.html +11 -0
- data/tools/docs/docs/v5/performance/index.html +11 -0
- data/tools/docs/docs/v5/philosophy/index.html +11 -0
- data/tools/docs/docs/v5/plugins/index.html +11 -0
- data/tools/docs/docs/v5/podman/index.html +11 -0
- data/tools/docs/docs/v5/protocols/index.html +11 -0
- data/tools/docs/docs/v5/raspberrypi/index.html +11 -0
- data/tools/docs/docs/v5/requirements/index.html +11 -0
- data/tools/docs/docs/v5/roadmap/index.html +11 -0
- data/tools/docs/docs/v5/script-runner/index.html +11 -0
- data/tools/docs/docs/v5/script-writing/index.html +11 -0
- data/tools/docs/docs/v5/scripting-api/index.html +11 -0
- data/tools/docs/docs/v5/ssl-tls/index.html +11 -0
- data/tools/docs/docs/v5/streaming-api/index.html +11 -0
- data/tools/docs/docs/v5/table/index.html +11 -0
- data/tools/docs/docs/v5/table-manager/index.html +11 -0
- data/tools/docs/docs/v5/target/index.html +11 -0
- data/tools/docs/docs/v5/telemetry/index.html +11 -0
- data/tools/docs/docs/v5/telemetry-screens/index.html +11 -0
- data/tools/docs/docs/v5/testing/index.html +11 -0
- data/tools/docs/docs/v5/tlm-grapher/index.html +11 -0
- data/tools/docs/docs/v5/tlm-viewer/index.html +11 -0
- data/tools/docs/docs/v5/tools/index.html +11 -0
- data/tools/docs/docs/v5/upgrading/index.html +11 -0
- data/tools/docs/docs/v5/xtce/index.html +11 -0
- data/tools/docs/docs.html +25 -0
- data/tools/docs/img/BCT.png +0 -0
- data/tools/docs/img/OpenC3.png +0 -0
- data/tools/docs/img/article-footer.png +0 -0
- data/tools/docs/img/ball.jpg +0 -0
- data/tools/docs/img/black_logo.svg +25 -0
- data/tools/docs/img/captech.gif +0 -0
- data/tools/docs/img/docusaurus-social-card.jpg +0 -0
- data/tools/docs/img/docusaurus.png +0 -0
- data/tools/docs/img/favicon.png +0 -0
- data/tools/docs/img/footer-logo.png +0 -0
- data/tools/docs/img/interface_read_logic.png +0 -0
- data/tools/docs/img/interface_write_logic.png +0 -0
- data/tools/docs/img/johnh.gif +0 -0
- data/tools/docs/img/lockheed.png +0 -0
- data/tools/docs/img/logo.svg +7 -0
- data/tools/docs/img/nasa.gif +0 -0
- data/tools/docs/img/sdlusu.gif +0 -0
- data/tools/docs/img/v5/architecture.png +0 -0
- data/tools/docs/img/v5/autonomic/autonomic.png +0 -0
- data/tools/docs/img/v5/autonomic/reactions.png +0 -0
- data/tools/docs/img/v5/autonomic/triggers.png +0 -0
- data/tools/docs/img/v5/bucket_explorer/bucket_explorer.png +0 -0
- data/tools/docs/img/v5/calendar/calendar.png +0 -0
- data/tools/docs/img/v5/calendar/list_view.png +0 -0
- data/tools/docs/img/v5/calendar/timeline_lifecycle.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/cmd_tlm_server.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/commands.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/file_menu.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/interfaces.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/log_messages.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/raw_command.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/raw_telemetry.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/routers.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/status.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/targets.png +0 -0
- data/tools/docs/img/v5/cmd_tlm_server/telemetry.png +0 -0
- data/tools/docs/img/v5/command_sender/command_sender.png +0 -0
- data/tools/docs/img/v5/command_sender/inst_clear.png +0 -0
- data/tools/docs/img/v5/command_sender/inst_collect.png +0 -0
- data/tools/docs/img/v5/command_sender/inst_collect_hazardous.png +0 -0
- data/tools/docs/img/v5/command_sender/inst_collect_hazardous_history.png +0 -0
- data/tools/docs/img/v5/command_sender/inst_collect_sent.png +0 -0
- data/tools/docs/img/v5/command_sender/inst_collect_sent_3.png +0 -0
- data/tools/docs/img/v5/command_sender/mode_menu.png +0 -0
- data/tools/docs/img/v5/contact/jason.png +0 -0
- data/tools/docs/img/v5/contact/ryan.jpeg +0 -0
- data/tools/docs/img/v5/data_extractor/data_extractor.png +0 -0
- data/tools/docs/img/v5/data_extractor/date_chooser.png +0 -0
- data/tools/docs/img/v5/data_extractor/delete_all_mouseover.png +0 -0
- data/tools/docs/img/v5/data_extractor/download.png +0 -0
- data/tools/docs/img/v5/data_extractor/edit_all_items.png +0 -0
- data/tools/docs/img/v5/data_extractor/edit_all_mouseover.png +0 -0
- data/tools/docs/img/v5/data_extractor/edit_temp1.png +0 -0
- data/tools/docs/img/v5/data_extractor/file_menu.png +0 -0
- data/tools/docs/img/v5/data_extractor/items_table.png +0 -0
- data/tools/docs/img/v5/data_extractor/items_table_raw.png +0 -0
- data/tools/docs/img/v5/data_extractor/items_table_temp1.png +0 -0
- data/tools/docs/img/v5/data_extractor/mode_menu.png +0 -0
- data/tools/docs/img/v5/data_extractor/open_config.png +0 -0
- data/tools/docs/img/v5/data_extractor/processing.png +0 -0
- data/tools/docs/img/v5/data_extractor/save_config.png +0 -0
- data/tools/docs/img/v5/data_extractor/select_item.png +0 -0
- data/tools/docs/img/v5/data_extractor/select_packet.png +0 -0
- data/tools/docs/img/v5/data_extractor/select_target.png +0 -0
- data/tools/docs/img/v5/data_extractor/time_chooser.png +0 -0
- data/tools/docs/img/v5/data_viewer/add_packet.png +0 -0
- data/tools/docs/img/v5/data_viewer/data_viewer.png +0 -0
- data/tools/docs/img/v5/data_viewer/file_menu.png +0 -0
- data/tools/docs/img/v5/data_viewer/open_config.png +0 -0
- data/tools/docs/img/v5/data_viewer/rename_tab.png +0 -0
- data/tools/docs/img/v5/data_viewer/save_config.png +0 -0
- data/tools/docs/img/v5/data_viewer/tab_right_click.png +0 -0
- data/tools/docs/img/v5/data_viewer/view_portal.png +0 -0
- data/tools/docs/img/v5/data_viewer/view_portal_add.png +0 -0
- data/tools/docs/img/v5/guides/local_mode/delete_modified.png +0 -0
- data/tools/docs/img/v5/guides/local_mode/minio.png +0 -0
- data/tools/docs/img/v5/guides/local_mode/project.png +0 -0
- data/tools/docs/img/v5/guides/local_mode/project_update.png +0 -0
- data/tools/docs/img/v5/guides/local_mode/reload_file.png +0 -0
- data/tools/docs/img/v5/guides/local_mode/reloaded.png +0 -0
- data/tools/docs/img/v5/guides/logging/browser.png +0 -0
- data/tools/docs/img/v5/guides/logging/log_messages.png +0 -0
- data/tools/docs/img/v5/guides/logging/notifications.png +0 -0
- data/tools/docs/img/v5/guides/logging/raw_tlm_logs.png +0 -0
- data/tools/docs/img/v5/guides/plugin-variables.png +0 -0
- data/tools/docs/img/v5/guides/simple_screen.png +0 -0
- data/tools/docs/img/v5/handbooks/handbooks.png +0 -0
- data/tools/docs/img/v5/limits_monitor/ignored.png +0 -0
- data/tools/docs/img/v5/limits_monitor/limits_monitor.png +0 -0
- data/tools/docs/img/v5/limits_monitor/log.png +0 -0
- data/tools/docs/img/v5/limits_monitor/mouseover.png +0 -0
- data/tools/docs/img/v5/navigation.png +0 -0
- data/tools/docs/img/v5/packet_viewer/file_menu.png +0 -0
- data/tools/docs/img/v5/packet_viewer/packet_viewer.png +0 -0
- data/tools/docs/img/v5/packet_viewer/select_packet.png +0 -0
- data/tools/docs/img/v5/packet_viewer/temp1_details.png +0 -0
- data/tools/docs/img/v5/packet_viewer/view_menu.png +0 -0
- data/tools/docs/img/v5/script_runner/checks_rb.png +0 -0
- data/tools/docs/img/v5/script_runner/connecting.png +0 -0
- data/tools/docs/img/v5/script_runner/debug.png +0 -0
- data/tools/docs/img/v5/script_runner/file_menu.png +0 -0
- data/tools/docs/img/v5/script_runner/file_open.png +0 -0
- data/tools/docs/img/v5/script_runner/file_save_as.png +0 -0
- data/tools/docs/img/v5/script_runner/running_scripts.png +0 -0
- data/tools/docs/img/v5/script_runner/script_error.png +0 -0
- data/tools/docs/img/v5/script_runner/script_menu.png +0 -0
- data/tools/docs/img/v5/script_runner/script_runner.png +0 -0
- data/tools/docs/img/v5/script_runner/script_suite.png +0 -0
- data/tools/docs/img/v5/table_manager/file_menu.png +0 -0
- data/tools/docs/img/v5/table_manager/table_manager.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/edit_graph.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/file_menu.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/four_graphs.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/graph_menu.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/graph_min_max.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/graph_temp1.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/graph_temp1_temp2.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/graph_temp1_time.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/grapher_controls.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/minimized.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/open_config.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/save_config.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/stop_start.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/telemetry_grapher.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/two_full_height.png +0 -0
- data/tools/docs/img/v5/telemetry_grapher/two_full_width.png +0 -0
- data/tools/docs/img/v5/telemetry_viewer/edit_screen.png +0 -0
- data/tools/docs/img/v5/telemetry_viewer/file_menu.png +0 -0
- data/tools/docs/img/v5/telemetry_viewer/minimized.png +0 -0
- data/tools/docs/img/v5/telemetry_viewer/new_screen.png +0 -0
- data/tools/docs/img/v5/telemetry_viewer/open_config.png +0 -0
- data/tools/docs/img/v5/telemetry_viewer/save_config.png +0 -0
- data/tools/docs/img/v5/telemetry_viewer/telemetry_viewer.png +0 -0
- data/tools/docs/index.html +16 -0
- data/tools/docs/lunr-index-1699630949575.json +1 -0
- data/tools/docs/lunr-index.json +1 -0
- data/tools/docs/markdown-page.html +16 -0
- data/tools/docs/search-doc-1699630949575.json +1 -0
- data/tools/docs/search-doc.json +1 -0
- data/tools/docs/sitemap.xml +1 -0
- metadata +477 -0
@@ -0,0 +1,16 @@
|
|
1
|
+
<!doctype html>
|
2
|
+
<html lang="en" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-getting-started/requirements" data-has-hydrated="false">
|
3
|
+
<head>
|
4
|
+
<meta charset="UTF-8">
|
5
|
+
<meta name="generator" content="Docusaurus v2.4.3">
|
6
|
+
<title data-rh="true">Requirements and Design | OpenC3 Docs</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openc3.com/tools/docs/docs/getting-started/requirements"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Requirements and Design | OpenC3 Docs"><meta data-rh="true" name="description" content="OpenC3 COSMOS is a command and control system providing commanding, scripting, and data visualization capabilities for embedded systems and systems of systems. COSMOS is intended for use during all phases of testing (board, box, integrated system) and during operations."><meta data-rh="true" property="og:description" content="OpenC3 COSMOS is a command and control system providing commanding, scripting, and data visualization capabilities for embedded systems and systems of systems. COSMOS is intended for use during all phases of testing (board, box, integrated system) and during operations."><link data-rh="true" rel="icon" href="/tools/docs/img/favicon.png"><link data-rh="true" rel="canonical" href="https://docs.openc3.com/tools/docs/docs/getting-started/requirements"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/getting-started/requirements" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/getting-started/requirements" hreflang="x-default"><link rel="stylesheet" href="/tools/docs/assets/css/styles.7bc79028.css">
|
7
|
+
<link rel="preload" href="/tools/docs/assets/js/runtime~main.e3a6c705.js" as="script">
|
8
|
+
<link rel="preload" href="/tools/docs/assets/js/main.b5a535c2.js" as="script">
|
9
|
+
</head>
|
10
|
+
<body class="navigation-with-keyboard">
|
11
|
+
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"dark")}()</script><div id="__docusaurus">
|
12
|
+
<div role="region" aria-label="Skip to main content"><a class="skipToContent_G6ar" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/tools/docs/"><div class="navbar__logo"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--light_riBm"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--dark_Dsi0"></div><b class="navbar__title text--truncate">OpenC3 Docs</b></a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/tools/docs/docs">Documentation</a><a href="https://openc3.com/enterprise/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Enterprise</a></div><div class="navbar__items navbar__items--right"><div class="searchBox_xrOJ"><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Loading..." aria-label="Search" class="navbar__search-input search-bar" disabled=""></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_UyTV docsWrapper_BqXd"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_z1FD" type="button"></button><div class="docPage_pOTq"><aside class="theme-doc-sidebar-container docSidebarContainer_aIKW"><div class="sidebarViewport_DwR9"><div class="sidebar_vJCc"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_qiME"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs">Introduction</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" href="/tools/docs/docs/getting-started">Getting Started</a><button aria-label="Toggle the collapsible sidebar category 'Getting Started'" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/installation">Installation</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/gettingstarted">Getting Started</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/upgrading">Upgrading</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/tools/docs/docs/getting-started/requirements">Requirements and Design</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/podman">Podman</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/configuration">Configuration</a><button aria-label="Toggle the collapsible sidebar category 'Configuration'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/tools">Tools</a><button aria-label="Toggle the collapsible sidebar category 'Tools'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/guides">Guides</a><button aria-label="Toggle the collapsible sidebar category 'Guides'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/development">Development</a><button aria-label="Toggle the collapsible sidebar category 'Development'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/meta">Meta</a><button aria-label="Toggle the collapsible sidebar category 'Meta'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs/privacy">OpenC3, Inc. Privacy Policy</a></li></ul></nav></div></div></aside><main class="docMainContainer_fv3b"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_YAwJ"><div class="docItemContainer_Rv5Z"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_zCmv" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/tools/docs/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_JFrk"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/tools/docs/docs/getting-started"><span itemprop="name">Getting Started</span></a><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">Requirements and Design</span><meta itemprop="position" content="2"></li></ul></nav><div class="tocCollapsible_O_Qc theme-doc-toc-mobile tocMobile_tjDr"><button type="button" class="clean-btn tocCollapsibleButton_htYj">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Requirements and Design</h1></header><p>OpenC3 COSMOS is a command and control system providing commanding, scripting, and data visualization capabilities for embedded systems and systems of systems. COSMOS is intended for use during all phases of testing (board, box, integrated system) and during operations.</p><p>COSMOS is currently made up of the following applications:</p><ol><li><strong>Command and Telemetry Server</strong> - Provides status of realtime commanding, telemetry reception, logging, limits monitoring, and packet routing.</li><li><strong>Limits Monitor</strong> - Monitors telemetry with defined limits and shows items that currently are or have violated limits.</li><li><strong>Command Sender</strong> - Provides a graphical interface for manually sending individual commands.</li><li><strong>Script Runner</strong> - Executes scripts and provides highlighting of the currently executing line. Now also includes TestRunner functionality.</li><li><strong>Packet Viewer</strong> - Provides realtime visualization of every telemetry packet that has been defined.</li><li><strong>Telemetry Viewer</strong> - Provides custom telemetry screen functionality with advanced layout and visualization widgets.</li><li><strong>Telemetry Grapher</strong> - Provides realtime and offline graphing of telemetry data.</li><li><strong>Data Extractor</strong> - Extracts telemetry and command packet log files into CSV data.</li><li><strong>Data Viewer</strong> - Provides text based telemetry visualization for items.</li><li><strong>Bucket Explorer</strong> - Browse the COSMOS bucket storage in any cloud environment.</li><li><strong>Table Manager</strong> - Binary file editor with Script Runner integration for upload / download.</li><li><strong>Handbooks</strong> - Generate html page of the command and telemetry definitions.</li><li><strong>Calendar</strong> - Provides scheduling of commands and scripts. Also provides a framework for reserving resources.</li><li><strong>Admin</strong> - Provides an administrative interface to COSMOS.</li></ol><p>More detailed descriptions, requirements, and design for each tool are found later in this document. Additionally, each of the above applications is built using COSMOS libraries that are available for use as a framework to develop custom program/project applications.</p><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="terminology">Terminology<a href="#terminology" class="hash-link" aria-label="Direct link to Terminology" title="Direct link to Terminology"></a></h2><p>The COSMOS system uses several terms that are important to understand. The following table defines these terms.</p><table><thead><tr><th>Term</th><th>Definition</th></tr></thead><tbody><tr><td>Target</td><td>A COSMOS target is an embedded system that the COSMOS Command and Telemetry Server connects to using an interface in order to send commands to and/or receive telemetry from.</td></tr><tr><td>Command</td><td>A packet of information telling a target to perform an action of some sort.</td></tr><tr><td>Telemetry Packet</td><td>A packet of information providing status from a target.</td></tr><tr><td>Interface</td><td>A Ruby class that knows how to send commands to and/or receive telemetry from a target. COSMOS comes with interfaces that support TCP/IP, UDP, and serial connections. Custom interfaces are easy to add to the system.</td></tr><tr><td>Ruby</td><td>The powerful dynamic programming language used to write the COSMOS applications and libraries as well as COSMOS scripts and test procedures.</td></tr><tr><td>Configuration Files</td><td>COSMOS uses simple plain text configuration files to define commands and telemetry packets, and to configure each COSMOS application. These files are easily human readable/editable and machine readable/editable.</td></tr><tr><td>Packet Log Files</td><td>Binary files containing either logged commands or telemetry packets.</td></tr><tr><td>Message Log Files</td><td>Text files containing messages generated by the system.</td></tr><tr><td>Tool</td><td>Another name for a COSMOS application.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="overall-architecture-and-context-diagram">Overall Architecture and Context Diagram<a href="#overall-architecture-and-context-diagram" class="hash-link" aria-label="Direct link to Overall Architecture and Context Diagram" title="Direct link to Overall Architecture and Context Diagram"></a></h2><p>The following diagram shows the COSMOS 5 architecture.</p><p>COSMOS Architecture /img/v5/architecture.png</p><p>Key aspects of this architecture:</p><p>COSMOS 5 is a cloud native, containerized, microservice oriented command and control system. All the COSMOS microservices are docker containers which is why Docker is shown containing the entire COSMOS system. The green boxes on the left represent external embedded systems (Targets) which COSMOS connects to. The Redis data store contains the configuration for all the microservices, the current value table, as well as data streams containing decommutated data. The Minio data store contains plugins, targets, configuration data, text logs as well as binary logs of all the raw, decommutated, and reduced data. Users interact with COSMOS from a web browser which routes through the internal Traefik load balancer.</p><ul><li>COSMOS can connect to many different kinds of targets. The examples include things like Flight software (FSW), Ground Support Equipment (GSE), Labview, and COTS targets such as an Agilent power supply. Any embedded system that provides a communication interface can be connected to COSMOS.</li><li>COSMOS ships with interfaces for connecting over TCP/IP, UDP, MQTT, and serial connections. This covers most systems, but custom interfaces can also be written to connect to anything.</li><li>All realtime communication with targets flows through the COSMOS system. This ensures all commands and telemetry are logged.</li><li>Every tool is configured with plain text configuration files.</li><li>Program specific tools can be written using the COSMOS libraries that can interact with the realtime command and telemetry streams and can process logged data.</li></ul><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="overall-requirements">Overall Requirements<a href="#overall-requirements" class="hash-link" aria-label="Direct link to Overall Requirements" title="Direct link to Overall Requirements"></a></h2><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>COSMOS-1</td><td>All COSMOS core functionality shall be containerized.</td><td>Verify COSMOS is running in Docker</td></tr><tr><td>COSMOS-2</td><td>The COSMOS user interface shall be accessible from Chromium based web browsers</td><td>Open COSMOS in Chrome/Edge</td></tr><tr><td>COSMOS-3</td><td>The COSMOS user interface shall be accessible from the Firefox web browser</td><td>Open COSMOS in Firefox</td></tr><tr><td>COSMOS-4</td><td>COSMOS shall log all commands sent</td><td></td></tr><tr><td>COSMOS-5</td><td>COSMOS shall log all telemetry received</td><td></td></tr><tr><td>COSMOS-6</td><td>COSMOS shall decommutate all telemetry packets recieved</td><td></td></tr><tr><td>COSMOS-7</td><td>COSMOS shall support autonomously attempting to connect to targets.</td><td>Verify targets are connected upon starting the CTS.</td></tr><tr><td>COSMOS-8</td><td>COSMOS shall time stamp telemetry packets upon receipt.</td><td>Verify logged packets are timestamped.</td></tr><tr><td>COSMOS-9</td><td>COSMOS shall time stamp telemetry packets to a resolution of 1 millisecond or better. Note: This requirement only refers to resolution. COSMOS does not run on real-time operating systems and accuracy cannot be guaranteed.</td><td>View time stamps in log.</td></tr><tr><td>COSMOS-10</td><td>COSMOS shall time stamp received telemetry with a UTC timestamp.</td><td>Verify logged time stamps are as expected.</td></tr><tr><td>COSMOS-11</td><td>COSMOS shall maintain a timestamped log of commands received, limits violations, and errors encountered.</td><td>View COSMOS message log.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="api-requirements">Api Requirements<a href="#api-requirements" class="hash-link" aria-label="Direct link to Api Requirements" title="Direct link to Api Requirements"></a></h2><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>API-1</td><td>The COSMOS API shall allow scripted connection and disconnection of interfaces.</td><td>Disconnect and connect an interface from a script.</td></tr><tr><td>API-2</td><td>The COSMOS API shall allow scripted connection and disconnection of routers.</td><td>Disconnect and connect a router from a script.</td></tr><tr><td>API-3</td><td>The COSMOS API shall allow scripted setting of the current limits set.</td><td>Select a different limits set from a script.</td></tr><tr><td>API-4</td><td>The COSMOS API shall allow commanding of targets</td><td>Send a command</td></tr><tr><td>API-5</td><td>The COSMOS API shall allow reading the current value of any telemetry item</td><td>Read a telemetry point</td></tr><tr><td>API-6</td><td>The COSMOS API shall allow streaming realtime and logged telemetry packets</td><td>Stream telemetry packets</td></tr><tr><td>API-7</td><td>The COSMOS API shall allow streaming realtime and logged command packets</td><td>Stream command packets</td></tr><tr><td>API-8</td><td>The COSMOS API shall allow starting COSMOS scripts</td><td>Start a script using the API</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="command-and-telemetry-server">Command and Telemetry Server<a href="#command-and-telemetry-server" class="hash-link" aria-label="Direct link to Command and Telemetry Server" title="Direct link to Command and Telemetry Server"></a></h2><p>The Command and Telemetry server provides status on the the overall COSMOS installation for a specific scope.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>CTS-1</td><td>The Command and Telemetry Server shall display a list of all interfaces.</td><td>View the Interfaces tab.</td></tr><tr><td>CTS-2</td><td>The Command and Telemetry Server shall allow manual connection and disconnection of interfaces.</td><td>Press a GUI button to disconnect and connect an interface.</td></tr><tr><td>CTS-3</td><td>The Command and Telemetry Server shall display a list of all targets.</td><td>View the Targets tab.</td></tr><tr><td>CTS-4</td><td>The Command and Telemetry Server shall display a list of known commands.</td><td>View the Cmd Packets tab.</td></tr><tr><td>CTS-5</td><td>The Command and Telemetry Server shall display raw command data for the most recent command received.</td><td>View the Cmd Packets tab and click the View Raw button for a command.</td></tr><tr><td>CTS-6</td><td>The Command and Telemetry Server shall display a list of known telemetry packets.</td><td>View the Tlm Packets tab.</td></tr><tr><td>CTS-7</td><td>The Command and Telemetry Server shall display raw telemetry packet data for the most recent telemetry packet received.</td><td>View the Tlm Packets tab and click the View Raw button for a telemetry packet.</td></tr><tr><td>CTS-8</td><td>The Command and Telemetry Server shall display a list of all routers.</td><td>View the Routers tab.</td></tr><tr><td>CTS-9</td><td>The Command and Telemetry Server shall allow manual connection and disconnection of routers.</td><td>Press a GUI button to disconnect and connect a router.</td></tr><tr><td>CTS-10</td><td>The Command and Telemetry Server shall allow manually setting the current limits set.</td><td>Select a different limits set from the combobox.</td></tr><tr><td>CTS-11</td><td>The Command and Telemetry Server shall support opening telemetry packets in Packet Viewer.</td><td>On the Tlm Packets tab click View in Packet Viewer for a telemetry packet.</td></tr><tr><td>CTS-12</td><td>The Command and Telemetry Server shall display time stamps in local time.</td><td>View time stamps in log.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="limits-monitor">Limits Monitor<a href="#limits-monitor" class="hash-link" aria-label="Direct link to Limits Monitor" title="Direct link to Limits Monitor"></a></h2><p>Limits Monitor displays all telemetry points that are currently out of limits and also shows any telemetry points that have gone out of limits since Limits Monitor was started.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>LM-1</td><td>Limits Monitor shall display all telemetry points currently out of limits.</td><td>View displayed telemetry points.</td></tr><tr><td>LM-2</td><td>Limits Monitor shall support ignoring telemetry points.</td><td>Click ignore on a telemetry point.</td></tr><tr><td>LM-3</td><td>Limits Monitor shall keep a displayed log of limits violations.</td><td>View the log tab.</td></tr><tr><td>LM-4</td><td>Limits Monitor shall continue displaying a telemetry point that temporarily went out of limits.</td><td>Watch until a telemetry points returns to green.</td></tr><tr><td>LM-5</td><td>Limits Monitor shall support saving its configuration.</td><td>Save the configuration.</td></tr><tr><td>LM-6</td><td>Limits Monitor shall support loading its configuration.</td><td>Load the configuration.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="command-sender">Command Sender<a href="#command-sender" class="hash-link" aria-label="Direct link to Command Sender" title="Direct link to Command Sender"></a></h2><p>Command Sender provides an easy method to send single commands to targets. The graphical user interface provides simple dropdowns to quickly select the desired command to send organized by target name and command name. After the user has selected the command, they then fill in the desired command parameters and click send to send the command to the target.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>CMD-1</td><td>Command Sender shall allow selection of a command by target name and packet name.</td><td>Select a specific command by target name and packet name in the drop down menus.</td></tr><tr><td>CMD-2</td><td>Command Sender shall allow sending the selected command.</td><td>Send the selected command by pressing the Send button.</td></tr><tr><td>CMD-3</td><td>Command Sender shall display non-ignored parameters for the selected command.</td><td>Select a specific command and verify the expected parameters are shown.</td></tr><tr><td>CMD-4</td><td>Command Sender shall provide a mechanism to select state values for command parameters with states.</td><td>Select a specific state value for a specific command with states.</td></tr><tr><td>CMD-5</td><td>Command Sender shall allow sending a manually entered value for a command parameter with states.</td><td>Manually enter a value for a specific command with states.</td></tr><tr><td>CMD-6</td><td>Command Sender shall refuse to send commands if required parameters are not provided.</td><td>Attempt to send a command with a required parameter not filled out.</td></tr><tr><td>CMD-7</td><td>Command Sender shall support sending commands while ignoring range checking.</td><td>Enter Ignore Range Checking mode and then send a command with an out of range parameter.</td></tr><tr><td>CMD-8</td><td>Command Sender shall optionally display state values in hex.</td><td>Enter "Display State Values in Hex" mode and verify state values are displayed as hex.</td></tr><tr><td>CMD-9</td><td>Command Sender shall optionally display ignored command parameters.</td><td>Enter "Show Ignored Parameters" mode and verify ignored parameters are displayed.</td></tr><tr><td>CMD-10</td><td>Command Sender shall respect hazardous commands and notify the user before proceeding.</td><td>Send a hazardous command and verify a dialog box appears before the command is sent. Verify both accepting the dialog and declining to send.</td></tr><tr><td>CMD-11</td><td>Command Sender shall keep a command history of each command sent.</td><td>Send a command and verify that it shows up in the command history box.</td></tr><tr><td>CMD-12</td><td>Command Sender shall allow resending of any command in the command history.</td><td>Resend one of the commands in the command history box.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="script-runner">Script Runner<a href="#script-runner" class="hash-link" aria-label="Direct link to Script Runner" title="Direct link to Script Runner"></a></h2><p>Script Runner provides a visual interface for editing and executing scripts/procedures. A full featured text editor provides syntax highlighting and code completion while developing scripts. During script execution, the currently executing line is highlighted and any logged messages are highlighted to the user. If any failure occurs, the script is paused and the user alerted. The user can then decide whether to stop the script, or ignore the failure and continue. The user can also retry the failed lines, or other nearby lines before proceeding.</p><p>Script Runner now also provides a structured methodology for designing system level scripting that mirrors the very successful pattern used in software unit tests (previously implemented in the Test Runner tool). System level tests/procedures are built up of cases that are organized into groups. For example, you might have one group that verified all of the requirements associated with a particular mechanism. Ideally you would break this down into individual cases for different scenarios. One perhaps for opening a shutter, another for closing it, etc. Cases are ideally small and independent tasks. A number of these groups are then combined into an overall suite which would be run to execute a major test such as EMI, or software FQT.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>SR-1</td><td>Script Runner shall provide a text editor for developing test scripts.</td><td>Open Script Runner and create a simple test script. Perform all standard file operations including New, Open, Reload, Close, Save, and Save As. Perform all standard editing operations such as Cut, Copy, Paste, Undo, Redo, Select All, and Comment/Uncomment lines.</td></tr><tr><td>SR-2</td><td>Script Runner shall provide search and replace functionality.</td><td>Perform all standard search and replace functionality, including search, replace, find next, and find previous.</td></tr><tr><td>SR-3</td><td>Script Runner shall provide code completion for cmd(), tlm(), and wait_check() COSMOS API methods. Note: Other methods may also be supported.</td><td>Create a script and exercise code completion on the mentioned keywords.</td></tr><tr><td>SR-4</td><td>Script Runner shall execute Ruby-based COSMOS scripts.</td><td>Press start and execute a script.</td></tr><tr><td>SR-5</td><td>Script Runner shall highlight the currently executing line of the script.</td><td>Verify that lines are highlighted as a test script executes.</td></tr><tr><td>SR-6</td><td>Script Runner shall allow pausing an executing script.</td><td>Press pause button and verify script is paused. Press start to resume.</td></tr><tr><td>SR-7</td><td>Script Runner shall allow stopping an executing script.</td><td>Press stop and verify script stops.</td></tr><tr><td>SR-8</td><td>Script Runner shall pause an executing script upon the occurance of an error.</td><td>Create a script with a statement that is guaranteed to fail and verify that the script is paused.</td></tr><tr><td>SR-9</td><td>Script Runner shall log commands sent.</td><td>Execute a script that sends a command and verify it is logged.</td></tr><tr><td>SR-10</td><td>Script Runner shall log text written to STDOUT. Note: Typically through the puts method.</td><td>Execute a script that uses puts to write a message and verify it is logged.</td></tr><tr><td>SR-11</td><td>Script Runner shall log wait times.</td><td>Execute a script that includes a wait method and verify wait time is logged.</td></tr><tr><td>SR-12</td><td>Script Runner shall log errors that occur while the script is executing.</td><td>Create a script with a check statement that is guaranteed to fail and verify it is logged.</td></tr><tr><td>SR-13</td><td>Script Runner shall log check statement success and failure.</td><td>Create a script with a check statement that is guaranteed to fail and one that is guaranteed to succeeed. Verify both the success and failure are logged.</td></tr><tr><td>SR-14</td><td>Script Runner shall support executing selected lines.</td><td>Select a set of lines and execute them using Script->Execute Selected Lines.</td></tr><tr><td>SR-15</td><td>Script Runner shall support executing selected lines while paused.</td><td>Select a set of lines and execute them from the right-click context menu.</td></tr><tr><td>SR-16</td><td>Script Runner shall support starting a script from any line.</td><td>Place the mouse cursor at the desired first line and then select Script->Execute From Cursor.</td></tr><tr><td>SR-17</td><td>Script Runner shall support a mnemonic checking function.</td><td>Select Script->Mnemonic Check.</td></tr><tr><td>SR-18</td><td>Script Runner shall support a syntax checking function.</td><td>Select Script->Ruby Syntax Check.</td></tr><tr><td>SR-19</td><td>Script Runner shall support viewing the script instrumentation.</td><td>Select Script->View Instrumented Script.</td></tr><tr><td>SR-20</td><td>Script Runner shall support an disconnected mode to allow for executing scripts without a connection to the Command and Telemetry Server.</td><td>Select Script->Toggle Disconnect. Execute a script with commands and check statements and verify that it runs to completion.</td></tr><tr><td>SR-21</td><td>Script Runner shall support a Debug terminal to aid in debugging scripts.</td><td>Select Script->Toggle Debug.</td></tr><tr><td>SR-22</td><td>Script Runner shall support a step mode where the script will stop and wait for use interaction after each line.</td><td>Press Step to progress through the script.</td></tr><tr><td>SR-23</td><td>Script Runner shall support breakpoint functionality.</td><td>Create a breakpoint then execute the script and verify it stops at the specified line.</td></tr><tr><td>SR-25</td><td>Script Runner Suite Mode shall support executing individual test suites.</td><td>Execute an individual test suite.</td></tr><tr><td>SR-26</td><td>Script Runner Suite Mode shall support executing individual test groups.</td><td>Execute an individual test group.</td></tr><tr><td>SR-27</td><td>Script Runner Suite Mode shall support executing individual test cases.</td><td>Execute an individual test case.</td></tr><tr><td>SR-28</td><td>Script Runner Suite Mode shall support executing test group setup and teardown methods individually.</td><td>Execute a test group setup. Execute a test group teardown.</td></tr><tr><td>SR-29</td><td>Script Runner Suite Mode shall support executing test suite setup and teardown methods individually.</td><td>Execute a test suite setup. Execute a test suite teardown.</td></tr><tr><td>SR-30</td><td>Script Runner Suite Mode shall create a report after executing any suite test.</td><td>Verify a report is generated after executing a suite.</td></tr><tr><td>SR-31</td><td>Script Runner Suite Mode shall support pausing when an error occurs.</td><td>Execute a test script with the pause on error box checked and without.</td></tr><tr><td>SR-32</td><td>Script Runner Suite Mode shall support allowing the user to proceed on an error.</td><td>Execute a test script with the Allow go/retry on error box checked and without.</td></tr><tr><td>SR-33</td><td>Script Runner Suite Mode shall support aborting execution on an error.</td><td>Execute a test script with the abort on error box checked and without.</td></tr><tr><td>SR-34</td><td>Script Runner Suite Mode shall support looping a test.</td><td>Execute a test script with the loop testing box checked and without.</td></tr><tr><td>SR-35</td><td>Script Runner Suite Mode shall support breaking the looping of a test on error.</td><td>Execute a test script with the break loop on error box checked and without.</td></tr><tr><td>SR-36</td><td>Script Runner Suite Mode shall support a user readable flag indicating that loop testing is occurring.</td><td>Execute a test script that checks the $loop_testing variable while looping and again while not looping.</td></tr><tr><td>SR-37</td><td>Script Runner Suite Mode shall support a user readable flag indicating manual operations are desired.</td><td>Execute a test script with the manual box checked and without.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="packet-viewer">Packet Viewer<a href="#packet-viewer" class="hash-link" aria-label="Direct link to Packet Viewer" title="Direct link to Packet Viewer"></a></h2><p>Packet Viewer provides a simple tool to view the realtime contents of any telemetry packet defined in the system in a tabular, key-value format.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>PV-1</td><td>Packet Viewer shall allow selection of a telemetry packet by target name and packet name.</td><td>Select a specific telemetry packet by target name and packet name in the drop down menus.</td></tr><tr><td>PV-2</td><td>Packet Viewer shall display the contents of the selected telemetry packet.</td><td>Ensure all items of the selected telemetry packet are displayed and updating.</td></tr><tr><td>PV-3</td><td>Packet Viewer shall provide a mechanism to get detailed information on a telemetry item.</td><td>Right click on a telemetry item and select "Details" from the context menu.</td></tr><tr><td>PV-4</td><td>Packet Viewer shall provide a mechanism to view a graph of any telemetry item.</td><td>Right click on a telemetry item and select "Graph" from the context menu.</td></tr><tr><td>PV-5</td><td>Packet Viewer shall color telemetry values based upon limits state.</td><td>View a packet with items containing limits and verify they are colored.</td></tr><tr><td>PV-6</td><td>Packet Viewer shall support a configurable polling rate.</td><td>Select File->Options and change the polling rate.</td></tr><tr><td>PV-7</td><td>Packet Viewer shall support a color-blind mode to allow distinguishing limits states for those who are color blind.</td><td>Select View->Color Blind Mode and verify that items with limits are also displayed with a textual indication of limits state color.</td></tr><tr><td>PV-8</td><td>Packet Viewer shall support displaying telemetry in each of the four COSMOS value types (raw, converted, formatted, and formatted with units)</td><td>In the View menu, select each of the four value types and verify values are displayed accordingly.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="telemetry-viewer">Telemetry Viewer<a href="#telemetry-viewer" class="hash-link" aria-label="Direct link to Telemetry Viewer" title="Direct link to Telemetry Viewer"></a></h2><p>Telemetry Viewer provides a way to organize telemetry points into custom "screens" that allow for the creation of unique and organized views of telemetry data. Screens are made up of widgets or small GUI components that display telemetry in unique ways.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>TV-1</td><td>Telemetry Viewer shall display user-defined telemetry screens.</td><td>Open a telemetry</td></tr><tr><td>TV-2</td><td>Telemetry Viewer shall display realtime data.</td><td>Verify telemetry screens show realtime data.</td></tr><tr><td>TV-3</td><td>Telemetry Viewer shall support saving open telemetry screens and their positions.</td><td>Open three telemetry screens and then select File->Save Configuration.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="telemetry-grapher">Telemetry Grapher<a href="#telemetry-grapher" class="hash-link" aria-label="Direct link to Telemetry Grapher" title="Direct link to Telemetry Grapher"></a></h2><p>Telemetry Grapher performs graphing of telemetry points in both realtime and log file playback.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>TG-1</td><td>Telemetry Grapher shall provide line graphs of telemetry points.</td><td>Add several housekeeping data objects to a plot.</td></tr><tr><td>TG-2</td><td>Telemetry Grapher shall support realtime graphing of telemetry.</td><td>Press Start to start realtime graphing.</td></tr><tr><td>TG-3</td><td>Telemetry Grapher shall support graphing data from logged telemetry.</td><td>Select the menu option to graph data from a logged data</td></tr><tr><td>TG-4</td><td>Telemetry Grapher shall support multiple plots per browser tab.</td><td>Add multiple plots.</td></tr><tr><td>TG-5</td><td>Telemetry Grapher shall support multiple telemetry points per plot.</td><td>Add multiple data objects to one plot.</td></tr><tr><td>TG-6</td><td>Telemetry Grapher shall support saving a variable number of data points.</td><td>Edit Points Saved.</td></tr><tr><td>TG-7</td><td>Telemetry Grapher shall support graphing a variable duration of time.</td><td>Edit Seconds Plotted.</td></tr><tr><td>TG-8</td><td>Telemetry Grapher shall support graphing a variable number of data points.</td><td>Edit Points Plotted.</td></tr><tr><td>TG-9</td><td>Telemetry Grapher shall support saving its configuration.</td><td>Save the current configuration.</td></tr><tr><td>TG-10</td><td>Telemetry Grapher shall support loading its configuration.</td><td>Load the previously saved configuration.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="data-extractor">Data Extractor<a href="#data-extractor" class="hash-link" aria-label="Direct link to Data Extractor" title="Direct link to Data Extractor"></a></h2><p>Data Extractor processes logged data and extracts data into a CSV format for analysis in Excel or other tools.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>DE-1</td><td>Data Extractor shall support adding individual telemetry points.</td><td>Add an individual telemetry point.</td></tr><tr><td>DE-2</td><td>Data Extractor shall support adding entire telemetry packets.</td><td>Add an entire packet.</td></tr><tr><td>DE-3</td><td>Data Extractor shall support adding entire telemetry targets.</td><td>Add all packets for a target.</td></tr><tr><td>DE-4</td><td>Data Extractor shall support selecting the value type to extract for each telemetry point (RAW, CONVERTED, FORMATTED, WITH_UNITS)</td><td>Click an item and change the value type.</td></tr><tr><td>DE-5</td><td>Data Extractor shall support saving configurations.</td><td>Select File->Save Config</td></tr><tr><td>DE-6</td><td>Data Extractor shall support loading configurations.</td><td>Select File->Load Config</td></tr><tr><td>DE-7</td><td>Data Extractor shall support deleting items</td><td>Select an Item and press delete</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="data-viewer">Data Viewer<a href="#data-viewer" class="hash-link" aria-label="Direct link to Data Viewer" title="Direct link to Data Viewer"></a></h2><p>Data Viewer provides for textual display of telemetry packets where other display methods are not a good fit. It is especially useful for memory dumps and for log message type data display.</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>DV-1</td><td>Data Viewer shall support realtime processing of telemetry packets.</td><td>Press Start to start realtime processing.</td></tr><tr><td>DV-2</td><td>Data Viewer shall support logged playback of telemetry packets.</td><td>Select a time range to playback.</td></tr><tr><td>DV-3</td><td>Data Viewer shall support textual display of telemetry packets.</td><td>View the display of data.</td></tr><tr><td>DV-4</td><td>Data Viewer shall support multiple tabs for data display.</td><td>Switch between several tabs of data.</td></tr><tr><td>DV-5</td><td>Data Viewer shall support deleting tabs.</td><td>Delete a tab.</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="calendar">Calendar<a href="#calendar" class="hash-link" aria-label="Direct link to Calendar" title="Direct link to Calendar"></a></h2><p>Calendar</p><p>The Calendar tool provides a user interface and API for initiating scheduled actions in COSMOS</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>TL-1</td><td>Calendar shall allow creating new timelines</td><td>Click the button and create a new timeline</td></tr><tr><td>TL-2</td><td>Calendar shall allow scheduling commands for future execection</td><td>Add a command to a timeline</td></tr><tr><td>TL-3</td><td>Calendar shall allow scheduling scripts for future execution</td><td>Add a script to a timeline</td></tr><tr><td>TL-4</td><td>Calendar shall allow for reserving a resource</td><td>Add a reservation to a timeline</td></tr><tr><td>TL-5</td><td>Calendar shall track success or failure of commands</td><td>Look at status from a completed command</td></tr><tr><td>TL-6</td><td>Calendar shall track success or failure of scripts</td><td>Look at status from a completed script</td></tr><tr><td>TL-7</td><td>Calendar shall allow deleting activities from timelines</td><td>Delete a preexisting item from a timeline</td></tr><tr><td>TL-8</td><td>Calendar shall allow deleting timelines</td><td>Delete a timeline</td></tr></tbody></table><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="admin">Admin<a href="#admin" class="hash-link" aria-label="Direct link to Admin" title="Direct link to Admin"></a></h2><p>Admin</p><p>The Admin tool provides administrative functionality including managing plugins for the COSMOS system</p><table><thead><tr><th>Reqt. ID</th><th>Description</th><th>Test Description</th></tr></thead><tbody><tr><td>AD-1</td><td>The Admin Tool shall allow installing plugins</td><td>Upload and Install a Plugin</td></tr><tr><td>AD-2</td><td>The Admin Tool shall support upgrading plugins</td><td>Upgrade an installed plugin</td></tr><tr><td>AD-3</td><td>The Admin Tool shall support uninstalling plugins</td><td>Uninstall a plugin</td></tr><tr><td>AD-4</td><td>The Admin Tool shall display information on installed plugins</td><td>View info on Interfaces, Microservices, etc</td></tr><tr><td>AD-5</td><td>The Admin Tool shall support editing microservices</td><td>Edit the settings for a microservice</td></tr><tr><td>AD-6</td><td>The Admin Tool shall support discovery of plugins</td><td>Discover and download a plugin</td></tr><tr><td>AD-7</td><td>The Admin Tool shall support adding links to external tools</td><td>Add a link to Google</td></tr><tr><td>AD-8</td><td>The Admin Tool shall support reordering tools</td><td>Reorder tools on the tools tab</td></tr><tr><td>AD-9</td><td>The Admin Tool shall support configuring a classification bar</td><td>Add a classification bar on the settings tab</td></tr></tbody></table></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/OpenC3/cosmos/tree/main/docs.openc3.com/docs/getting-started/requirements.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_UohW" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_T23F"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/tools/docs/docs/getting-started/upgrading"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Upgrading</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/tools/docs/docs/getting-started/podman"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Podman</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_TN1Q thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#terminology" class="table-of-contents__link toc-highlight">Terminology</a></li><li><a href="#overall-architecture-and-context-diagram" class="table-of-contents__link toc-highlight">Overall Architecture and Context Diagram</a></li><li><a href="#overall-requirements" class="table-of-contents__link toc-highlight">Overall Requirements</a></li><li><a href="#api-requirements" class="table-of-contents__link toc-highlight">Api Requirements</a></li><li><a href="#command-and-telemetry-server" class="table-of-contents__link toc-highlight">Command and Telemetry Server</a></li><li><a href="#limits-monitor" class="table-of-contents__link toc-highlight">Limits Monitor</a></li><li><a href="#command-sender" class="table-of-contents__link toc-highlight">Command Sender</a></li><li><a href="#script-runner" class="table-of-contents__link toc-highlight">Script Runner</a></li><li><a href="#packet-viewer" class="table-of-contents__link toc-highlight">Packet Viewer</a></li><li><a href="#telemetry-viewer" class="table-of-contents__link toc-highlight">Telemetry Viewer</a></li><li><a href="#telemetry-grapher" class="table-of-contents__link toc-highlight">Telemetry Grapher</a></li><li><a href="#data-extractor" class="table-of-contents__link toc-highlight">Data Extractor</a></li><li><a href="#data-viewer" class="table-of-contents__link toc-highlight">Data Viewer</a></li><li><a href="#calendar" class="table-of-contents__link toc-highlight">Calendar</a></li><li><a href="#admin" class="table-of-contents__link toc-highlight">Admin</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Homepage</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://openc3.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">Home</a></li></ul></div><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs">Documentation</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://www.linkedin.com/company/openc3" target="_blank" rel="noopener noreferrer" class="footer__link-item">LinkedIn<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/OpenC3/cosmos" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs/privacy">Privacy</a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2023 OpenC3, Inc.</div></div></div></footer></div>
|
13
|
+
<script src="/tools/docs/assets/js/runtime~main.e3a6c705.js"></script>
|
14
|
+
<script src="/tools/docs/assets/js/main.b5a535c2.js"></script>
|
15
|
+
</body>
|
16
|
+
</html>
|
@@ -0,0 +1,16 @@
|
|
1
|
+
<!doctype html>
|
2
|
+
<html lang="en" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-getting-started/upgrading" data-has-hydrated="false">
|
3
|
+
<head>
|
4
|
+
<meta charset="UTF-8">
|
5
|
+
<meta name="generator" content="Docusaurus v2.4.3">
|
6
|
+
<title data-rh="true">Upgrading | OpenC3 Docs</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openc3.com/tools/docs/docs/getting-started/upgrading"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Upgrading | OpenC3 Docs"><meta data-rh="true" name="description" content="COSMOS Upgrades"><meta data-rh="true" property="og:description" content="COSMOS Upgrades"><link data-rh="true" rel="icon" href="/tools/docs/img/favicon.png"><link data-rh="true" rel="canonical" href="https://docs.openc3.com/tools/docs/docs/getting-started/upgrading"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/getting-started/upgrading" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/getting-started/upgrading" hreflang="x-default"><link rel="stylesheet" href="/tools/docs/assets/css/styles.7bc79028.css">
|
7
|
+
<link rel="preload" href="/tools/docs/assets/js/runtime~main.e3a6c705.js" as="script">
|
8
|
+
<link rel="preload" href="/tools/docs/assets/js/main.b5a535c2.js" as="script">
|
9
|
+
</head>
|
10
|
+
<body class="navigation-with-keyboard">
|
11
|
+
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"dark")}()</script><div id="__docusaurus">
|
12
|
+
<div role="region" aria-label="Skip to main content"><a class="skipToContent_G6ar" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/tools/docs/"><div class="navbar__logo"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--light_riBm"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--dark_Dsi0"></div><b class="navbar__title text--truncate">OpenC3 Docs</b></a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/tools/docs/docs">Documentation</a><a href="https://openc3.com/enterprise/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Enterprise</a></div><div class="navbar__items navbar__items--right"><div class="searchBox_xrOJ"><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Loading..." aria-label="Search" class="navbar__search-input search-bar" disabled=""></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_UyTV docsWrapper_BqXd"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_z1FD" type="button"></button><div class="docPage_pOTq"><aside class="theme-doc-sidebar-container docSidebarContainer_aIKW"><div class="sidebarViewport_DwR9"><div class="sidebar_vJCc"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_qiME"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs">Introduction</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" href="/tools/docs/docs/getting-started">Getting Started</a><button aria-label="Toggle the collapsible sidebar category 'Getting Started'" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/installation">Installation</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/gettingstarted">Getting Started</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/tools/docs/docs/getting-started/upgrading">Upgrading</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/requirements">Requirements and Design</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/podman">Podman</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/configuration">Configuration</a><button aria-label="Toggle the collapsible sidebar category 'Configuration'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/tools">Tools</a><button aria-label="Toggle the collapsible sidebar category 'Tools'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/guides">Guides</a><button aria-label="Toggle the collapsible sidebar category 'Guides'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/development">Development</a><button aria-label="Toggle the collapsible sidebar category 'Development'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/meta">Meta</a><button aria-label="Toggle the collapsible sidebar category 'Meta'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs/privacy">OpenC3, Inc. Privacy Policy</a></li></ul></nav></div></div></aside><main class="docMainContainer_fv3b"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_YAwJ"><div class="docItemContainer_Rv5Z"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_zCmv" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/tools/docs/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_JFrk"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/tools/docs/docs/getting-started"><span itemprop="name">Getting Started</span></a><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">Upgrading</span><meta itemprop="position" content="2"></li></ul></nav><div class="tocCollapsible_O_Qc theme-doc-toc-mobile tocMobile_tjDr"><button type="button" class="clean-btn tocCollapsibleButton_htYj">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Upgrading</h1></header><h3 class="anchor anchorWithStickyNavbar_fF9Z" id="cosmos-upgrades">COSMOS Upgrades<a href="#cosmos-upgrades" class="hash-link" aria-label="Direct link to COSMOS Upgrades" title="Direct link to COSMOS Upgrades"></a></h3><p>COSMOS is released as Docker containers. Since we're using Docker containers and volumes we can simply stop the existing COSMOS application, then download and run the new release.</p><p>This example assumes an existing COSMOS project at C:\cosmos-project.</p><ol><li><p>Stop the current COSMOS application</p><div class="language-batch codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-batch codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token plain">C:\cosmos-project> openc3.bat stop</span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Change the release in the .env file to the desired release</p><div class="language-batch codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-batch codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token plain">OPENC3_TAG=5.1.1</span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Run the new COSMOS application</p><div class="language-batch codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-batch codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token plain">C:\cosmos-project> openc3.bat run</span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li></ol><h3 class="anchor anchorWithStickyNavbar_fF9Z" id="migrating-from-cosmos-4-to-cosmos-5">Migrating From COSMOS 4 to COSMOS 5<a href="#migrating-from-cosmos-4-to-cosmos-5" class="hash-link" aria-label="Direct link to Migrating From COSMOS 4 to COSMOS 5" title="Direct link to Migrating From COSMOS 4 to COSMOS 5"></a></h3><p>COSMOS 5 is a new architecture and treats targets as independent <a href="/tools/docs/docs/configuration/plugins">plugins</a>. Thus the primary effort in porting from COSMOS 4 to COSMOS 5 is converting targets to plugins. We recommend creating plugins for each independent target (with its own interface) but targets which share an interface will need to be part of the same plugin. The reason for independent plugins is it allows the plugin to be versioned separately and more easily shared outside your specific project. If you have very project specific targets (e.g. custom hardware) those can potentially be combined for ease of deployment.</p><p>COSMOS 5 includes a migration tool for converting an existing COSMOS 4 configuration into a COSMOS 5 plugin. This example assumes an existing COSMOS 4 configuration at C:\COSMOS and a new COSMOS 5 installation at C:\cosmos-project. Linux users can adjust paths and change from .bat to .sh to follow along.</p><ol><li><p>Change to the existing COSMOS 4 configuration directory. You should see the config, lib, procedures, outputs directory. You can then run the migration tool by specifying the absolute path to the COSMOS 5 installation.</p><div class="language-batch codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-batch codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token plain">C:\COSMOS> C:\cosmos-project\openc3.bat cli migrate -a demo</span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>This creates a new COSMOS 5 plugin called openc3-cosmos-demo with a target named DEMO containing the existing lib and procedures files as well as all the existing targets.</p><div class="language-batch codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-batch codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token plain">C:\COSMOS> C:\cosmos-project\openc3.bat cli migrate demo-part INST</span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>This would create a new COSMOS 5 plugin called openc3-cosmos-demo-part with a target named DEMO_PART containing the existing lib and procedures files as well as the INST target (but no others).</p></li><li><p>Open the new COSMOS 5 plugin and ensure the <a href="/tools/docs/docs/configuration/plugins#plugintxt-configuration-file">plugin.txt</a> file is correctly configured. The migration tool doesn't create VARIABLEs or MICROSERVICEs or handle target substitution so those features will have to added manually.</p></li><li><p>Follow the <a href="/tools/docs/docs/getting-started/gettingstarted#building-your-plugin">building your plugin</a> part of the Getting Started tutorial to build your new plugin and upload it to COSMOS 5.</p></li></ol></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/OpenC3/cosmos/tree/main/docs.openc3.com/docs/getting-started/upgrading.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_UohW" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_T23F"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/tools/docs/docs/getting-started/gettingstarted"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Getting Started</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/tools/docs/docs/getting-started/requirements"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Requirements and Design</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_TN1Q thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#cosmos-upgrades" class="table-of-contents__link toc-highlight">COSMOS Upgrades</a></li><li><a href="#migrating-from-cosmos-4-to-cosmos-5" class="table-of-contents__link toc-highlight">Migrating From COSMOS 4 to COSMOS 5</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Homepage</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://openc3.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">Home</a></li></ul></div><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs">Documentation</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://www.linkedin.com/company/openc3" target="_blank" rel="noopener noreferrer" class="footer__link-item">LinkedIn<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/OpenC3/cosmos" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs/privacy">Privacy</a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2023 OpenC3, Inc.</div></div></div></footer></div>
|
13
|
+
<script src="/tools/docs/assets/js/runtime~main.e3a6c705.js"></script>
|
14
|
+
<script src="/tools/docs/assets/js/main.b5a535c2.js"></script>
|
15
|
+
</body>
|
16
|
+
</html>
|
@@ -0,0 +1,16 @@
|
|
1
|
+
<!doctype html>
|
2
|
+
<html lang="en" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default" data-has-hydrated="false">
|
3
|
+
<head>
|
4
|
+
<meta charset="UTF-8">
|
5
|
+
<meta name="generator" content="Docusaurus v2.4.3">
|
6
|
+
<title data-rh="true">Getting Started | OpenC3 Docs</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openc3.com/tools/docs/docs/getting-started"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Getting Started | OpenC3 Docs"><meta data-rh="true" name="description" content="Get started with OpenC3 COSMOS"><meta data-rh="true" property="og:description" content="Get started with OpenC3 COSMOS"><link data-rh="true" rel="icon" href="/tools/docs/img/favicon.png"><link data-rh="true" rel="canonical" href="https://docs.openc3.com/tools/docs/docs/getting-started"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/getting-started" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/getting-started" hreflang="x-default"><link rel="stylesheet" href="/tools/docs/assets/css/styles.7bc79028.css">
|
7
|
+
<link rel="preload" href="/tools/docs/assets/js/runtime~main.e3a6c705.js" as="script">
|
8
|
+
<link rel="preload" href="/tools/docs/assets/js/main.b5a535c2.js" as="script">
|
9
|
+
</head>
|
10
|
+
<body class="navigation-with-keyboard">
|
11
|
+
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"dark")}()</script><div id="__docusaurus">
|
12
|
+
<div role="region" aria-label="Skip to main content"><a class="skipToContent_G6ar" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/tools/docs/"><div class="navbar__logo"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--light_riBm"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--dark_Dsi0"></div><b class="navbar__title text--truncate">OpenC3 Docs</b></a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/tools/docs/docs">Documentation</a><a href="https://openc3.com/enterprise/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Enterprise</a></div><div class="navbar__items navbar__items--right"><div class="searchBox_xrOJ"><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Loading..." aria-label="Search" class="navbar__search-input search-bar" disabled=""></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_UyTV docsWrapper_BqXd"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_z1FD" type="button"></button><div class="docPage_pOTq"><aside class="theme-doc-sidebar-container docSidebarContainer_aIKW"><div class="sidebarViewport_DwR9"><div class="sidebar_vJCc"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_qiME"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs">Introduction</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible menu__list-item-collapsible--active"><a class="menu__link menu__link--sublist menu__link--active" aria-current="page" aria-expanded="true" href="/tools/docs/docs/getting-started">Getting Started</a><button aria-label="Toggle the collapsible sidebar category 'Getting Started'" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/installation">Installation</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/gettingstarted">Getting Started</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/upgrading">Upgrading</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/requirements">Requirements and Design</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/getting-started/podman">Podman</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/configuration">Configuration</a><button aria-label="Toggle the collapsible sidebar category 'Configuration'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/tools">Tools</a><button aria-label="Toggle the collapsible sidebar category 'Tools'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/guides">Guides</a><button aria-label="Toggle the collapsible sidebar category 'Guides'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/development">Development</a><button aria-label="Toggle the collapsible sidebar category 'Development'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/meta">Meta</a><button aria-label="Toggle the collapsible sidebar category 'Meta'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs/privacy">OpenC3, Inc. Privacy Policy</a></li></ul></nav></div></div></aside><main class="docMainContainer_fv3b"><div class="container padding-top--md padding-bottom--lg"><div class="generatedIndexPage_ak01"><nav class="theme-doc-breadcrumbs breadcrumbsContainer_zCmv" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/tools/docs/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_JFrk"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">Getting Started</span><meta itemprop="position" content="1"></li></ul></nav><header><h1 class="title_AulG">Getting Started</h1><p>Get started with OpenC3 COSMOS</p></header><article class="margin-top--lg"><section class="row list_iQEt"><article class="col col--6 margin-bottom--lg"><a class="card padding--lg cardContainer_Shn5" href="/tools/docs/docs/getting-started/installation"><h2 class="text--truncate cardTitle_h48N" title="Installation">📄️<!-- --> <!-- -->Installation</h2><p class="text--truncate cardDescription_CytT" title="Installing OpenC3 COSMOS">Installing OpenC3 COSMOS</p></a></article><article class="col col--6 margin-bottom--lg"><a class="card padding--lg cardContainer_Shn5" href="/tools/docs/docs/getting-started/gettingstarted"><h2 class="text--truncate cardTitle_h48N" title="Getting Started">📄️<!-- --> <!-- -->Getting Started</h2><p class="text--truncate cardDescription_CytT" title="Welcome to the OpenC3 COSMOS system... Let's get started! This guide is a high level overview that will help with setting up your first COSMOS project.">Welcome to the OpenC3 COSMOS system... Let's get started! This guide is a high level overview that will help with setting up your first COSMOS project.</p></a></article><article class="col col--6 margin-bottom--lg"><a class="card padding--lg cardContainer_Shn5" href="/tools/docs/docs/getting-started/upgrading"><h2 class="text--truncate cardTitle_h48N" title="Upgrading">📄️<!-- --> <!-- -->Upgrading</h2><p class="text--truncate cardDescription_CytT" title="COSMOS Upgrades">COSMOS Upgrades</p></a></article><article class="col col--6 margin-bottom--lg"><a class="card padding--lg cardContainer_Shn5" href="/tools/docs/docs/getting-started/requirements"><h2 class="text--truncate cardTitle_h48N" title="Requirements and Design">📄️<!-- --> <!-- -->Requirements and Design</h2><p class="text--truncate cardDescription_CytT" title="OpenC3 COSMOS is a command and control system providing commanding, scripting, and data visualization capabilities for embedded systems and systems of systems. COSMOS is intended for use during all phases of testing (board, box, integrated system) and during operations.">OpenC3 COSMOS is a command and control system providing commanding, scripting, and data visualization capabilities for embedded systems and systems of systems. COSMOS is intended for use during all phases of testing (board, box, integrated system) and during operations.</p></a></article><article class="col col--6 margin-bottom--lg"><a class="card padding--lg cardContainer_Shn5" href="/tools/docs/docs/getting-started/podman"><h2 class="text--truncate cardTitle_h48N" title="Podman">📄️<!-- --> <!-- -->Podman</h2><p class="text--truncate cardDescription_CytT" title="OpenC3 COSMOS Using Rootless Podman and Docker-Compose">OpenC3 COSMOS Using Rootless Podman and Docker-Compose</p></a></article></section></article><footer class="margin-top--lg"><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/tools/docs/docs"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Introduction</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/tools/docs/docs/getting-started/installation"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Installation</div></a></nav></footer></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Homepage</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://openc3.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">Home</a></li></ul></div><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs">Documentation</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://www.linkedin.com/company/openc3" target="_blank" rel="noopener noreferrer" class="footer__link-item">LinkedIn<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/OpenC3/cosmos" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs/privacy">Privacy</a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2023 OpenC3, Inc.</div></div></div></footer></div>
|
13
|
+
<script src="/tools/docs/assets/js/runtime~main.e3a6c705.js"></script>
|
14
|
+
<script src="/tools/docs/assets/js/main.b5a535c2.js"></script>
|
15
|
+
</body>
|
16
|
+
</html>
|
@@ -0,0 +1,23 @@
|
|
1
|
+
<!doctype html>
|
2
|
+
<html lang="en" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-guides/bridges" data-has-hydrated="false">
|
3
|
+
<head>
|
4
|
+
<meta charset="UTF-8">
|
5
|
+
<meta name="generator" content="Docusaurus v2.4.3">
|
6
|
+
<title data-rh="true">Bridges | OpenC3 Docs</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openc3.com/tools/docs/docs/guides/bridges"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Bridges | OpenC3 Docs"><meta data-rh="true" name="description" content="COSMOS Bridges provide an easy solution for getting data from devices that don't speak Ethernet into COSMOS."><meta data-rh="true" property="og:description" content="COSMOS Bridges provide an easy solution for getting data from devices that don't speak Ethernet into COSMOS."><link data-rh="true" rel="icon" href="/tools/docs/img/favicon.png"><link data-rh="true" rel="canonical" href="https://docs.openc3.com/tools/docs/docs/guides/bridges"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/guides/bridges" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openc3.com/tools/docs/docs/guides/bridges" hreflang="x-default"><link rel="stylesheet" href="/tools/docs/assets/css/styles.7bc79028.css">
|
7
|
+
<link rel="preload" href="/tools/docs/assets/js/runtime~main.e3a6c705.js" as="script">
|
8
|
+
<link rel="preload" href="/tools/docs/assets/js/main.b5a535c2.js" as="script">
|
9
|
+
</head>
|
10
|
+
<body class="navigation-with-keyboard">
|
11
|
+
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"dark")}()</script><div id="__docusaurus">
|
12
|
+
<div role="region" aria-label="Skip to main content"><a class="skipToContent_G6ar" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/tools/docs/"><div class="navbar__logo"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--light_riBm"><img src="/tools/docs/img/logo.svg" alt="OpenC3 Logo" class="themedImage_RWGG themedImage--dark_Dsi0"></div><b class="navbar__title text--truncate">OpenC3 Docs</b></a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/tools/docs/docs">Documentation</a><a href="https://openc3.com/enterprise/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Enterprise</a></div><div class="navbar__items navbar__items--right"><div class="searchBox_xrOJ"><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Loading..." aria-label="Search" class="navbar__search-input search-bar" disabled=""></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_UyTV docsWrapper_BqXd"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_z1FD" type="button"></button><div class="docPage_pOTq"><aside class="theme-doc-sidebar-container docSidebarContainer_aIKW"><div class="sidebarViewport_DwR9"><div class="sidebar_vJCc"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_qiME"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs">Introduction</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/getting-started">Getting Started</a><button aria-label="Toggle the collapsible sidebar category 'Getting Started'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/configuration">Configuration</a><button aria-label="Toggle the collapsible sidebar category 'Configuration'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/tools">Tools</a><button aria-label="Toggle the collapsible sidebar category 'Tools'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" href="/tools/docs/docs/guides">Guides</a><button aria-label="Toggle the collapsible sidebar category 'Guides'" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/tools/docs/docs/guides/bridges">Bridges</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/cfs">COSMOS and NASA cFS</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/custom-widgets">Custom Widgets</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/little-endian-bitfields">Little Endian Bitfields</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/local-mode">Local Mode</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/logging">Logging</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/monitoring">Monitoring</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/performance">Performance</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/raspberrypi">Raspberry Pi</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/script-writing">Script Writing Guide</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/tools/docs/docs/guides/scripting-api">Scripting API Guide</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/development">Development</a><button aria-label="Toggle the collapsible sidebar category 'Development'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/tools/docs/docs/meta">Meta</a><button aria-label="Toggle the collapsible sidebar category 'Meta'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/tools/docs/docs/privacy">OpenC3, Inc. Privacy Policy</a></li></ul></nav></div></div></aside><main class="docMainContainer_fv3b"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_YAwJ"><div class="docItemContainer_Rv5Z"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_zCmv" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/tools/docs/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_JFrk"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/tools/docs/docs/guides"><span itemprop="name">Guides</span></a><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">Bridges</span><meta itemprop="position" content="2"></li></ul></nav><div class="tocCollapsible_O_Qc theme-doc-toc-mobile tocMobile_tjDr"><button type="button" class="clean-btn tocCollapsibleButton_htYj">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Bridges</h1></header><p>COSMOS Bridges provide an easy solution for getting data from devices that don't speak Ethernet into COSMOS.
|
13
|
+
Serial ports are the most common, but other devices such as USB, PCI cards, and Bluetooth devices can also be
|
14
|
+
supported by using bridges to convert from a host computer accessible device, into an Ethernet byte stream that
|
15
|
+
COSMOS can process from inside of containers.</p><div class="theme-admonition theme-admonition-caution alert alert--warning admonition_qNG0"><div class="admonitionHeading_l909"><span class="admonitionIcon_UNbs"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>Bridges are Meant to be Dumb</div><div class="admonitionContent_oUmQ"><p>The purpose of bridges is to get bytes into COSMOS. Processing should be done in COSMOS itself, including details such as
|
16
|
+
packet delineation.</p></div></div><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="bridges-are-generally-just-an-interface-and-router">Bridges are Generally Just an Interface and Router<a href="#bridges-are-generally-just-an-interface-and-router" class="hash-link" aria-label="Direct link to Bridges are Generally Just an Interface and Router" title="Direct link to Bridges are Generally Just an Interface and Router"></a></h2><p>Bridges are generally made up of a COSMOS Interface class that pull data from a host connected device, and a Router that forwards that data to
|
17
|
+
COSMOS over TCP/IP. In most cases, data can be safely sent to COSMOS using the BURST protocol, and let the COSMOS side use the correct packet delineation
|
18
|
+
protocol like LENGTH.</p><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="host-requirements-for-running-bridges">Host Requirements for Running Bridges<a href="#host-requirements-for-running-bridges" class="hash-link" aria-label="Direct link to Host Requirements for Running Bridges" title="Direct link to Host Requirements for Running Bridges"></a></h2><ul><li>Requires a host Ruby installation (Ruby 3)</li><li>Install the OpenC3 gem<ul><li>gem install openc3</li></ul></li><li>Make sure the Ruby gem executable path is in your PATH environment variable<ul><li>You can find this path by running <code>gem environment</code> and looking for EXECUTABLE DIRECTORY</li></ul></li><li>If successful, you should be able to run <code>openc3cli</code> from a terminal</li></ul><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="bridge-configuration-bridgetxt">Bridge Configuration: bridge.txt<a href="#bridge-configuration-bridgetxt" class="hash-link" aria-label="Direct link to Bridge Configuration: bridge.txt" title="Direct link to Bridge Configuration: bridge.txt"></a></h2><p>Bridges are run using an configuration file named bridge.txt. This file is a subset of the plugin.txt configuration syntax supporting VARIABLE, INTERFACE, ROUTER, and associated modifier keywords. However, BRIDGES HAVE NO KNOWLEDGE OF TARGETS. So instead of MAP_TARGETS, the INTERFACE is associated with the ROUTER using the ROUTE keyword.</p><p>The following is the default bridge.txt that is generated by running <code>openc3cli bridgesetup</code></p><div class="language-ruby codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-ruby codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Write serial port name</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> write_port_name </span><span class="token constant" style="color:rgb(130, 170, 255)">COM1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Read serial port name</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> read_port_name </span><span class="token constant" style="color:rgb(130, 170, 255)">COM1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Baud Rate</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> baud_rate </span><span class="token number" style="color:rgb(247, 140, 108)">115200</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Parity - NONE, ODD, or EVEN</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> parity </span><span class="token constant" style="color:rgb(130, 170, 255)">NONE</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Stop bits - 0, 1, or 2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> stop_bits </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Write Timeout</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> write_timeout </span><span class="token number" style="color:rgb(247, 140, 108)">10.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Read Timeout</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> read_timeout </span><span class="token keyword" style="color:rgb(127, 219, 202)">nil</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Flow Control - NONE, or RTSCTS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> flow_control </span><span class="token constant" style="color:rgb(130, 170, 255)">NONE</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Data bits per word - Typically 8</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> data_bits </span><span class="token number" style="color:rgb(247, 140, 108)">8</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Port to listen for connections from COSMOS - Plugin must match</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> router_port </span><span class="token number" style="color:rgb(247, 140, 108)">2950</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># Port to listen on for connections from COSMOS. Defaults to localhost for security. Will need to be opened</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token comment" style="color:rgb(99, 119, 119);font-style:italic"># if COSMOS is on another machine.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">VARIABLE</span><span class="token plain"> router_listen_address </span><span class="token number" style="color:rgb(247, 140, 108)">127.0</span><span class="token number" style="color:rgb(247, 140, 108)">.0</span><span class="token number" style="color:rgb(247, 140, 108)">.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"></span><span class="token constant" style="color:rgb(130, 170, 255)">INTERFACE</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">SERIAL_INT</span><span class="token plain"> serial_interface</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">rb </span><span class="token operator" style="color:rgb(127, 219, 202)"><</span><span class="token operator" style="color:rgb(127, 219, 202)">%=</span><span class="token plain"> write_port_name </span><span class="token string-literal string" style="color:rgb(173, 219, 103)">%> <%= read_port_name %></span><span class="token plain"> </span><span class="token operator" style="color:rgb(127, 219, 202)"><</span><span class="token operator" style="color:rgb(127, 219, 202)">%=</span><span class="token plain"> baud_rate </span><span class="token string-literal string" style="color:rgb(173, 219, 103)">%> <%= parity %></span><span class="token plain"> </span><span class="token operator" style="color:rgb(127, 219, 202)"><</span><span class="token operator" style="color:rgb(127, 219, 202)">%=</span><span class="token plain"> stop_bits </span><span class="token string-literal string" style="color:rgb(173, 219, 103)">%> <%= write_timeout %></span><span class="token plain"> </span><span class="token operator" style="color:rgb(127, 219, 202)"><</span><span class="token operator" style="color:rgb(127, 219, 202)">%=</span><span class="token plain"> read_timeout </span><span class="token string-literal string" style="color:rgb(173, 219, 103)">%></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token string-literal string" style="color:rgb(173, 219, 103)"> OPTION FLOW_CONTROL <%= flow_control %></span><span class="token plain"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">OPTION</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">DATA_BITS</span><span class="token plain"> </span><span class="token operator" style="color:rgb(127, 219, 202)"><</span><span class="token operator" style="color:rgb(127, 219, 202)">%=</span><span class="token plain"> data_bits </span><span class="token string-literal string" style="color:rgb(173, 219, 103)">%></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token string-literal string" style="display:inline-block;color:rgb(173, 219, 103)"></span><br></span><span class="token-line" style="color:#d6deeb"><span class="token string-literal string" style="color:rgb(173, 219, 103)">ROUTER SERIAL_ROUTER tcpip_server_interface.rb <%= router_port %></span><span class="token plain"> </span><span class="token operator" style="color:rgb(127, 219, 202)"><</span><span class="token operator" style="color:rgb(127, 219, 202)">%=</span><span class="token plain"> router_port </span><span class="token string-literal string" style="color:rgb(173, 219, 103)">%> 10.0 nil BURST</span><br></span><span class="token-line" style="color:#d6deeb"><span class="token string-literal string" style="color:rgb(173, 219, 103)"> ROUTE SERIAL_INT</span><br></span><span class="token-line" style="color:#d6deeb"><span class="token string-literal string" style="color:rgb(173, 219, 103)"> OPTION LISTEN_ADDRESS <%= router_listen_address %></span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>VARIABLE provides default values to variables that can be changed when the bridge is started. This example shows an INTERFACE that is configured to use the serial_interface.rb class. It also includes a standard ROUTER using tcpip_server_interface.rb that COSMOS can connect to and get the data from the serial port. The LISTEN_ADDRESS is set to 127.0.0.1 in this example to prevent access from outside of the host system. Docker running on the same machine can access
|
19
|
+
this server using the host.docker.internal hostname and the configured port (2950 in this example).</p><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="bridge-commands-openc3cli">Bridge Commands: openc3cli<a href="#bridge-commands-openc3cli" class="hash-link" aria-label="Direct link to Bridge Commands: openc3cli" title="Direct link to Bridge Commands: openc3cli"></a></h2><p><code>openc3cli bridgesetup</code></p><p>Generates a bridge.txt example file</p><p><code>openc3cli bridge [filename] [variable1=value1] [variable2=value2]</code></p><p>Runs a bridge from a given configuration file. Defaults to bridge.txt in the current directory. Variables can also be passed into to override VARIABLE defaults.</p><p><code>openc3cli bridgegem [gem_name] [variable1=value1] [variable2=value2]</code></p><p>Runs a bridge using the bridge.txt provided in a bridge gem. Variables can also be passed into to override VARIABLE defaults.</p><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="example-bridge-gems">Example Bridge Gems<a href="#example-bridge-gems" class="hash-link" aria-label="Direct link to Example Bridge Gems" title="Direct link to Example Bridge Gems"></a></h2><ul><li>Serial Port: <a href="https://github.com/OpenC3/openc3-cosmos-bridge-serial" target="_blank" rel="noopener noreferrer">openc3-cosmos-bridge-serial</a></li><li>Host: <a href="https://github.com/OpenC3/openc3-cosmos-bridge-host" target="_blank" rel="noopener noreferrer">openc3-cosmos-bridge-host</a></li><li>HIDAPI: <a href="https://github.com/OpenC3/openc3-cosmos-bridge-hidapi" target="_blank" rel="noopener noreferrer">openc3-cosmos-bridge-hidapi</a></li><li>PS5 Dual Sense Controller: <a href="https://github.com/OpenC3/openc3-cosmos-bridge-dualsense" target="_blank" rel="noopener noreferrer">openc3-cosmos-bridge-dualsense</a></li></ul><h2 class="anchor anchorWithStickyNavbar_fF9Z" id="note-on-serial-ports">Note on Serial Ports<a href="#note-on-serial-ports" class="hash-link" aria-label="Direct link to Note on Serial Ports" title="Direct link to Note on Serial Ports"></a></h2><p>Serial ports can be used directly without bridges on Linux Docker installations.</p><p>Add the following to the operator service in compose.yaml:</p><div class="codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token plain"> devices:</span><br></span><span class="token-line" style="color:#d6deeb"><span class="token plain"> - "/dev/ttyUSB0:/dev/ttyUSB0"</span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>Make sure the serial device has permissions for the user running Docker to access:</p><div class="codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#d6deeb;--prism-background-color:#011627"><div class="codeBlockContent_qZBB"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#d6deeb"><span class="token plain">sudo chmod 666 /dev/ttyUSB0</span><br></span></code></pre><div class="buttonGroup_TNwR"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_MVhB" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_yxgH"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_QJLJ"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/OpenC3/cosmos/tree/main/docs.openc3.com/docs/guides/bridges.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_UohW" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_T23F"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/tools/docs/docs/guides"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Guides</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/tools/docs/docs/guides/cfs"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">COSMOS and NASA cFS</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_TN1Q thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#bridges-are-generally-just-an-interface-and-router" class="table-of-contents__link toc-highlight">Bridges are Generally Just an Interface and Router</a></li><li><a href="#host-requirements-for-running-bridges" class="table-of-contents__link toc-highlight">Host Requirements for Running Bridges</a></li><li><a href="#bridge-configuration-bridgetxt" class="table-of-contents__link toc-highlight">Bridge Configuration: bridge.txt</a></li><li><a href="#bridge-commands-openc3cli" class="table-of-contents__link toc-highlight">Bridge Commands: openc3cli</a></li><li><a href="#example-bridge-gems" class="table-of-contents__link toc-highlight">Example Bridge Gems</a></li><li><a href="#note-on-serial-ports" class="table-of-contents__link toc-highlight">Note on Serial Ports</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Homepage</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://openc3.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">Home</a></li></ul></div><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs">Documentation</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://www.linkedin.com/company/openc3" target="_blank" rel="noopener noreferrer" class="footer__link-item">LinkedIn<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/OpenC3/cosmos" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_awgD"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a class="footer__link-item" href="/tools/docs/docs/privacy">Privacy</a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2023 OpenC3, Inc.</div></div></div></footer></div>
|
20
|
+
<script src="/tools/docs/assets/js/runtime~main.e3a6c705.js"></script>
|
21
|
+
<script src="/tools/docs/assets/js/main.b5a535c2.js"></script>
|
22
|
+
</body>
|
23
|
+
</html>
|