Skip to content

Mojavesoft-Group/coconix

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Coconix

Coconix is a Unix-like shell for Arduino Uno boards.

Compatibility

In this table, yes denotes a board on which Coconix can make use of its full feature set, partially denotes a board on which Coconix can provide limited functionality, and no denotes a board that is unlikely to work with Coconix.

Board Supported by Coconix? Notes
Arduino UNO R3 Yes N/A
Arduino UNO R4 Yes EEPROM is emulated in flash on R4 boards.*
Arduino Due Partially Coconix on the Arduino Due cannot operate piezo buzzers or save data to non-volatile storage.*
Arduino GIGA R1 Partially Coconix on the Arduino GIGA R1 cannot save data to non-volatile storage or check the amount of free memory.*
Adafruit Metro M0 Express Partially Coconix on the Adafruit Metro M0 Express cannot save data to non-volatile storage.*
Adafruit Feather 328p Yes** In order to prevent the serial I/O from being garbled, the BAUD_RATE macro must be set to 9600.
ESP32 family No Coconix on ESP32-family microcontrollers is untested and most likely broken.

*For more information on non-volatile storage support, read the FAQ at EEPROM.md.

**This board requires special configuration changes to function properly with Coconix.

Commands

  • uname
  • cd
  • ls
  • pwd
  • mkdir
  • touch
  • cat
  • echo
  • rm
  • info
  • pinmode
  • write
  • read
  • gpio
  • sh
  • uptime
  • dmesg
  • df
  • free
  • whoami
  • clear
  • reboot
  • pwm
  • sleep
  • tone
  • notone
  • sync
  • build-info

TODO

  • eeprom
  • i2c
  • pwm (done)
  • date cmd
  • alias cmd
  • 'slots' cmd

License

Coconix uses the BSD 3-clause license and contains large portions of code originating from KernelUNO.

A note about ArduinOS and KernelESP

Some may notice that the ArduinOS and KernelESP projects have many of the same commands as Coconix.

ArduinOS and KernelESP are rewrites of the KernelUNO codebase with features adopted from then-unmerged pull requests, and they are not affiliated with the Coconix project in any way. In addition, all versions of the ArduinOS project predating 72062e7 contain portions of code derived from the copyrighted work of the authors of Coconix and KernelUNO, and which have an unclear copyright status.

About

KernelUNO but with more features.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages

  • C++ 100.0%