1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2025-01-17 05:12:57 +01:00
RIOT/examples/lua_basic
Juan I Carrano ee6b6b9c38 boards/mips-malta: remove board.
The mips-malta board is a maintainance burden, has no working UART input
and is unobtainable and thus must be removed.

1. Unobtainable board
=====================

The mips-malta board is not an off-the-shelf part. A quick web
search only show the MIPS website where one is told to "contact sales".

I could find it on ebay, used, at €155 and from single seller.

Not having access to the board means:

a. We cannot maintain it. In fact it could be broken right now.
b. Potential RIOT uses have not access to the board either. In other
   words, it is pointless to run on hardware nobody has.

2. No working UART input
========================

Not all applications need UART input, but that is no excuse for not supporting
it:

a. Makes development & debugging way harder.
b. It is impossible to run interactive tests.
 b.1. Constrains the rest of the platforms by providing an incentive to not
      make tests interactive.
c. The lack of UART is a witness to the poor quality of the port.

I want to stress point (c). If something as basic as a serial port cannot work,
how can we expect more complex fucntionality to work. The answer is impossible
to know, because of point (1).

3. Maintainance burden
======================

The RIOT project has limited time and human resources which can be better spent.

a. Compiling for mips-malta wastes CPU time.
b. Blacklisting the board in the test wastes contributor's time.
c. Adapting the board's makefile during build system rework takes time and makes
   the reworks harder.
 c.1. Add to that that the changes are most of the time not even tested on the board
      because of (1). Look at the github issues/PRs and you will see it.
d. Developers usually stick to the lowest common denominator. Issue (2) sets this
   denominator unacceptably low.

MIPS platform in general
========================

In commits I will address general issues in the MIPS platform and why it should all
be removed.
2019-07-12 12:24:52 +02:00
..
main.c pkg/lua: Provide better integration with RIOT 2018-07-02 15:13:10 +02:00
main.lua pkg/lua: Provide better integration with RIOT 2018-07-02 15:13:10 +02:00
Makefile boards/mips-malta: remove board. 2019-07-12 12:24:52 +02:00
README.md pkg/lua: Provide better integration with RIOT 2018-07-02 15:13:10 +02:00

About

This example shows how to write IoT applications using Lua.

Caveats

Currently, the only actual function available is "print"

How to use

Put your lua code into "main.lua" (check the example). The file will be included in your application as an ASCII byte array. This is done in the last 20 or so lines of the example's Makefile.

The script will then be run immediately after RIOT has started up.

How to run

Type make flash term

Note: you may have to press RESET on the board (after the flash) if the board reboots faster than the terminal program can start..