123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274 |
- /****************************************************************************
- * graphics/nxterm/nxterm_vt100.c
- *
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements. See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership. The
- * ASF licenses this file to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance with the
- * License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
- * License for the specific language governing permissions and limitations
- * under the License.
- *
- ****************************************************************************/
- /****************************************************************************
- * Included Files
- ****************************************************************************/
- #include <nuttx/config.h>
- #include <string.h>
- #include <assert.h>
- #include <nuttx/vt100.h>
- #include "nxterm.h"
- /****************************************************************************
- * Private Types
- ****************************************************************************/
- typedef int (*seqhandler_t)(FAR struct nxterm_state_s *priv);
- struct vt100_sequence_s
- {
- FAR const char *seq;
- seqhandler_t handler;
- uint8_t size;
- };
- /****************************************************************************
- * Private Function Prototypes
- ****************************************************************************/
- static int nxterm_erasetoeol(FAR struct nxterm_state_s *priv);
- /****************************************************************************
- * Private Data
- ****************************************************************************/
- /* All recognized VT100 escape sequences. Very little as present, this is
- * a placeholder for a future, more complete VT100 emulation.
- */
- /* <esc>[K is the VT100 command erases to the end of the line. */
- static const char g_erasetoeol[] = VT100_CLEAREOL;
- /* The list of all VT100 sequences supported by the emulation */
- static const struct vt100_sequence_s g_vt100sequences[] =
- {
- {g_erasetoeol, nxterm_erasetoeol, sizeof(g_erasetoeol)},
- {NULL, NULL, 0}
- };
- /****************************************************************************
- * Private Functions
- ****************************************************************************/
- /****************************************************************************
- * Name: nxterm_erasetoeol
- *
- * Description:
- * Handle the erase-to-eol VT100 escapte sequence
- *
- * Input Parameters:
- * priv - Driver data structure
- *
- * Returned Value:
- * The index of the match in g_vt100sequences[]
- *
- ****************************************************************************/
- static int nxterm_erasetoeol(FAR struct nxterm_state_s *priv)
- {
- /* Does nothing yet (other than consume the sequence) */
- return OK;
- }
- /****************************************************************************
- * Name: nxterm_vt100part
- *
- * Description:
- * Return the next entry that is a partial match to the sequence.
- *
- * Input Parameters:
- * priv - Driver data structure
- * seqsize - The number of bytes in the sequence
- * startndx - The index to start searching
- *
- * Returned Value:
- * A pointer to the matching sequence in g_vt100sequences[]
- *
- ****************************************************************************/
- FAR const struct vt100_sequence_s *
- nxterm_vt100part(FAR struct nxterm_state_s *priv, int seqsize)
- {
- FAR const struct vt100_sequence_s *seq;
- int ndx;
- /* Search from the beginning of the sequence table */
- for (ndx = 0; g_vt100sequences[ndx].seq; ndx++)
- {
- /* Is this sequence big enough? */
- seq = &g_vt100sequences[ndx];
- if (seq->size >= seqsize)
- {
- /* Yes... are the first 'seqsize' bytes the same */
- if (memcmp(seq->seq, priv->seq, seqsize) == 0)
- {
- /* Yes.. return the match */
- return seq;
- }
- }
- }
- return NULL;
- }
- /****************************************************************************
- * Name: nxterm_vt100seq
- *
- * Description:
- * Determine if the new sequence is a part of a supported VT100 escape
- * sequence.
- *
- * Input Parameters:
- * priv - Driver data structure
- * seqsize - The number of bytes in the sequence
- *
- * Returned Value:
- * state - See enum nxterm_vt100state_e;
- *
- ****************************************************************************/
- static enum nxterm_vt100state_e nxterm_vt100seq(
- FAR struct nxterm_state_s *priv,
- int seqsize)
- {
- FAR const struct vt100_sequence_s *seq;
- enum nxterm_vt100state_e ret;
- /* Is there any VT100 escape sequence that matches what we have
- * buffered so far?
- */
- seq = nxterm_vt100part(priv, seqsize);
- if (seq)
- {
- /* Yes.. if the size of that escape sequence is the same as what we
- * have buffered, then we have an exact match.
- */
- if (seq->size == seqsize)
- {
- /* Process the VT100 sequence */
- seq->handler(priv);
- priv->nseq = 0;
- return VT100_PROCESSED;
- }
- /* The 'seqsize' is still smaller than the potential match(es). We
- * will need to collect more characters before we can make a decision.
- * Return an indication that we have consumed the character.
- */
- return VT100_CONSUMED;
- }
- /* We get here on a failure. The buffer sequence is not part of any
- * supported VT100 escape sequence. If seqsize > 1 then we need to
- * return a special value because we have to re-process the buffered
- * data.
- */
- ret = seqsize > 1 ? VT100_ABORT : VT100_NOT_CONSUMED;
- return ret;
- }
- /****************************************************************************
- * Public Functions
- ****************************************************************************/
- /****************************************************************************
- * Name: nxterm_vt100
- *
- * Description:
- * Test if the newly received byte is part of a VT100 escape sequence
- *
- * Input Parameters:
- * priv - Driver data structure
- * ch - The newly received character
- *
- * Returned Value:
- * state - See enum nxterm_vt100state_e;
- *
- ****************************************************************************/
- enum nxterm_vt100state_e nxterm_vt100(FAR struct nxterm_state_s *priv,
- char ch)
- {
- enum nxterm_vt100state_e ret;
- int seqsize;
- DEBUGASSERT(priv && priv->nseq < VT100_MAX_SEQUENCE);
- /* If we have no buffered characters, then 'ch' must be the first character
- * of an escape sequence.
- */
- if (priv->nseq < 1)
- {
- /* The first character of an escape sequence must be an an escape
- * character (duh).
- */
- if (ch != ASCII_ESC)
- {
- return VT100_NOT_CONSUMED;
- }
- /* Add the escape character to the buffer but don't bother with any
- * further checking.
- */
- priv->seq[0] = ASCII_ESC;
- priv->nseq = 1;
- return VT100_CONSUMED;
- }
- /* Temporarily add the next character to the buffer */
- seqsize = priv->nseq;
- priv->seq[seqsize] = ch;
- /* Then check if this sequence is part of an a valid escape sequence */
- seqsize++;
- ret = nxterm_vt100seq(priv, seqsize);
- if (ret == VT100_CONSUMED)
- {
- /* The newly added character is indeed part of a VT100 escape sequence
- * (which is still incomplete). Keep it in the buffer.
- */
- priv->nseq = seqsize;
- }
- return ret;
- }
|