Releases: OpenC3/cosmos
v6.0.1
OpenC3 COSMOS 6.0.1 - Bug fixes and enhancements
Welcome to OpenC3 COSMOS 6.0.1!
This release restores the display_screen functionality and has several enhancements
Potentially Breaking Changes
See the release notes for COSMOS 6.0.0!
Improvements
- Updated the MINIO dockerfile
- Show 404 page for non-existent routes
- Improved error messages for LIMITSBAR, LIMITSCOLUMN (and variants)
Bug Fixes
- Fix display_screen API
- Fix layout of ROLLUP, LED, and SIGNAL widgets by adding computedStyle
All Pull Requests in this Release
- Traefik config tools-router by @jmthomas in #1776
- Add computedStyle to ROLLUP, LED, and SIGNAL widgets by @jmthomas in #1781
- Update Minio by @jmthomas in #1783
- Small login bugs by @ryan-pratt in #1788
- Show 404 page for non-existent routes by @ryan-pratt in #1789
- Upgrade vite to 6.0.5 by @jmthomas in #1791
- Fix menu button height when zoomed out by @ryan-pratt in #1785
- Fix display screen by @jmthomas in #1787
- Fix eslint config by @ryan-pratt in #1792
- Improve trivy checks by @jmthomas in #1790
- Nice error message for widget items without limits by @jmthomas in #1786
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v6.0.0...v6.0.1
v6.0.0
OpenC3 COSMOS 6.0.0 - Frontend Apps Updated to Vue 3
Welcome to OpenC3 COSMOS 6.0.0!
This release focuses on bringing all our dependencies up to the latest versions primary for the COSMOS user interface. The big changes are:
- Vue 2 upgraded to Vue 3
- Vuetify 2 upgraded to Vuetify 3
- Traefik 2 upgraded to Traefik 3
- Grafana 10 upgraded to Grafana 11 (Enterprise)
- Webpack replaced with Vite
- Many other minor depenencies updated
Potentially Breaking Changes
The change from Traefik 2 to Traefik 3 changed the traefik configuration file format. Please update your traefik config files with the latest from cosmos-project.
Any custom Vue based tools will need to be upgraded to Vue 3 / Vuetify 3 / Vite. We've put together a detailed writeup to help with this process here: https://docs.openc3.com/docs/getting-started/upgrading#migrating-from-cosmos-5-to-cosmos-6
Our @openc3/tool-common npm package was broken up into @openc3/js-common and @openc3/vue-common packages. This would affect tools written in any frontend framework.
Commands with states now enforce using defined states. If you need to send an arbitrary value for a command with states you will need to use cmd_no_range_check().
Greatly Improved Container Build Times
Building our containers from source is now about 4 times faster. This is mainly due to the change from Webpack to Vite.
Greatly Improved Documentation
Accessors are now fully documented at docs.openc3.com! Also, more Interfaces and Protocols are documented. The Enterprise Command History Tool is now documented. Every TlmViewer widget now has screen shots.
More Python Parity
Almost every Interface and Protocol available in Ruby is now available in Python (Only current exception is SerialInterface).
BucketExplorer View Files
You can now view files in BucketExplorer, rather than having to download and open them in a separate application.
Sharded Operator (Generally Enterprise)
The operator container can now be run multiple times, each with a unique OPENC3_SHARD environment variable. This is intended as an alternate to using the Kubernetes Operator, if you don't have access to the Kubernetes API.
Other Improvements
- CrcProtocol now supports Crc8
- Installing Plugins and Packages now uses a button, rather than the old paperclip style text area
Other Bug Fixes
- ScriptRunner Suite level setup and teardown now work in Python suites
- Some ScriptRunner output wasn't colored when intended
- Importing from openc3.script now works in Python suites
- Fixed an issue with selecting modified scripts in Calendar and Autonomic (Enterprise)
All Pull Requests in this Release
- Configurable Default Repository URLs for Ruby Gems and Python Packages by @stephen-ritter in #1690
- Bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0 by @dependabot in #1687
- Python TemplateAccessor and CmdResponseProtocol by @ryanmelt in #1684
- Traefik v3 (COSMOS 6) by @jmthomas in #1688
- Cmd history docs by @jmthomas in #1685
- Command State Range Checking for COSMOS 6 by @ryanmelt in #1670
- Vue 3 / Vuetify 3 migration for COSMOS 6 by @ryan-pratt in #1539
- Remove some deprecated items for COSMOS 6 by @jmthomas in #1659
- Fix Python Suite Setup and Teardown by @ryanmelt in #1695
- -Fix typo in docs by @lorenzo-gomez-windhover in #1702
- -Fix typo in docs by @lorenzo-gomez-windhover in #1703
- Widget images by @sydjaythomas in #1700
- BucketExplorer view files and breadcrumb paths by @jmthomas in #1696
- Support period in parameter names for COSMOS 6 by @jmthomas in #1677
- Typo by @lorenzo-gomez-windhover in #1712
- Fix tests for enterprise by @ryan-pratt in #1719
- Fix RawDialog behavior by @ryan-pratt in #1718
- Fix migrations by @ryanmelt in #1716
- Remove inpect override in array and hash by @jmthomas in #1723
- CrcProtocol Support Crc8 by @lorenzo-gomez-windhover in #1724
- Bump codecov/codecov-action from 4 to 5 by @dependabot in #1714
- Bump pypa/gh-action-pypi-publish from 1.11.0 to 1.12.2 by @dependabot in #1699
- Sharded Operator Support by @ryanmelt in #1709
- Handle exceptions in ModelController by @jmthomas in #1704
- Change plugin / package install to a button by @jmthomas in #1713
- Replace Webpack with Vite by @ryanmelt in #1728
- Python Mqtt and exception cleanup by @jmthomas in #1701
- Py suite by @jmthomas in #1730
- Filter Controllers stack trace by @jmthomas in #1731
- Dependency major version updates by @ryan-pratt in #1722
- Add python form & http accessors and http_client_interface by @jmthomas in #1717
- Add File Interface by @ryanmelt in #1708
- Migrate ace-diff from Webpack to Vite by @ryan-pratt in #1736
- Break up tool-common by @ryan-pratt in #1737
- Document interfaces, protocols, accessors by @jmthomas in #1733
- Fix redirect from root path by @ryan-pratt in #1746
- Add COSMOS 6 upgrade guide by @ryan-pratt in #1754
- Better handle script output coloring by @jmthomas in #1751
- Popups and horizontal scroll by @jmthomas in #1755
- Better log message in note and metadata controller, fix ColorSelectForm by @jmthomas in #1756
- CHECKBUTTON checked by default and update example by @jmthomas in #1761
- Bump pypa/gh-action-pypi-publish from 1.12.2 to 1.12.3 by @dependabot in #1749
- Add execute to TimelineModel and api in controller to set it by @jmthomas in #1760
- Polish a couple things by @ryan-pratt in #1757
- Fix import script in python suite by @ryanmelt in #1763
- Remove star from chosen script by @ryanmelt in #1769
- Update tool templates for COSMOS 6 by @jmthomas in #1747
- Fix sharding by @ryanmelt in #1771
- Small bug fixes and enhancements by @ryan-pratt in #1772
- Update package_audit for vue.global and vuetify-labs by @ryan-pratt in #1770
- Dependencies by @jmthomas in #1773
New Contributors
- @lorenzo-gomez-windhover made their first contribution in #1702
- @sydjaythomas made their first contribution in #1700
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.20.0...v6.0.0
v5.20.0
OpenC3 COSMOS 5.20.0 - Critical Commanding (Enterprise)
Welcome to OpenC3 COSMOS 5.20.0!
Critical Commanding (Enterprise)
This release adds a new feature for our Enterprise users called Critical Commanding. Critical commanding in NORMAL mode requires commands marked HAZARDOUS or RESTRICTED to be approved by two operators before being sent. In ALL mode it also requires all manual commands from CmdSender to be approved by two operators. Accounts that approve must have the 'approve_hazardous', 'approve_restricted', or 'approve_normal' permission depending on the type of command. There is also a new default "approver" account in Keycloak.
Packet Viewer Item Pinning
By right clicking on item names, you can now pin items in PacketViewer. This allows you to keep items at the top and watch their values on all pages, and when searching.
ScriptRunner show wait time, colorized output, view logs
The ScriptRunner state field now shows how long you have been waiting on waits and wait_checks. Additionally ScriptRunner output text is now colored green for successful checks, and red for failed checks. Finally you can now view script logs in a dialog, rather than having to download them.
New DATE and TIME widgets
TlmViewer has new DATE and TIME widgets that can be used to have users select a specific date and time that is then used in BUTTON code.
Potentially Breaking Changes
- Updated to Alpine 19
- Delete apis now return 200 instead of 204 on success. 204 was preventing data from being returned by these methods.
Other Improvements
- ScriptRunner now removes the leading script_ or test_ from method names in Suite mode
- The Login prompt now lets you know if you enter a bad password (less than 8 characters)
- Allow horizontal scrolling in TlmViewer and other apps if the content is too wide to fit
- Python now stores packages in a venv
- Hovering over limits bars now shows the limits range
- Limits violation log messages now include the value of the limits that was violated
Other Bug Fixes
- Fixed a bug in PacketViewer where the wrong value would be shown on later pages
- Made TlmGrapher graphs not grow in size when mouseover values
- Fixed enabling and disabling limits on items with colored states
- Calendar updated to better handles events at the same start time (Enterprise)
- LINEGRAPH widget now respects the time zone setting
- Fix ScriptRunner Execute text when file modified
- Fixed authorization for the web_socket_api files
All Pull Requests in this Release
- Add key to PacketViewer table by @jmthomas in #1611
- Bump pypa/gh-action-pypi-publish from 1.10.2 to 1.10.3 by @dependabot in #1622
- Critical Commanding Support For Enterprise by @ryanmelt in #1627
- Fix text offset in Tlm Grapher by @jmthomas in #1607
- Document SR right click by @jmthomas in #1615
- CvtModel get_tlm_values return consistent results by @jmthomas in #1608
- Improve TargetPacketItemChooser behavior by @jmthomas in #1613
- Disabling limits sets enabled to false by @jmthomas in #1609
- Strip script_ and test_ from suite names by @jmthomas in #1614
- Pv pin by @jmthomas in #1621
- Add wait / pause time to state by @jmthomas in #1616
- Trivy workaround for TOOMANYREQUESTS by @jmthomas in #1633
- Fix timeline to handle events at same time by @jmthomas in #1657
- Add time zone to LinegraphWidget by @jmthomas in #1656
- Colorize SR output on CHECK success/failure by @jmthomas in #1654
- Change get_target_names permission to 'system' by @jmthomas in #1651
- Catch initial password set errors by @jmthomas in #1635
- Add LedWidget hover by @jmthomas in #1649
- Hide start button when Suite Runner active by @jmthomas in #1650
- Fix ScriptRunner Execute text when file modified by @jmthomas in #1637
- Format binary output as hex by @jmthomas in #1653
- Default screen cursor, pointer only on linked screens by @jmthomas in #1647
- Allow horizontal scrolling in apps by @jmthomas in #1639
- Alpine19 and Python venvs by @jmthomas in #1604
- beginning to address the SonarCloud Highs by @JL-Brothers in #1546
- Cleanup controllers and change delete 204 to 200 by @jmthomas in #1666
- Add from_config to PacketConfig by @ryanmelt in #1663
- cmd and cmd_raw raise on bad item states by @jmthomas in #1661
- Revert "cmd and cmd_raw raise on bad item states" by @ryanmelt in #1669
- Display range on limits bar hover by @jmthomas in #1648
- Add DATE and TIME widgets by @jmthomas in #1636
- Add limits value to message by @jmthomas in #1640
- add args to conversion to be returnable as json by @JL-Brothers in #1512
- View Script Logs / Report by @jmthomas in #1655
- Handle BLOCK and STRING params in autocomplete by @jmthomas in #1674
- Make Bearer optional in token to fix web_socket_api by @ryanmelt in #1675
- Dependencies by @jmthomas in #1676
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.19.0...v5.20.0
v5.19.0
OpenC3 COSMOS 5.19.0 - Command History and Validators (Enterprise)
Welcome to OpenC3 COSMOS 5.19.0!
This is an exciting release as we have a completely new tool for Enterprise Users - Command History! It provides a quick way to see what commands have been sent, by who, and if the commands were successful.
Associated is a new feature called Command Validators that is available for both Open Source and Enterprise Users. This feature allows us to know if the command was successful after its full lifecycle. Read more below.
Additionally we have grown to the point where security researchers are looking into COSMOS and creating CVEs. This release patches three CVEs that have been written against COSMOS. As always, we recommend updating to our latest version.
Affects Both Open Source and Enterprise Edition:
- CVE-2024-46977 - Path traversal via screen controller (
[GHSL-2024-127]
) - Moderate
Only Affects Open Source Edition:
- CVE-2024-43795 - Cross-site scripting in Login functionality (
GHSL-2024-128
) - High - CVE-2024-47529 - Clear text storage of password/token (
GHSL-2024-129
) - Moderate
Command History Tool (Enterprise)
A new tool for our Enterprise users provides a quick way to see what commands have been sent, by who, and if the commands were successful.
Command Validators
Commands validators are a new class that can be associated with individual commands. Inside the class are a pre_check and post_check method which can be used to reject commands before they are sent (pre_check), or verify if the command worked successfully (post_check).
Python Redis Cluster Support (Enterprise)
Python now supports infinite scaling with Redis Cluster in COSMOS Enterprise Edition.
New Runner Role (Enterprise)
We have a new default role called "runner" that allows a user to run scripts but not edit them. Great for production environments where users are only authorized to run prebuilt scripts.
New DataViewer Item Component
This provides an easy way to scale viewing an item (or multiple items) over time in DataViewer (rather than an entire packet).
Time Zone Setting
Our settings page now includes a time zone setting where you can choose whether you want every tool to use UTC time or the local time zone.
Potentially Breaking Changes
- Our command line generators no longer default to ruby and now require --ruby or --python for each (or set the OPENC3_LANGUAGE environment variable)
- Updated to use docker compose run instead of docker run for cli actions in openc3.sh/openc3.bat
- The docker network is no longer hard coded in compose.yaml and is now auto set by Docker Compose
- RECEIVED_COUNT now returns 0 instead of nil/None for packets that have never been received
- Many more log messages are now JSON formatted
- extra is now a required parameter for the Interface#write_interface and Protocol#write_data methods
Other Improvements
- Added a ScriptRunner Line Delay Menu Option
- More Consistent use of 401 and 403 errors
- Python Stack Traces are now cleaner in ScriptRunner
- Greatly improved File Open Performance with a large number of files
- CmdTlmApi and ScriptRunner Rails logs are now JSON formatted
- Added the ability to clear graph data in TlmGrapher
- Bucket Explorer auto refreshes every minute
Other Bug Fixes
- Fixed a python wait_check bug causing it to block forever
- Improved escaping logic in TemplateAccessor
- Lots of spelling errors fixed - our pipeline now checks for spelling errors! (Typically in comments)
- Fixed a bug with the script open_file_dialog sometimes not working
- Command Sender error messages could reference the wrong command
- Fixed TlmViewer Spacer widget
- Fixed a bug with mixing old variable sized items with new variable sized items
- Fixed an issue with CmdTlmServer LogMessages not bringing up any history
- Fixed python tcpip_server_interface
All Pull Requests in this Release
- Coverage by @JL-Brothers in #1415
- Generator requires language by @JL-Brothers in #1490
- Better escaping in TemplateAccessor by @jmthomas in #1495
- Rework settings and add time zone by @jmthomas in #1446
- Correct spelling errors by @jmthomas in #1496
- Fix fileDialogCallback promise logic by @jmthomas in #1497
- Bump webpack from 5.93.0 to 5.94.0 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-packetviewer by @dependabot in #1502
- Cmd validation by @jmthomas in #1506
- Bump pypa/gh-action-pypi-publish from 1.9.0 to 1.10.0 by @dependabot in #1508
- Bump webpack from 5.93.0 to 5.94.0 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-dataviewer by @dependabot in #1507
- Bump pypa/gh-action-pypi-publish from 1.10.0 to 1.10.1 by @dependabot in #1524
- Bump webpack from 5.93.0 to 5.94.0 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-dataextractor by @dependabot in #1520
- Fix get_limits docs by @jmthomas in #1538
- Bump webpack from 5.93.0 to 5.94.0 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-cmdtlmserver by @dependabot in #1533
- Fix Command Sender error message by @jmthomas in #1516
- Bump webpack from 5.93.0 to 5.94.0 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-cmdsender by @dependabot in #1541
- Bump the npm_and_yarn group across 13 directories with 1 update by @dependabot in #1542
- Http interface tests by @JL-Brothers in #1513
- SR line delay menu option and log line delay changes by @jmthomas in #1540
- Python Redis Cluster Updates (Enterprise) by @ryanmelt in #1523
- Add runner role to SR by @jmthomas in #1519
- Applied OPENC3_OPERATOR_HOSTNAME to json_api.rb by @stephen-ritter in #1511
- Cli script wait by @JL-Brothers in #1501
- Allow upload and delete to /tmp by @jmthomas in #1544
- Properly return 403 for Forbidden by @ryanmelt in #1555
- Fix spacer widget by @jmthomas in #1553
- Fix python stack traces by @jmthomas in #1554
- Update SR file open / save dialog by @jmthomas in #1556
- Bump pypa/gh-action-pypi-publish from 1.10.1 to 1.10.2 by @dependabot in #1565
- Command validator returns true, false, nil by @jmthomas in #1561
- Improve target file performance by @jmthomas in #1560
- Setup rails for JSON logging by @ryanmelt in #1568
- Add ability to clear graph data by @jmthomas in #1570
- Add uuid to activities by @jmthomas in #1522
- RECEIVED_COUNT returns 0 if packet not received by @jmthomas in #1569
- Fix spec return code by @jmthomas in #1518
- Change cmd keyword from validator to validate by @jmthomas in #1574
- Fix python sleep and screen formatValue by @jmthomas in #1576
- Deterministic recalculate bit offsets by @ryanmelt in #1577
- Fix LogMessages history by @jmthomas in #1587
- Fix python tcpip_server_interface by @jmthomas in #1578
- Dependencies by @jmthomas in #1582
- Rework Graph edit dialog, change timezone in Astro clock by @jmthomas in #1583
- Add auto-refresh to Bucket Explorer by @ryan-pratt in #1585
- Address security issues by @ryanmelt in #1589
- cli updates by @ryanmelt in #1588
- Dv items by @jmthomas in #1593
- Fix tlm grapher button layout by @jmthomas in #1594
- Roadmap by @jmthomas in #1599
- Bump uplot from 1.6.30 to 1.6.31 in /openc3-cosmos-init/plugins/packages/openc3-tool-common in the npm_and_yarn group across 1 directory by @dependabot in #1602
- Fix Bucket Explorer auto-refresh playwright test for enterprise by @ryan-pratt in #1601
- Command authority documentation by @jmthomas in #1600
New Contributors
- @JL-Brothers made their first contribution in #1415
- @ryan-pratt made their first contribution in #1585
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Re...
v5.18.0
OpenC3 COSMOS 5.18.0 - Multiple variable bit size items in the same packet!
Welcome to OpenC3 COSMOS 5.18.0!
Multiple Variable Bit Size Items
Since the beginning, COSMOS has been able to handle a single variable sized item within packets. Now we can handle multiple! As long as each item has its own associated length field, you can have multiple variable sized items in the same packet.
See the new VARIABLE_BIT_SIZE keyword for packet definitions.
Command Authority (Enterprise)
In COSMOS Enterprise, you can now enable a new mode called Command Authority. In this mode, only one user at a time can command a given target. This can be helpful on multi-operator ops floors to prevent two operators from accidentally sending commands at the same time.
Chromeless mode
Sometimes you would like to open COSMOS up in an IFRAME or a browser tab, and not waste any space with the topbar, navbar, or footer. Well now you can! Just add ?chromeless=true
to your urls and check it out.
New Subtitle Setting
There is a new setting in Admin -> Settings, called Subtitle, that allows you to place text under the OpenC3 logo in the Navbar. This can be really useful to differentiate between multiple installations of COSMOS.
Other Improvements
- Added a new OPENC3_OPERATOR_HOSTNAME environment variable to support pointing to a regular operator while running in Kubernetes (vs the Kubernetes Operator)
- Updated BucketExplorer to show newest files first by default
- Changed Calendar (Enterprise) to allow overlapping activities
- Added a new Signal Strength Widget for TlmViewer
- Moved some log messages to debug within the operator to quiet down microservice start/stop
- Added support for Array indexing in TlmViewer LINEGRAPH
- Added the ability to disable Calendar execution (Enterprise)
- Blank screen widgets no longer say "Value"
- Added vim and ps to UBI images
- Added new playwright.sh to run playwright tests
Other Bug Fixes
- Fixed a timing issue with the build_cmd api that was causing ack timeouts
- Fixed TEMPLATE and Accessors for Python
- Fixed connect() being called twice in Python interfaces
- Fixed screen SUBSETTING application
- Fixed Python Websocket API authentication in Enterprise
- Fixed open_file_dialog in Python scripts
- Fixed an error that occurred if you backspaced away the full name of a telemetry item in an item chooser
- Fixed Image Viewer Widget
- Updated Progress bar to always end at 100% on plugin and package uploads
All Pull Requests in this Release
- Add environment variable for dynamic operator hostname by @ryanmelt in #1378
- Bump certifi from 2023.7.22 to 2024.7.4 in /openc3/python by @dependabot in #1382
- Update topic offsets before wait for ack by @ryanmelt in #1381
- Bucket Explorer list latest first by @jmthomas in #1387
- Bump certifi from 2023.7.22 to 2024.7.4 in /openc3/python by @dependabot in #1384
- Allow overlapping activities by @jmthomas in #1383
- Signal widget by @jmthomas in #1386
- Adjust logging output by @jmthomas in #1385
- Fix python accessors and packet restore_defaults by @jmthomas in #1399
- Remove extra connect in python_microservice by @jmthomas in #1400
- Fix applying subsettings, fix LimitscolumnWidget by @jmthomas in #1401
- Allow array index on graph widget by @jmthomas in #1402
- Add chromeless query parameter support by @ryanmelt in #1403
- Fix python web socket in Enterprise by @jmthomas in #1424
- Fix python open_file_dialog by @jmthomas in #1425
- Calendar settings by @jmthomas in #1404
- Cmd authorization support by @jmthomas in #1423
- Bump dependencies by @jmthomas in #1427
- Fix scope_model and add comments by @jmthomas in #1433
- Remove placeholder from widgets by @jmthomas in #1431
- Fix chooser when deleting values by @jmthomas in #1434
- Add subtitle setting by @jmthomas in #1435
- Fix Dockerfile. Add vim and ps to UBI images by @ryanmelt in #1441
- Multi variable bit size by @ryanmelt in #1436
- Fix markdown issue in documentation issue reporting note by @bismurphy in #1451
- Bump axios from 1.7.2 to 1.7.4 in /openc3/templates/tool_vue by @dependabot in #1472
- Bump axios from 1.7.2 to 1.7.4 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-handbooks by @dependabot in #1474
- Bump axios from 1.7.2 to 1.7.4 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-cmdtlmserver by @dependabot in #1475
- Fix offset when appending items by @jmthomas in #1454
- Image viewer widget update with tlm by @jmthomas in #1469
- Progress by @jmthomas in #1445
- Bump axios from 1.7.2 to 1.7.4 in /openc3-cosmos-init/plugins/packages/openc3-cosmos-tool-dataviewer by @dependabot in #1476
- Add multiple variable bit length items to python by @jmthomas in #1473
- Ability to Run Playwright Tests Locally by @stephen-ritter in #1357
- Bump deps by @jmthomas in #1480
- Update docs with Python info by @jmthomas in #1483
New Contributors
- @bismurphy made their first contribution in #1451
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.17.1...v5.18.0
v5.17.1
OpenC3 COSMOS 5.17.1 - Rollup Widget, Dependency Update, and Bug Fixes
Welcome to OpenC3 COSMOS 5.17.1!
New ROLLUP Widget
We've added a new ROLLUP widget for TlmViewer that allows you to pick an icon, assign multiple telemetry items to it, and then it will change color based on the overall limits state of those items. Clicking on the icon can also bring up a telemetry screen of your choice.
ScriptRunner now role aware (Enterprise)
The ScriptRunner frontend is now role aware in Enterprise edition, which allows it to make the scripts readonly for users who can't edit scripts, and disable the start button for users who can't run scripts.
VALUE Widgets now support array indexing
You can now select individual array items for display on TlmViewer screens!
IMPORTANT Bug Fix in ScriptRunner
ScriptRunner could save over a file with an old version of the file's contents under certain circumstances when pressing Ctrl-S to save. This required: 1. Leaving ScriptRunner to another tool, 2. Returning to ScriptRunner, 3. Saving the file with Ctrl-S, 4. All without refreshing the webpage. This has been corrected.
Other Bug Fixes
- ScriptRunner can now properly import python modules with an init.py file.
- Several fixes with applying Global settings in screens
- Calendar events are now properly cleaned up and expired over time
- Python "break" now works in ScriptRunner
- Plugin Download button on the Admin Plugins tab now works
- Python range checking given a string no longer crashes
- Python code now handles limits event notifications
- Dockerfiles updated to same case FROM and AS statements
All Pull Requests in this Release
- update typing and cleanup in scripts by @GerhardOfRivia in #1296
- Codecov action v4 with token by @jmthomas in #1306
- Fix python version and update on release by @jmthomas in #1305
- ROLLUP notification widget by @jmthomas in #1322
- Make SR aware of roles by @jmthomas in #1308
- Import python target modules by @jmthomas in #1330
- Allow array index in VALUE widget by @jmthomas in #1332
- Bump pypa/gh-action-pypi-publish from 1.8.14 to 1.9.0 by @dependabot in #1349
- Fix applying global settings to widgets by @jmthomas in #1350
- Allow EXPIRE activities in the past by @jmthomas in #1333
- Prevent ScriptRunner Ctrl-S Save from Saving Old Buffers by @ryanmelt in #1356
- Fix python break and plugin download and calendar reserve type by @ryanmelt in #1358
- Check for string param when doing range checking by @jmthomas in #1337
- Fix limits event handling by @jmthomas in #1346
- update dependencies by @ryanmelt in #1367
- fix "FromAsCasing" buildkit check by @JoshuaNeely in #1368
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.16.2...v5.17.1
v5.16.2
OpenC3 COSMOS 5.16.2 - Python Script APIs and Usability Improvements
Welcome to OpenC3 COSMOS 5.16.2!
This release adds Python script APIs and addresses a number of tool usability issues.
Potentially breaking changes from 5.15.x
Script wait methods that wait on a condition now return true/false to indicate if the wait condition was successful or not. Previously these wait methods returned the number of seconds actually waited.
Other Improvements
- Improve Limits Monitor layout with timestamp and more field width
- Add Data Viewer collapsable header and expand Data Viewer widget width and height
- Expand Script Runner Message Log pane to take 100% of the bottom half
- Filter stack trace on installation for easier debugging of config errors
- Admin Plugins and Packages adds progress bar on upload and visually separates Processes from Plugins
- Added tooltips for Suite Runner checkboxes
- Right click a screen keyword to bring up a popup with a link to the documentation
- Added Python docs and typing by @GerhardOfRivia
Bug Fixes
- Do not clear interval on Packet Viewer error - this should prevent Packet Viewer from "freezing" and no long updating, especially when updating plugins
- Remove Notification Open button unless an actual URL destination is given
- Fix new scope deployment to properly log messages and cleanup
- Fix python log time in text logs returning 01/01/1970
- Allow commands in Data Viewer
All Pull Requests in this Release
- Bump requests from 2.31.0 to 2.32.0 in /openc3/python by @dependabot in #1284
- Do not clear interval on Packet Viewer error by @jmthomas in #1274
- Notifications: Only open if url, change clear icon by @jmthomas in #1291
- Change modified button to Confirm by @jmthomas in #1293
- Limits Monitor timestamp and more width by @jmthomas in #1294
- DataViewer collapsable header and full height by @jmthomas in #1295
- Script Runner panes by @jmthomas in #1292
- Deploy new scopes by @jmthomas in #1280
- Filter stack trace in ConfigParser by @jmthomas in #1275
- Python conversion generator returns value by @jmthomas in #1273
- Fix python log time by @jmthomas in #1266
- Separate Process List from Plugin List by @jmthomas in #1254
- Add popups for Suite Runner checkboxes by @jmthomas in #1268
- add more typing to python models code by @GerhardOfRivia in #1234
- Remove gosu from redis by @jmthomas in #1250
- Allow cmds in Data Viewer by @jmthomas in #1251
- Python script runner api by @jmthomas in #1282
- Right click screen keyword for docs by @jmthomas in #1252
- Add progress bar when uploading plugins by @jmthomas in #1267
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.16.1...v5.16.2
v5.16.1
OpenC3 COSMOS 5.16.1 - Command Sender History and Playwright Enhancements
Welcome to OpenC3 COSMOS 5.16.1!
This release adds some minor features, fixes the UBI build and improves our Playwright end to end testing.
Potentially breaking changes from 5.15.x
Script wait methods that wait on a condition now return true/false to indicate if the wait condition was successful or not. Previously these wait methods returned the number of seconds actually waited.
Command Sender History
Command Sender now remembers history on a browser refresh. The delete button will clear the history.
Other Improvements
- Limits Monitor clear all ignored items
- Code completion works with Python fstrings, e.g. cmd(f"INST
All Pull Requests in this Release
- Add Clear All to ignored limits by @jmthomas in #1242
- Command Sender remember history by @jmthomas in #1241
- Allow fstring in code completion by @jmthomas in #1237
- Playwright changes for enterprise by @jmthomas in #1244
- Playwright enhancements by @jmthomas in #1245
- Fix ubi build and add github action by @jmthomas in #1249
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.16.0...v5.16.1
v5.16.0
OpenC3 COSMOS 5.16.0 - Dependency Updates and Bug Fixes
Welcome to OpenC3 COSMOS 5.16.0!
This is primarily a bug fix and dependency update release. Interesting changes are documented below.
Potentially breaking changes from 5.15.x
Script wait methods that wait on a condition now return true/false to indicate if the wait condition was successful or not. Previously these wait methods returned the number of seconds actually waited.
IGNORE_OVERLAP for entire packet
IGNORE_OVERLAP can now be declared on an entire packet allowing items within to overlap without requiring adding the OVERLAP flag to every individual item.
Calendar now support recurring activities (Enterprise Only)
You can now have calendar activities automatically repeat at any desired interval.
Other Improvements
- In Enterprise, the user who started a script is now shown in the execution status display
- Item names are now sorted alphabetically in the chooser rather than in order of definition
- Info limits messages (displayed green) are now suppressed on initial packet received
- New openc3cli list command to list installed plugins
- Dependencies updated to reduce CVEs
Bug Fixes
- Fix jumping between two running scripts if a second is opened and started in the same ScriptRunner
- Numerous python related fixes
All Pull Requests in this Release
- Start add typing to python lib by @GerhardOfRivia in #1167
- Disconnect before connecting to running script by @jmthomas in #1191
- Better cli descriptions by @jmthomas in #1185
- Set combobox default by @jmthomas in #1190
- Better check for scientific notation by @jmthomas in #1188
- Download screen as lowercase screen name by @jmthomas in #1186
- Add username to Execution status by @jmthomas in #1189
- Bump idna from 3.4 to 3.7 in /openc3/python by @dependabot in #1196
- Sort items and filter targets without packets by @jmthomas in #1187
- Bump redis-client version by @jmthomas in #1199
- prevent 0 max params registering as no-maximum by @JoshuaNeely in #1209
- Add Suite Runner Example to curl.md by @tsjordan-eng in #1216
- Suppress initial limits INFO msgs by @jmthomas in #1205
- Add 'list' option to cli by @jmthomas in #1204
- Add connection_string to interface and use in interface_microservice by @jmthomas in #1184
- Fix several python packet config options by @jmthomas in #1201
- Remove slice! from fixed_protocol by @jmthomas in #1207
- IGNORE_OVERLAP in telemetry by @jmthomas in #1208
- COBS, SLIP, CmdResponse protocol docs by @jmthomas in #1206
- Recurring Calendar activities by @jmthomas in #1171
- Fix sending array in python by @jmthomas in #1223
- Fix Script execute selection and run from here by @jmthomas in #1220
- Wait methods return true/false except for wait() and wait(x) by @jmthomas in #1224
- Bump dependencies by @jmthomas in #1219
- Fix pypi url usage by @ryanmelt in #1226
- burst protocol c extension by @ryanmelt in #1225
- Fix accessor for Python by @jmthomas in #1229
- Add local option to cleanup local files by @jmthomas in #1121
- Force log encoding by @ryanmelt in #1232
- Fix playwright test by @jmthomas in #1233
New Contributors
- @GerhardOfRivia made their first contribution in #1167
- @JoshuaNeely made their first contribution in #1209
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.15.2...v5.16.0
v5.15.2
OpenC3 COSMOS 5.15.2 - script notifications and bug fixes
Welcome to OpenC3 COSMOS 5.15.2!
This release adds to the notifications icon the number of running scripts. It fixes bugs in the Python storage API and suite API. It also fixes a bug in the serial driver preventing clean disconnects.
Breaking Changes and Upgrade Notes since 5.14.2 - Please Read
- The internal Traefik port was changed to 2900 to match our standard external port and to better support unprivileged runtime environments
- The change requires updating .env, compose.yaml and the traefik configuration files.
- Stop the previous release, update the files, and restart
Other Improvements
- Add the number of running scripts to the Notifications icon
- Update JsonAccessor to support binary data
- Add OPENC3_BUCKET_URL to .env file (defaults to http://openc3-minio:9000)
- Script Runner automatically detects files using f-strings as Python
Bug Fixes
- Fix Python get_target_file
- Fix the ability to run Python Groups and Suites in Script Runner
- Fix serial port disconnect
All Pull Requests in this Release
- use response.content (bytes) instead of response.text (encoded text) by @ryanmelt in #1148
- Bump black from 23.3.0 to 24.3.0 in /openc3/python by @dependabot in #1151
- Add notifications for scripts by @jmthomas in #1157
- Fix screen docs by @jmthomas in #1156
- Update JsonAccessor to support additions (binary data, Nan, Infinity) by @ryanmelt in #1161
- Removed version tag from compose.yaml, compose-dev.yaml, and compose-… by @schuuust in #1160
- Fix OPENC3_BUCKET_URL in storage by @jmthomas in #1163
- Fix python suites by @jmthomas in #1164
- Fix Posix Serial Driver Not Unblocking Read on Close by @ryanmelt in #1166
Prerequisites:
Docker - Running OpenC3 requires a working Docker or Podman installation. Typically Docker Desktop on Windows / Mac. Plain Docker or Podman also works on linux. We actively develop and run with Docker Desktop on Mac/Windows, and Linux on Raspberry Pi, so if you have any issues on another platform, please let us know by submitting a ticket!
Minimum Resources allocated to Docker: 4GB RAM, 1 CPU, 80GB Disk
Recommended Resources allocated to Docker: 16GB RAM, 2+ CPUs, 100GB Disk
Also requires docker compose version 1.27+
To Run:
- git clone https://github.com/openc3/cosmos-project.git cosmos-myproject
- cd cosmos-myproject
- Run Linux/Mac: ./openc3.sh run
- Run Windows: openc3.bat run
- Connect a web browser to http://localhost:2900/
- Have fun running OpenC3 COSMOS!
Please see our documentation at https://openc3.com
Try it out and let us know what you think! Please submit any issues as Github tickets, or any generic feedback to [email protected].
Thanks!
Full Changelog: v5.15.1...v5.15.2